@pnp/cli-microsoft365 9.0.0-beta.d6b190a → 9.0.0-beta.e69e8d0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/allCommands.json +1 -1
- package/allCommandsFull.json +1 -1
- package/dist/Auth.js +1 -1
- package/dist/config.js +1 -1
- package/dist/m365/app/commands/permission/permission-add.js +9 -9
- package/dist/m365/commands/status.js +2 -2
- package/dist/m365/connection/commands/connection-remove.js +6 -2
- package/dist/m365/connection/commands/connection-set.js +4 -1
- package/dist/m365/connection/commands/connection-use.js +25 -4
- package/dist/m365/entra/commands/enterpriseapp/enterpriseapp-add.js +13 -13
- package/dist/m365/entra/commands/enterpriseapp/enterpriseapp-get.js +18 -18
- package/dist/m365/entra/commands/enterpriseapp/enterpriseapp-list.js +1 -1
- package/dist/m365/entra/commands/group/group-user-list.js +4 -4
- package/dist/m365/entra/commands/m365group/m365group-conversation-post-list.js +4 -4
- package/dist/m365/entra/commands/m365group/m365group-recyclebinitem-list.js +3 -3
- package/dist/m365/entra/commands/m365group/m365group-user-add.js +109 -32
- package/dist/m365/entra/commands/m365group/m365group-user-list.js +6 -9
- package/dist/m365/entra/commands/m365group/m365group-user-set.js +159 -84
- package/dist/m365/entra/commands/multitenant/multitenant-add.js +65 -0
- package/dist/m365/entra/commands/multitenant/multitenant-remove.js +118 -0
- package/dist/m365/entra/commands/multitenant/multitenant-set.js +72 -0
- package/dist/m365/entra/commands.js +3 -0
- package/dist/m365/flow/commands/flow-get.js +1 -1
- package/dist/m365/outlook/commands/message/message-get.js +11 -11
- package/dist/m365/pa/commands/app/app-export.js +13 -7
- package/dist/m365/spfx/commands/project/DeployWorkflow.js +1 -1
- package/dist/m365/spfx/commands/project/project-github-workflow-add.js +1 -10
- package/dist/m365/spo/commands/file/file-copy.js +55 -34
- package/dist/m365/spo/commands/file/file-roleassignment-add.js +1 -1
- package/dist/m365/spo/commands/file/file-roleinheritance-break.js +1 -1
- package/dist/m365/spo/commands/file/file-roleinheritance-reset.js +1 -1
- package/dist/m365/spo/commands/folder/folder-retentionlabel-ensure.js +1 -1
- package/dist/m365/spo/commands/folder/folder-set.js +0 -4
- package/dist/m365/spo/commands/folder/folder-sharinglink-get.js +86 -0
- package/dist/m365/spo/commands/folder/folder-sharinglink-list.js +110 -0
- package/dist/m365/spo/commands/list/ListInstance.js +6 -1
- package/dist/m365/spo/commands/list/list-get.js +9 -3
- package/dist/m365/spo/commands/list/list-list.js +1 -4
- package/dist/m365/spo/commands/list/list-roleassignment-add.js +46 -21
- package/dist/m365/spo/commands/list/list-roleassignment-remove.js +48 -46
- package/dist/m365/spo/commands/site/site-appcatalog-remove.js +48 -24
- package/dist/m365/spo/commands/site/site-remove.js +1 -7
- package/dist/m365/spo/commands/tenant/tenant-recyclebinitem-restore.js +2 -22
- package/dist/m365/spo/commands.js +2 -1
- package/dist/utils/drive.js +61 -0
- package/dist/utils/spo.js +143 -6
- package/docs/docs/cmd/app/permission/permission-add.mdx +5 -5
- package/docs/docs/cmd/connection/connection-use.mdx +8 -2
- package/docs/docs/cmd/entra/enterpriseapp/enterpriseapp-add.mdx +12 -12
- package/docs/docs/cmd/entra/enterpriseapp/enterpriseapp-get.mdx +14 -14
- package/docs/docs/cmd/entra/enterpriseapp/enterpriseapp-list.mdx +5 -5
- package/docs/docs/cmd/entra/group/group-user-list.mdx +7 -7
- package/docs/docs/cmd/entra/m365group/m365group-conversation-post-list.mdx +5 -5
- package/docs/docs/cmd/entra/m365group/m365group-recyclebinitem-list.mdx +3 -3
- package/docs/docs/cmd/entra/m365group/m365group-user-add.mdx +28 -10
- package/docs/docs/cmd/entra/m365group/m365group-user-list.mdx +1 -1
- package/docs/docs/cmd/entra/m365group/m365group-user-set.mdx +35 -11
- package/docs/docs/cmd/entra/multitenant/multitenant-add.mdx +107 -0
- package/docs/docs/cmd/entra/multitenant/multitenant-remove.mdx +58 -0
- package/docs/docs/cmd/entra/multitenant/multitenant-set.mdx +53 -0
- package/docs/docs/cmd/flow/flow-get.mdx +149 -283
- package/docs/docs/cmd/outlook/message/message-get.mdx +5 -5
- package/docs/docs/cmd/pa/app/app-export.mdx +15 -9
- package/docs/docs/cmd/planner/plan/plan-remove.mdx +1 -1
- package/docs/docs/cmd/spe/containertype/containertype-list.mdx +24 -53
- package/docs/docs/cmd/spfx/project/project-github-workflow-add.mdx +11 -12
- package/docs/docs/cmd/spo/app/app-uninstall.mdx +1 -1
- package/docs/docs/cmd/spo/applicationcustomizer/applicationcustomizer-get.mdx +4 -4
- package/docs/docs/cmd/spo/applicationcustomizer/applicationcustomizer-list.mdx +4 -4
- package/docs/docs/cmd/spo/file/file-copy.mdx +119 -12
- package/docs/docs/cmd/spo/file/file-retentionlabel-ensure.mdx +1 -1
- package/docs/docs/cmd/spo/file/file-roleassignment-add.mdx +2 -2
- package/docs/docs/cmd/spo/file/file-roleassignment-remove.mdx +1 -1
- package/docs/docs/cmd/spo/file/file-roleinheritance-break.mdx +1 -1
- package/docs/docs/cmd/spo/file/file-roleinheritance-reset.mdx +1 -1
- package/docs/docs/cmd/spo/folder/folder-retentionlabel-ensure.mdx +2 -2
- package/docs/docs/cmd/spo/folder/folder-set.mdx +0 -6
- package/docs/docs/cmd/spo/folder/folder-sharinglink-get.mdx +110 -0
- package/docs/docs/cmd/spo/folder/folder-sharinglink-list.mdx +114 -0
- package/docs/docs/cmd/spo/list/list-get.mdx +6 -0
- package/docs/docs/cmd/spo/list/list-list.mdx +5 -7
- package/docs/docs/cmd/spo/list/list-roleassignment-add.mdx +15 -3
- package/docs/docs/cmd/spo/list/list-roleassignment-remove.mdx +15 -3
- package/docs/docs/cmd/spo/listitem/listitem-retentionlabel-ensure.mdx +4 -4
- package/docs/docs/cmd/spo/listitem/listitem-retentionlabel-remove.mdx +1 -1
- package/docs/docs/cmd/spo/listitem/listitem-roleassignment-add.mdx +9 -9
- package/docs/docs/cmd/spo/listitem/listitem-roleassignment-remove.mdx +7 -7
- package/docs/docs/cmd/spo/site/site-appcatalog-remove.mdx +11 -2
- package/docs/docs/cmd/spo/site/site-recyclebinitem-list.mdx +1 -1
- package/docs/docs/cmd/spo/site/site-remove.mdx +0 -3
- package/docs/docs/cmd/spo/tenant/tenant-recyclebinitem-restore.mdx +2 -49
- package/docs/docs/cmd/spo/web/web-roleassignment-add.mdx +1 -1
- package/docs/docs/cmd/spo/web/web-roleassignment-remove.mdx +1 -1
- package/npm-shrinkwrap.json +572 -477
- package/package.json +22 -22
|
@@ -2,14 +2,14 @@ import Global from '/docs/cmd/_global.mdx';
|
|
|
2
2
|
import Tabs from '@theme/Tabs';
|
|
3
3
|
import TabItem from '@theme/TabItem';
|
|
4
4
|
|
|
5
|
-
#
|
|
5
|
+
# spe containertype list
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
Lists all Container Types
|
|
8
8
|
|
|
9
9
|
## Usage
|
|
10
10
|
|
|
11
11
|
```sh
|
|
12
|
-
m365 containertype list [options]
|
|
12
|
+
m365 spe containertype list [options]
|
|
13
13
|
```
|
|
14
14
|
|
|
15
15
|
## Options
|
|
@@ -21,7 +21,7 @@ m365 containertype list [options]
|
|
|
21
21
|
Retrieves a list of Container Types created for a SharePoint Embedded Application from the tenant.
|
|
22
22
|
|
|
23
23
|
```sh
|
|
24
|
-
m365 containertype list
|
|
24
|
+
m365 spe containertype list
|
|
25
25
|
```
|
|
26
26
|
|
|
27
27
|
## Response
|
|
@@ -30,47 +30,32 @@ m365 containertype list
|
|
|
30
30
|
<TabItem value="JSON">
|
|
31
31
|
|
|
32
32
|
```json
|
|
33
|
-
[
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
"ApplicationRedirectUrl": null,
|
|
51
|
-
"AzureSubscriptionId": "/Guid(00000000-0000-0000-0000-000000000000)/",
|
|
52
|
-
"ContainerTypeId": "/Guid(3ec7c59d-ef31-0752-1ab5-5c343a5e8557)/",
|
|
53
|
-
"CreationDate": null,
|
|
54
|
-
"DisplayName": "SharePoint Embedded Free Trial Container Type",
|
|
55
|
-
"ExpiryDate": null,
|
|
56
|
-
"IsBillingProfileRequired": true,
|
|
57
|
-
"OwningAppId": "/Guid(e6b529fe-84db-412a-8e9c-5bbb75f7b037)/",
|
|
58
|
-
"OwningTenantId": "/Guid(00000000-0000-0000-0000-000000000000)/",
|
|
59
|
-
"Region": null,
|
|
60
|
-
"ResourceGroup": null,
|
|
61
|
-
"SPContainerTypeBillingClassification": 1
|
|
62
|
-
}]
|
|
33
|
+
[
|
|
34
|
+
{
|
|
35
|
+
"_ObjectType_": "Microsoft.Online.SharePoint.TenantAdministration.SPContainerTypeProperties",
|
|
36
|
+
"ApplicationRedirectUrl": null,
|
|
37
|
+
"AzureSubscriptionId": "/Guid(00000000-0000-0000-0000-000000000000)/",
|
|
38
|
+
"ContainerTypeId": "/Guid(073269af-f1d2-042d-2ef5-5bdd6ac83115)/",
|
|
39
|
+
"CreationDate": null,
|
|
40
|
+
"DisplayName": "test1",
|
|
41
|
+
"ExpiryDate": null,
|
|
42
|
+
"IsBillingProfileRequired": true,
|
|
43
|
+
"OwningAppId": "/Guid(df4085cc-9a38-4255-badc-5c5225610475)/",
|
|
44
|
+
"OwningTenantId": "/Guid(00000000-0000-0000-0000-000000000000)/",
|
|
45
|
+
"Region": null,
|
|
46
|
+
"ResourceGroup": null,
|
|
47
|
+
"SPContainerTypeBillingClassification": 0
|
|
48
|
+
}
|
|
49
|
+
]
|
|
63
50
|
```
|
|
64
51
|
|
|
65
52
|
</TabItem>
|
|
66
53
|
<TabItem value="Text">
|
|
67
54
|
|
|
68
55
|
```text
|
|
69
|
-
ContainerTypeId DisplayName OwningAppId
|
|
70
|
-
-------------------------------------------- --------------------------------------------- --------------------------------------------
|
|
71
|
-
/Guid(073269af-f1d2-042d-2ef5-5bdd6ac83115)/ test1 /Guid(df4085cc-9a38-4255-badc-5c5225610475)/
|
|
72
|
-
/Guid(880ab3bd-5b68-01d4-3744-01a7656cf2ba)/ test1 /Guid(50785fde-3082-47ac-a36d-06282ac5c7da)/
|
|
73
|
-
/Guid(3ec7c59d-ef31-0752-1ab5-5c343a5e8557)/ SharePoint Embedded Free Trial Container Type /Guid(e6b529fe-84db-412a-8e9c-5bbb75f7b037)/
|
|
56
|
+
ContainerTypeId DisplayName OwningAppId
|
|
57
|
+
-------------------------------------------- --------------------------------------------- --------------------------------------------
|
|
58
|
+
/Guid(073269af-f1d2-042d-2ef5-5bdd6ac83115)/ test1 /Guid(df4085cc-9a38-4255-badc-5c5225610475)/
|
|
74
59
|
```
|
|
75
60
|
|
|
76
61
|
</TabItem>
|
|
@@ -79,7 +64,6 @@ ContainerTypeId DisplayName
|
|
|
79
64
|
```csv
|
|
80
65
|
_ObjectType_,ApplicationRedirectUrl,AzureSubscriptionId,ContainerTypeId,CreationDate,DisplayName,ExpiryDate,IsBillingProfileRequired,OwningAppId,OwningTenantId,Region,ResourceGroup,SPContainerTypeBillingClassification
|
|
81
66
|
Microsoft.Online.SharePoint.TenantAdministration.SPContainerTypeProperties,,/Guid(00000000-0000-0000-0000-000000000000)/,/Guid(073269af-f1d2-042d-2ef5-5bdd6ac83115)/,,test1,,1,/Guid(df4085cc-9a38-4255-badc-5c5225610475)/,/Guid(00000000-0000-0000-0000-000000000000)/,,,0
|
|
82
|
-
Microsoft.Online.SharePoint.TenantAdministration.SPContainerTypeProperties,,/Guid(00000000-0000-0000-0000-000000000000)/,/Guid(3ec7c59d-ef31-0752-1ab5-5c343a5e8557)/,,SharePoint Embedded Free Trial Container Type,,1,/Guid(e6b529fe-84db-412a-8e9c-5bbb75f7b037)/,/Guid(00000000-0000-0000-0000-000000000000)/,,,1
|
|
83
67
|
```
|
|
84
68
|
|
|
85
69
|
</TabItem>
|
|
@@ -102,19 +86,6 @@ ContainerTypeId DisplayName
|
|
|
102
86
|
OwningAppId | /Guid(df4085cc-9a38-4255-badc-5c5225610475)/
|
|
103
87
|
OwningTenantId | /Guid(00000000-0000-0000-0000-000000000000)/
|
|
104
88
|
SPContainerTypeBillingClassification | 0
|
|
105
|
-
|
|
106
|
-
## SharePoint Embedded Free Trial Container Type
|
|
107
|
-
|
|
108
|
-
Property | Value
|
|
109
|
-
---------|-------
|
|
110
|
-
\_ObjectType\_ | Microsoft.Online.SharePoint.TenantAdministration.SPContainerTypeProperties
|
|
111
|
-
AzureSubscriptionId | /Guid(00000000-0000-0000-0000-000000000000)/
|
|
112
|
-
ContainerTypeId | /Guid(3ec7c59d-ef31-0752-1ab5-5c343a5e8557)/
|
|
113
|
-
DisplayName | SharePoint Embedded Free Trial Container Type
|
|
114
|
-
IsBillingProfileRequired | true
|
|
115
|
-
OwningAppId | /Guid(e6b529fe-84db-412a-8e9c-5bbb75f7b037)/
|
|
116
|
-
OwningTenantId | /Guid(00000000-0000-0000-0000-000000000000)/
|
|
117
|
-
SPContainerTypeBillingClassification | 1
|
|
118
89
|
```
|
|
119
90
|
|
|
120
91
|
</TabItem>
|
|
@@ -14,28 +14,25 @@ m365 spfx project github workflow add [options]
|
|
|
14
14
|
|
|
15
15
|
```md definition-list
|
|
16
16
|
`-n, --name [name]`
|
|
17
|
-
: Name of the workflow that will be created. If none is specified a default name will be used 'Deploy Solution ${name of sppkg file}'
|
|
17
|
+
: Name of the workflow that will be created. If none is specified a default name will be used 'Deploy Solution ${name of sppkg file}'.
|
|
18
18
|
|
|
19
19
|
`-b, --branchName [branchName]`
|
|
20
|
-
: Specify the branch name which should trigger the workflow on push. If none is specified a default will be used which is 'main'
|
|
20
|
+
: Specify the branch name which should trigger the workflow on push. If none is specified a default will be used which is 'main'.
|
|
21
21
|
|
|
22
22
|
`-m, --manuallyTrigger`
|
|
23
|
-
: When specified a manual trigger option will be added to the workflow: `workflow_dispatch
|
|
23
|
+
: When specified a manual trigger option will be added to the workflow: `workflow_dispatch`.
|
|
24
24
|
|
|
25
25
|
`-l, --loginMethod [loginMethod]`
|
|
26
|
-
: Specify the login method used for the login action. Possible options are: `user`, `application`. Default `application
|
|
26
|
+
: Specify the login method used for the login action. Possible options are: `user`, `application`. Default `application`.
|
|
27
27
|
|
|
28
28
|
`-s, --scope [scope]`
|
|
29
|
-
: Scope of the app catalog: `tenant`, `sitecollection`. Default is `tenant
|
|
29
|
+
: Scope of the app catalog: `tenant`, `sitecollection`. Default is `tenant`.
|
|
30
30
|
|
|
31
31
|
`-u, --siteUrl [siteUrl]`
|
|
32
|
-
: The URL of the site collection where the solution package will be added. Required if scope is set to `sitecollection
|
|
32
|
+
: The URL of the site collection where the solution package will be added. Required if scope is set to `sitecollection`.
|
|
33
33
|
|
|
34
34
|
`--skipFeatureDeployment`
|
|
35
|
-
: When specified and the app supports tenant-wide deployment, deploy it to the whole tenant
|
|
36
|
-
|
|
37
|
-
`--overwrite`
|
|
38
|
-
: When specified the workflow will overwrite the existing .sppkg if it is already deployed in the app catalog.
|
|
35
|
+
: When specified and the app supports tenant-wide deployment, deploy it to the whole tenant.
|
|
39
36
|
```
|
|
40
37
|
|
|
41
38
|
<Global />
|
|
@@ -59,6 +56,8 @@ For the `user` login method you will need to create the following secrets in Git
|
|
|
59
56
|
|
|
60
57
|
This method is perfect to test your workflow, in a dev context, for personal usage. It will not work for accounts with MFA.
|
|
61
58
|
|
|
59
|
+
The workflow will overwrite the existing .sppkg if it is already deployed in the app catalog. Overwriting your sppkg file on every deployment is required to make continuous delivery of the latest version of your app which is the aim of the continuous delivery pipeline.
|
|
60
|
+
|
|
62
61
|
:::info
|
|
63
62
|
|
|
64
63
|
Run this command in the SPFx solution folder.
|
|
@@ -67,7 +66,7 @@ Run this command in the SPFx solution folder.
|
|
|
67
66
|
|
|
68
67
|
## Examples
|
|
69
68
|
|
|
70
|
-
Adds a GitHub workflow for a SharePoint Framework project with `application` login method triggered on push to main
|
|
69
|
+
Adds a GitHub workflow for a SharePoint Framework project with `application` login method triggered on push to main.
|
|
71
70
|
|
|
72
71
|
```sh
|
|
73
72
|
m365 spfx project github workflow add
|
|
@@ -79,7 +78,7 @@ Adds a GitHub workflow for a SharePoint Framework project with `user` login meth
|
|
|
79
78
|
m365 spfx project github workflow add --manuallyTrigger --loginMethod "user"
|
|
80
79
|
```
|
|
81
80
|
|
|
82
|
-
Adds a GitHub workflow for a SharePoint Framework project with deployment to a site collection app catalog
|
|
81
|
+
Adds a GitHub workflow for a SharePoint Framework project with deployment to a site collection app catalog.
|
|
83
82
|
|
|
84
83
|
```sh
|
|
85
84
|
m365 spfx project github workflow add --scope "sitecollection" --siteUrl "https://some.sharepoint.com/sites/someSite"
|
|
@@ -43,7 +43,7 @@ m365 spo app uninstall --id b2307a39-e878-458b-bc90-03bc578531d6 --siteUrl https
|
|
|
43
43
|
Uninstall the app with the specified ID from the specified site without prompting for confirmation.
|
|
44
44
|
|
|
45
45
|
```sh
|
|
46
|
-
m365 spo app uninstall --id b2307a39-e878-458b-bc90-03bc578531d6 --siteUrl https://contoso.sharepoint.com
|
|
46
|
+
m365 spo app uninstall --id b2307a39-e878-458b-bc90-03bc578531d6 --siteUrl https://contoso.sharepoint.com --force
|
|
47
47
|
```
|
|
48
48
|
|
|
49
49
|
Uninstall the app with the specified ID from the specified site where the app is deployed to the site collection app catalog.
|
|
@@ -36,6 +36,10 @@ m365 spo applicationcustomizer get [options]
|
|
|
36
36
|
|
|
37
37
|
<Global />
|
|
38
38
|
|
|
39
|
+
## Remarks
|
|
40
|
+
|
|
41
|
+
This command can be used for retrieving an application customizer from a specific site. To retrieve an application customizer that's installed tenant-wide, view our dedicated [spo tenant applicationcustomizer get](../tenant/tenant-applicationcustomizer-get.mdx) command.
|
|
42
|
+
|
|
39
43
|
## Examples
|
|
40
44
|
|
|
41
45
|
Retrieves an application customizer by title.
|
|
@@ -68,10 +72,6 @@ Retrieves the client-side component properties of a application customizer.
|
|
|
68
72
|
m365 spo applicationcustomizer get --id 14125658-a9bc-4ddf-9c75-1b5767c9a337 --webUrl https://contoso.sharepoint.com/sites/sales --clientSideComponentProperties
|
|
69
73
|
```
|
|
70
74
|
|
|
71
|
-
## Remarks
|
|
72
|
-
|
|
73
|
-
This command can be used for retrieving an application customizer from a specific site. To retrieve an application customizer that's installed tenant-wide, view our dedicated [spo tenant applicationcustomizer get](../tenant/tenant-applicationcustomizer-get.mdx) command.
|
|
74
|
-
|
|
75
75
|
## Response
|
|
76
76
|
|
|
77
77
|
### Standard response
|
|
@@ -24,6 +24,10 @@ m365 spo applicationcustomizer list [options]
|
|
|
24
24
|
|
|
25
25
|
<Global />
|
|
26
26
|
|
|
27
|
+
## Remarks
|
|
28
|
+
|
|
29
|
+
This command can be used for retrieving a list of application customizers from a specific site. To retrieve a list of application customizers that are installed tenant-wide, view our dedicated [spo tenant applicationcustomizer list](../tenant/tenant-applicationcustomizer-list.mdx) command.
|
|
30
|
+
|
|
27
31
|
## Examples
|
|
28
32
|
|
|
29
33
|
Retrieves a list of application customizers.
|
|
@@ -32,10 +36,6 @@ Retrieves a list of application customizers.
|
|
|
32
36
|
m365 spo applicationcustomizer list --webUrl https://contoso.sharepoint.com/sites/sales
|
|
33
37
|
```
|
|
34
38
|
|
|
35
|
-
## Remarks
|
|
36
|
-
|
|
37
|
-
This command can be used for retrieving a list of application customizers from a specific site. To retrieve a list of application customizers that are installed tenant-wide, view our dedicated [spo tenant applicationcustomizer list](../tenant/tenant-applicationcustomizer-list.mdx) command.
|
|
38
|
-
|
|
39
39
|
## Response
|
|
40
40
|
|
|
41
41
|
<Tabs>
|
|
@@ -1,4 +1,6 @@
|
|
|
1
1
|
import Global from '/docs/cmd/_global.mdx';
|
|
2
|
+
import Tabs from '@theme/Tabs';
|
|
3
|
+
import TabItem from '@theme/TabItem';
|
|
2
4
|
|
|
3
5
|
# spo file copy
|
|
4
6
|
|
|
@@ -31,11 +33,14 @@ m365 spo file copy [options]
|
|
|
31
33
|
`--nameConflictBehavior [nameConflictBehavior]`
|
|
32
34
|
: Behavior when a document with the same name is already present at the destination. Allowed values: `fail`, `replace`, `rename`. Defaults to `fail`.
|
|
33
35
|
|
|
34
|
-
`--resetAuthorAndCreated`
|
|
35
|
-
: Use this option to clear the author and created date. When not specified, the values from the source file are used.
|
|
36
|
-
|
|
37
36
|
`--bypassSharedLock`
|
|
38
37
|
: This indicates whether a file with a share lock can still be copied. Use this option to copy a file that is locked.
|
|
38
|
+
|
|
39
|
+
`--ignoreVersionHistory`
|
|
40
|
+
: Only copy the most recent version of the file and ignore the version history.
|
|
41
|
+
|
|
42
|
+
`--skipWait`
|
|
43
|
+
: Don't wait for the copy operation to complete.
|
|
39
44
|
```
|
|
40
45
|
|
|
41
46
|
<Global />
|
|
@@ -43,7 +48,6 @@ m365 spo file copy [options]
|
|
|
43
48
|
## Remarks
|
|
44
49
|
|
|
45
50
|
When you specify a value for `nameConflictBehavior`, consider the following:
|
|
46
|
-
|
|
47
51
|
- `fail` will throw an error when the destination file already exists.
|
|
48
52
|
- `replace` will replace the destination file if it already exists.
|
|
49
53
|
- `rename` will add a suffix (e.g. Document1.pdf) when the destination file already exists.
|
|
@@ -56,16 +60,16 @@ Copy a file by server-relative URL to a document library in another site collect
|
|
|
56
60
|
m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceUrl "/sites/project/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents"
|
|
57
61
|
```
|
|
58
62
|
|
|
59
|
-
Copy a file by site-relative URL to a document library in another site collection and
|
|
63
|
+
Copy a file by site-relative URL to a document library in another site collection and ignore the file history.
|
|
60
64
|
|
|
61
65
|
```sh
|
|
62
|
-
m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceUrl "/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents" --
|
|
66
|
+
m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceUrl "/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents" --ignoreVersionHistory
|
|
63
67
|
```
|
|
64
68
|
|
|
65
|
-
Copy file by sourceId (UniqueId) to a document library in another site collection and rename the file.
|
|
69
|
+
Copy file by sourceId (UniqueId) to a document library in another site collection and rename the file (without specifying the file extension).
|
|
66
70
|
|
|
67
71
|
```sh
|
|
68
|
-
m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceId "b2307a39-e878-458b-bc90-03bc578531d6" --targetUrl "/sites/IT/Shared Documents" --newName "Report
|
|
72
|
+
m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceId "b2307a39-e878-458b-bc90-03bc578531d6" --targetUrl "/sites/IT/Shared Documents" --newName "Report"
|
|
69
73
|
```
|
|
70
74
|
|
|
71
75
|
Copy file by sourceId (UniqueId) to a document library in another site collection with a new name, rename the file if it already exists.
|
|
@@ -76,8 +80,111 @@ m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourc
|
|
|
76
80
|
|
|
77
81
|
## Response
|
|
78
82
|
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
83
|
+
### Standard Response
|
|
84
|
+
|
|
85
|
+
<Tabs>
|
|
86
|
+
<TabItem value="JSON">
|
|
87
|
+
|
|
88
|
+
```json
|
|
89
|
+
{
|
|
90
|
+
"CheckInComment": "",
|
|
91
|
+
"CheckOutType": 2,
|
|
92
|
+
"ContentTag": "{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1,1",
|
|
93
|
+
"CustomizedPageStatus": 0,
|
|
94
|
+
"ETag": "\"{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1\"",
|
|
95
|
+
"Exists": true,
|
|
96
|
+
"IrmEnabled": false,
|
|
97
|
+
"Length": "5987",
|
|
98
|
+
"Level": 1,
|
|
99
|
+
"LinkingUri": null,
|
|
100
|
+
"LinkingUrl": "",
|
|
101
|
+
"MajorVersion": 1,
|
|
102
|
+
"MinorVersion": 0,
|
|
103
|
+
"Name": "Test1.docx",
|
|
104
|
+
"ServerRelativeUrl": "/sites/project-x/documents/Test1.docx",
|
|
105
|
+
"TimeCreated": "2022-10-30T10:16:18Z",
|
|
106
|
+
"TimeLastModified": "2022-10-30T10:16:18Z",
|
|
107
|
+
"Title": null,
|
|
108
|
+
"UIVersion": 512,
|
|
109
|
+
"UIVersionLabel": "1.0",
|
|
110
|
+
"UniqueId": "b2307a39-e878-458b-bc90-03bc578531d6"
|
|
111
|
+
}
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
</TabItem>
|
|
115
|
+
<TabItem value="Text">
|
|
116
|
+
|
|
117
|
+
```text
|
|
118
|
+
CheckInComment :
|
|
119
|
+
CheckOutType : 2
|
|
120
|
+
ContentTag : {03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1,1
|
|
121
|
+
CustomizedPageStatus: 0
|
|
122
|
+
ETag : "{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1"
|
|
123
|
+
Exists : true
|
|
124
|
+
IrmEnabled : false
|
|
125
|
+
Length : 5987
|
|
126
|
+
Level : 1
|
|
127
|
+
LinkingUri : null
|
|
128
|
+
LinkingUrl :
|
|
129
|
+
MajorVersion : 1
|
|
130
|
+
MinorVersion : 0
|
|
131
|
+
Name : Test1.docx
|
|
132
|
+
ServerRelativeUrl : /sites/project-x/documents/Test1.docx
|
|
133
|
+
TimeCreated : 2022-10-30T10:16:18Z
|
|
134
|
+
TimeLastModified : 2022-10-30T10:16:18Z
|
|
135
|
+
Title : null
|
|
136
|
+
UIVersion : 512
|
|
137
|
+
UIVersionLabel : 1.0
|
|
138
|
+
UniqueId : b2307a39-e878-458b-bc90-03bc578531d6
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
</TabItem>
|
|
142
|
+
<TabItem value="CSV">
|
|
143
|
+
|
|
144
|
+
```csv
|
|
145
|
+
CheckInComment,CheckOutType,ContentTag,CustomizedPageStatus,ETag,Exists,IrmEnabled,Length,Level,LinkingUri,LinkingUrl,MajorVersion,MinorVersion,Name,ServerRelativeUrl,TimeCreated,TimeLastModified,Title,UIVersion,UIVersionLabel,UniqueId
|
|
146
|
+
,2,"{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1,1",0,"""{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1""",1,,5987,1,,,1,0,Test1.docx,/sites/project-x/documents/Test1.docx,2022-10-30T10:16:18Z,2022-10-30T10:16:18Z,,512,1.0,b2307a39-e878-458b-bc90-03bc578531d6
|
|
147
|
+
```
|
|
148
|
+
|
|
149
|
+
</TabItem>
|
|
150
|
+
<TabItem value="Markdown">
|
|
151
|
+
|
|
152
|
+
```md
|
|
153
|
+
# spo file copy --webUrl "https://contoso.sharepoint.com/sites/IT" --sourceUrl "/Shared Documents/Document.docx" --targetUrl "/sites/project-x/Shared Documents"
|
|
154
|
+
|
|
155
|
+
Date: 10/3/2023
|
|
156
|
+
|
|
157
|
+
## b2307a39-e878-458b-bc90-03bc578531d6
|
|
158
|
+
|
|
159
|
+
Property | Value
|
|
160
|
+
---------|-------
|
|
161
|
+
CheckInComment |
|
|
162
|
+
CheckOutType | 2
|
|
163
|
+
ContentTag | {03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1,1
|
|
164
|
+
CustomizedPageStatus | 0
|
|
165
|
+
ETag | "{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1"
|
|
166
|
+
Exists | true
|
|
167
|
+
ExistsAllowThrowForPolicyFailures | true
|
|
168
|
+
IrmEnabled | false
|
|
169
|
+
Length | 5987
|
|
170
|
+
Level | 1
|
|
171
|
+
LinkingUri | https://contoso.sharepoint.com/sites/project-x/shared%20documents/Document.docx?d=w59d4e6fcf6f94ce78bea0273cedb1a19
|
|
172
|
+
LinkingUrl | https://contoso.sharepoint.com/sites/project-x/shared documents/Document.docx?d=w59d4e6fcf6f94ce78bea0273cedb1a19
|
|
173
|
+
MajorVersion | 1
|
|
174
|
+
MinorVersion | 0
|
|
175
|
+
Name | Document.docx
|
|
176
|
+
ServerRelativeUrl | /sites/project-x/shared documents/Document.docx
|
|
177
|
+
TimeCreated | 2023-05-23T09:51:34Z
|
|
178
|
+
TimeLastModified | 2023-05-23T10:13:01Z
|
|
179
|
+
Title |
|
|
180
|
+
UIVersion | 1536
|
|
181
|
+
UIVersionLabel | 1.0
|
|
182
|
+
UniqueId | b2307a39-e878-458b-bc90-03bc578531d6
|
|
183
|
+
```
|
|
184
|
+
|
|
185
|
+
</TabItem>
|
|
186
|
+
</Tabs>
|
|
187
|
+
|
|
188
|
+
### `skipWait` response
|
|
82
189
|
|
|
83
|
-
|
|
190
|
+
The command won't return a response on success.
|
|
@@ -33,7 +33,7 @@ m365 spo file retentionlabel ensure [options]
|
|
|
33
33
|
|
|
34
34
|
## Remarks
|
|
35
35
|
|
|
36
|
-
You can also use [spo listitem retentionlabel remove](./../../../cmd/spo/listitem/listitem-retentionlabel-remove.mdx) for removing the retention label from a
|
|
36
|
+
You can also use [spo listitem retentionlabel remove](./../../../cmd/spo/listitem/listitem-retentionlabel-remove.mdx) for removing the retention label from a list item.
|
|
37
37
|
|
|
38
38
|
The `--assetId` option has to do with event-based retention. Event-based retention is about starting a retention period when a specific event occurs, instead of the moment a document was labeled or created.
|
|
39
39
|
|
|
@@ -19,7 +19,7 @@ m365 spo file roleassignment add [options]
|
|
|
19
19
|
`--fileUrl [fileUrl]`
|
|
20
20
|
: The server- or site-relative decoded URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both.
|
|
21
21
|
|
|
22
|
-
|
|
22
|
+
`-i, --fileId [fileId]`
|
|
23
23
|
: The UniqueId (GUID) of the file to retrieve. Specify either `fileUrl` or `fileId` but not both.
|
|
24
24
|
|
|
25
25
|
`--principalId [principalId]`
|
|
@@ -29,7 +29,7 @@ m365 spo file roleassignment add [options]
|
|
|
29
29
|
: The upn/email of user to assign role to. Specify either `upn`, `groupName`, or `principalId` but not multiple.
|
|
30
30
|
|
|
31
31
|
`--groupName [groupName]`
|
|
32
|
-
: The group name of
|
|
32
|
+
: The group name of the SharePoint group Specify either `upn`, `groupName`, or `principalId` but not multiple.
|
|
33
33
|
|
|
34
34
|
`--roleDefinitionId [roleDefinitionId]`
|
|
35
35
|
: ID of role definition. Specify either `roleDefinitionId` or `roleDefinitionName` but not both.
|
|
@@ -29,7 +29,7 @@ m365 spo file roleassignment remove [options]
|
|
|
29
29
|
: The upn/email of the user. Specify either `upn`, `groupName`, or `principalId` but not multiple.
|
|
30
30
|
|
|
31
31
|
`--groupName [groupName]`
|
|
32
|
-
: The group name of
|
|
32
|
+
: The group name of the SharePoint group Specify either `upn`, `groupName`, or `principalId` but not multiple.
|
|
33
33
|
|
|
34
34
|
`-f, --force`
|
|
35
35
|
: Don't prompt for confirmation.
|
|
@@ -19,7 +19,7 @@ m365 spo file roleinheritance break [options]
|
|
|
19
19
|
`--fileUrl [fileUrl]`
|
|
20
20
|
: The server- or site-relative decoded URL of the file. Specify either `fileUrl` or `fileId` but not both.
|
|
21
21
|
|
|
22
|
-
|
|
22
|
+
`-i, --fileId [fileId]`
|
|
23
23
|
: The UniqueId (GUID) of the file. Specify either `fileUrl` or `fileId` but not both.
|
|
24
24
|
|
|
25
25
|
`-c, --clearExistingPermissions`
|
|
@@ -19,7 +19,7 @@ m365 spo file roleinheritance reset [options]
|
|
|
19
19
|
`--fileUrl [fileUrl]`
|
|
20
20
|
: The server- or site-relative decoded URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both.
|
|
21
21
|
|
|
22
|
-
|
|
22
|
+
`-i, --fileId [fileId]`
|
|
23
23
|
: The UniqueId (GUID) of the file to retrieve. Specify either `fileUrl` or `fileId` but not both.
|
|
24
24
|
|
|
25
25
|
`-f, --force`
|
|
@@ -19,7 +19,7 @@ m365 spo folder retentionlabel ensure [options]
|
|
|
19
19
|
`--folderUrl [folderUrl]`
|
|
20
20
|
: The server- or site-relative decoded URL of the folder that should be labelled. Specify either `folderUrl` or `folderId` but not both.
|
|
21
21
|
|
|
22
|
-
|
|
22
|
+
`-i, --folderId [folderId]`
|
|
23
23
|
: The UniqueId (GUID) of the folder that should be labelled. Specify either `folderUrl` or `folderId` but not both.
|
|
24
24
|
|
|
25
25
|
`--name <name>`
|
|
@@ -30,7 +30,7 @@ m365 spo folder retentionlabel ensure [options]
|
|
|
30
30
|
|
|
31
31
|
## Remarks
|
|
32
32
|
|
|
33
|
-
You can also use [spo listitem retentionlabel remove](./../../../cmd/spo/listitem/listitem-retentionlabel-remove.mdx) for removing the retention label from a
|
|
33
|
+
You can also use [spo listitem retentionlabel remove](./../../../cmd/spo/listitem/listitem-retentionlabel-remove.mdx) for removing the retention label from a list item.
|
|
34
34
|
|
|
35
35
|
## Examples
|
|
36
36
|
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
import Global from '/docs/cmd/_global.mdx';
|
|
2
|
+
import Tabs from '@theme/Tabs';
|
|
3
|
+
import TabItem from '@theme/TabItem';
|
|
4
|
+
|
|
5
|
+
# spo folder sharinglink get
|
|
6
|
+
|
|
7
|
+
Gets details about a specific sharing link on a folder
|
|
8
|
+
|
|
9
|
+
## Usage
|
|
10
|
+
|
|
11
|
+
```sh
|
|
12
|
+
m365 spo folder sharinglink get [options]
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
## Options
|
|
16
|
+
|
|
17
|
+
```md definition-list
|
|
18
|
+
`-u, --webUrl <webUrl>`
|
|
19
|
+
: The URL of the site where the folder is located.
|
|
20
|
+
|
|
21
|
+
`--folderUrl [folderUrl]`
|
|
22
|
+
: The server- or site-relative decoded URL of the folder. Specify either `folderUrl` or `folderId` but not both.
|
|
23
|
+
|
|
24
|
+
`--folderId [folderId]`
|
|
25
|
+
: The Unique ID (GUID) of the folder. Specify either `folderUrl` or `folderId` but not both.
|
|
26
|
+
|
|
27
|
+
`-i, --id <id>`
|
|
28
|
+
: The sharing link ID.
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
<Global />
|
|
32
|
+
|
|
33
|
+
## Examples
|
|
34
|
+
|
|
35
|
+
Gets a specific sharing link of a folder by id.
|
|
36
|
+
|
|
37
|
+
```sh
|
|
38
|
+
m365 spo folder sharinglink get --webUrl https://contoso.sharepoint.com/sites/demo --id 45fa6aed-362f-48b1-b04e-6da85a526506 --folderId daebb04b-a773-4baa-b1d1-3625418e3234
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
Gets a specific sharing link of a folder by url.
|
|
42
|
+
|
|
43
|
+
```sh
|
|
44
|
+
m365 spo folder sharinglink get --webUrl https://contoso.sharepoint.com/sites/demo --id 45fa6aed-362f-48b1-b04e-6da85a526506 --folderUrl "/sites/demo/shared documents/folder"
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
## Response
|
|
48
|
+
|
|
49
|
+
<Tabs>
|
|
50
|
+
<TabItem value="JSON">
|
|
51
|
+
|
|
52
|
+
```json
|
|
53
|
+
{
|
|
54
|
+
"id": "d6f6a428-9857-471f-9635-edd68d5aa6c1",
|
|
55
|
+
"roles": [
|
|
56
|
+
"write"
|
|
57
|
+
],
|
|
58
|
+
"shareId": "u!aHR0cHM6Ly9uYWNoYW4zNjUuc2hhcmVwb2ludC5jb20vOmY6L3MvU1BEZW1vL0VxXzlYcXRIdks1RW9wd3NfX1kteko0QlNybFFNUy1qUTBFOWJsazhVLVNTdVE",
|
|
59
|
+
"hasPassword": false,
|
|
60
|
+
"grantedToIdentitiesV2": [],
|
|
61
|
+
"grantedToIdentities": [],
|
|
62
|
+
"link": {
|
|
63
|
+
"scope": "anonymous",
|
|
64
|
+
"type": "edit",
|
|
65
|
+
"webUrl": "https://contoso.sharepoint.com/:f:/s/demo/Eq_9XqtHvK5Eopws__Y-zJ4BSrlQMS-jQ0E9blk8U-SSuQ",
|
|
66
|
+
"preventsDownload": false
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
</TabItem>
|
|
72
|
+
<TabItem value="Text">
|
|
73
|
+
|
|
74
|
+
```text
|
|
75
|
+
grantedToIdentities : []
|
|
76
|
+
grantedToIdentitiesV2 : []
|
|
77
|
+
hasPassword : false
|
|
78
|
+
id : d6f6a428-9857-471f-9635-edd68d5aa6c1
|
|
79
|
+
link : {"scope":"anonymous","type":"edit","webUrl":"https://contoso.sharepoint.com/:f:/s/demo/Eq_9XqtHvK5Eopws__Y-zJ4BSrlQMS-jQ0E9blk8U-SSuQ","preventsDownload":false}
|
|
80
|
+
roles : ["write"]
|
|
81
|
+
shareId : u!aHR0cHM6Ly9uYWNoYW4zNjUuc2hhcmVwb2ludC5jb20vOmY6L3MvU1BEZW1vL0VxXzlYcXRIdks1RW9wd3NfX1kteko0QlNybFFNUy1qUTBFOWJsazhVLVNTdVE
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
</TabItem>
|
|
85
|
+
<TabItem value="CSV">
|
|
86
|
+
|
|
87
|
+
```csv
|
|
88
|
+
id,shareId,hasPassword
|
|
89
|
+
d6f6a428-9857-471f-9635-edd68d5aa6c1,u!aHR0cHM6Ly9uYWNoYW4zNjUuc2hhcmVwb2ludC5jb20vOmY6L3MvU1BEZW1vL0VxXzlYcXRIdks1RW9wd3NfX1kteko0QlNybFFNUy1qUTBFOWJsazhVLVNTdVE,
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
</TabItem>
|
|
93
|
+
<TabItem value="Markdown">
|
|
94
|
+
|
|
95
|
+
```md
|
|
96
|
+
# spo folder sharinglink get --webUrl "https://contoso.sharepoint.com/sites/demo" --id "d6f6a428-9857-471f-9635-edd68d5aa6c1" --folderUrl "/sites/demo/shared documents/Test"
|
|
97
|
+
|
|
98
|
+
Date: 5/2/2024
|
|
99
|
+
|
|
100
|
+
## d6f6a428-9857-471f-9635-edd68d5aa6c1
|
|
101
|
+
|
|
102
|
+
Property | Value
|
|
103
|
+
---------|-------
|
|
104
|
+
id | d6f6a428-9857-471f-9635-edd68d5aa6c1
|
|
105
|
+
shareId | u!aHR0cHM6Ly9uYWNoYW4zNjUuc2hhcmVwb2ludC5jb20vOmY6L3MvU1BEZW1vL0VxXzlYcXRIdks1RW9wd3NfX1kteko0QlNybFFNUy1qUTBFOWJsazhVLVNTdVE
|
|
106
|
+
hasPassword | false
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
</TabItem>
|
|
110
|
+
</Tabs>
|