@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.
Files changed (95) hide show
  1. package/allCommands.json +1 -1
  2. package/allCommandsFull.json +1 -1
  3. package/dist/Auth.js +1 -1
  4. package/dist/config.js +1 -1
  5. package/dist/m365/app/commands/permission/permission-add.js +9 -9
  6. package/dist/m365/commands/status.js +2 -2
  7. package/dist/m365/connection/commands/connection-remove.js +6 -2
  8. package/dist/m365/connection/commands/connection-set.js +4 -1
  9. package/dist/m365/connection/commands/connection-use.js +25 -4
  10. package/dist/m365/entra/commands/enterpriseapp/enterpriseapp-add.js +13 -13
  11. package/dist/m365/entra/commands/enterpriseapp/enterpriseapp-get.js +18 -18
  12. package/dist/m365/entra/commands/enterpriseapp/enterpriseapp-list.js +1 -1
  13. package/dist/m365/entra/commands/group/group-user-list.js +4 -4
  14. package/dist/m365/entra/commands/m365group/m365group-conversation-post-list.js +4 -4
  15. package/dist/m365/entra/commands/m365group/m365group-recyclebinitem-list.js +3 -3
  16. package/dist/m365/entra/commands/m365group/m365group-user-add.js +109 -32
  17. package/dist/m365/entra/commands/m365group/m365group-user-list.js +6 -9
  18. package/dist/m365/entra/commands/m365group/m365group-user-set.js +159 -84
  19. package/dist/m365/entra/commands/multitenant/multitenant-add.js +65 -0
  20. package/dist/m365/entra/commands/multitenant/multitenant-remove.js +118 -0
  21. package/dist/m365/entra/commands/multitenant/multitenant-set.js +72 -0
  22. package/dist/m365/entra/commands.js +3 -0
  23. package/dist/m365/flow/commands/flow-get.js +1 -1
  24. package/dist/m365/outlook/commands/message/message-get.js +11 -11
  25. package/dist/m365/pa/commands/app/app-export.js +13 -7
  26. package/dist/m365/spfx/commands/project/DeployWorkflow.js +1 -1
  27. package/dist/m365/spfx/commands/project/project-github-workflow-add.js +1 -10
  28. package/dist/m365/spo/commands/file/file-copy.js +55 -34
  29. package/dist/m365/spo/commands/file/file-roleassignment-add.js +1 -1
  30. package/dist/m365/spo/commands/file/file-roleinheritance-break.js +1 -1
  31. package/dist/m365/spo/commands/file/file-roleinheritance-reset.js +1 -1
  32. package/dist/m365/spo/commands/folder/folder-retentionlabel-ensure.js +1 -1
  33. package/dist/m365/spo/commands/folder/folder-set.js +0 -4
  34. package/dist/m365/spo/commands/folder/folder-sharinglink-get.js +86 -0
  35. package/dist/m365/spo/commands/folder/folder-sharinglink-list.js +110 -0
  36. package/dist/m365/spo/commands/list/ListInstance.js +6 -1
  37. package/dist/m365/spo/commands/list/list-get.js +9 -3
  38. package/dist/m365/spo/commands/list/list-list.js +1 -4
  39. package/dist/m365/spo/commands/list/list-roleassignment-add.js +46 -21
  40. package/dist/m365/spo/commands/list/list-roleassignment-remove.js +48 -46
  41. package/dist/m365/spo/commands/site/site-appcatalog-remove.js +48 -24
  42. package/dist/m365/spo/commands/site/site-remove.js +1 -7
  43. package/dist/m365/spo/commands/tenant/tenant-recyclebinitem-restore.js +2 -22
  44. package/dist/m365/spo/commands.js +2 -1
  45. package/dist/utils/drive.js +61 -0
  46. package/dist/utils/spo.js +143 -6
  47. package/docs/docs/cmd/app/permission/permission-add.mdx +5 -5
  48. package/docs/docs/cmd/connection/connection-use.mdx +8 -2
  49. package/docs/docs/cmd/entra/enterpriseapp/enterpriseapp-add.mdx +12 -12
  50. package/docs/docs/cmd/entra/enterpriseapp/enterpriseapp-get.mdx +14 -14
  51. package/docs/docs/cmd/entra/enterpriseapp/enterpriseapp-list.mdx +5 -5
  52. package/docs/docs/cmd/entra/group/group-user-list.mdx +7 -7
  53. package/docs/docs/cmd/entra/m365group/m365group-conversation-post-list.mdx +5 -5
  54. package/docs/docs/cmd/entra/m365group/m365group-recyclebinitem-list.mdx +3 -3
  55. package/docs/docs/cmd/entra/m365group/m365group-user-add.mdx +28 -10
  56. package/docs/docs/cmd/entra/m365group/m365group-user-list.mdx +1 -1
  57. package/docs/docs/cmd/entra/m365group/m365group-user-set.mdx +35 -11
  58. package/docs/docs/cmd/entra/multitenant/multitenant-add.mdx +107 -0
  59. package/docs/docs/cmd/entra/multitenant/multitenant-remove.mdx +58 -0
  60. package/docs/docs/cmd/entra/multitenant/multitenant-set.mdx +53 -0
  61. package/docs/docs/cmd/flow/flow-get.mdx +149 -283
  62. package/docs/docs/cmd/outlook/message/message-get.mdx +5 -5
  63. package/docs/docs/cmd/pa/app/app-export.mdx +15 -9
  64. package/docs/docs/cmd/planner/plan/plan-remove.mdx +1 -1
  65. package/docs/docs/cmd/spe/containertype/containertype-list.mdx +24 -53
  66. package/docs/docs/cmd/spfx/project/project-github-workflow-add.mdx +11 -12
  67. package/docs/docs/cmd/spo/app/app-uninstall.mdx +1 -1
  68. package/docs/docs/cmd/spo/applicationcustomizer/applicationcustomizer-get.mdx +4 -4
  69. package/docs/docs/cmd/spo/applicationcustomizer/applicationcustomizer-list.mdx +4 -4
  70. package/docs/docs/cmd/spo/file/file-copy.mdx +119 -12
  71. package/docs/docs/cmd/spo/file/file-retentionlabel-ensure.mdx +1 -1
  72. package/docs/docs/cmd/spo/file/file-roleassignment-add.mdx +2 -2
  73. package/docs/docs/cmd/spo/file/file-roleassignment-remove.mdx +1 -1
  74. package/docs/docs/cmd/spo/file/file-roleinheritance-break.mdx +1 -1
  75. package/docs/docs/cmd/spo/file/file-roleinheritance-reset.mdx +1 -1
  76. package/docs/docs/cmd/spo/folder/folder-retentionlabel-ensure.mdx +2 -2
  77. package/docs/docs/cmd/spo/folder/folder-set.mdx +0 -6
  78. package/docs/docs/cmd/spo/folder/folder-sharinglink-get.mdx +110 -0
  79. package/docs/docs/cmd/spo/folder/folder-sharinglink-list.mdx +114 -0
  80. package/docs/docs/cmd/spo/list/list-get.mdx +6 -0
  81. package/docs/docs/cmd/spo/list/list-list.mdx +5 -7
  82. package/docs/docs/cmd/spo/list/list-roleassignment-add.mdx +15 -3
  83. package/docs/docs/cmd/spo/list/list-roleassignment-remove.mdx +15 -3
  84. package/docs/docs/cmd/spo/listitem/listitem-retentionlabel-ensure.mdx +4 -4
  85. package/docs/docs/cmd/spo/listitem/listitem-retentionlabel-remove.mdx +1 -1
  86. package/docs/docs/cmd/spo/listitem/listitem-roleassignment-add.mdx +9 -9
  87. package/docs/docs/cmd/spo/listitem/listitem-roleassignment-remove.mdx +7 -7
  88. package/docs/docs/cmd/spo/site/site-appcatalog-remove.mdx +11 -2
  89. package/docs/docs/cmd/spo/site/site-recyclebinitem-list.mdx +1 -1
  90. package/docs/docs/cmd/spo/site/site-remove.mdx +0 -3
  91. package/docs/docs/cmd/spo/tenant/tenant-recyclebinitem-restore.mdx +2 -49
  92. package/docs/docs/cmd/spo/web/web-roleassignment-add.mdx +1 -1
  93. package/docs/docs/cmd/spo/web/web-roleassignment-remove.mdx +1 -1
  94. package/npm-shrinkwrap.json +572 -477
  95. 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
- # Container Types list
5
+ # spe containertype list
6
6
 
7
- Retrieves a list of Container Types created for a SharePoint Embedded Application
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
- "_ObjectType_": "Microsoft.Online.SharePoint.TenantAdministration.SPContainerTypeProperties",
35
- "ApplicationRedirectUrl": null,
36
- "AzureSubscriptionId": "/Guid(00000000-0000-0000-0000-000000000000)/",
37
- "ContainerTypeId": "/Guid(073269af-f1d2-042d-2ef5-5bdd6ac83115)/",
38
- "CreationDate": null,
39
- "DisplayName": "test1",
40
- "ExpiryDate": null,
41
- "IsBillingProfileRequired": true,
42
- "OwningAppId": "/Guid(df4085cc-9a38-4255-badc-5c5225610475)/",
43
- "OwningTenantId": "/Guid(00000000-0000-0000-0000-000000000000)/",
44
- "Region": null,
45
- "ResourceGroup": null,
46
- "SPContainerTypeBillingClassification": 0
47
- },
48
- {
49
- "_ObjectType_": "Microsoft.Online.SharePoint.TenantAdministration.SPContainerTypeProperties",
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 clear the author and created date.
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" --resetAuthorAndCreated
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.pdf"
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
- The command won't return a response on success.
80
-
81
- ## More information
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
- - Copy items from a SharePoint document library: [https://support.office.com/en-us/article/move-or-copy-items-from-a-sharepoint-document-library-00e2f483-4df3-46be-a861-1f5f0c1a87bc](https://support.office.com/en-us/article/move-or-copy-items-from-a-sharepoint-document-library-00e2f483-4df3-46be-a861-1f5f0c1a87bc)
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 listitem.
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
- `i, --fileId [fileId]`
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 Microsoft Entra or SharePoint group. Specify either `upn`, `groupName`, or `principalId` but not multiple.
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 a Microsoft Entra or SharePoint group. Specify either `upn`, `groupName`, or `principalId` but not multiple.
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
- `i, --fileId [fileId]`
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
- `i, --fileId [fileId]`
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
- `i, --folderId [folderId]`
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 listitem.
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
 
@@ -10,12 +10,6 @@ Updates a folder
10
10
  m365 spo folder set [options]
11
11
  ```
12
12
 
13
- ## Alias
14
-
15
- ```sh
16
- m365 spo folder rename [options]
17
- ```
18
-
19
13
  ## Options
20
14
 
21
15
  ```md definition-list
@@ -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>