@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
@@ -0,0 +1,114 @@
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 list
6
+
7
+ Lists all the sharing links of a specific folder
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 spo folder sharinglink list [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 UniqueId (GUID) of the folder. Specify either `folderUrl` or `folderId` but not both.
26
+
27
+ `-s, --scope [scope]`
28
+ : Filter the results to only sharing links of a given scope: `anonymous`, `users` or `organization`. By default all sharing links are listed.
29
+ ```
30
+
31
+ <Global />
32
+
33
+ ## Examples
34
+
35
+ List sharing links of a folder by id.
36
+
37
+ ```sh
38
+ m365 spo folder sharinglink list --webUrl https://contoso.sharepoint.com/sites/demo --folderId daebb04b-a773-4baa-b1d1-3625418e3234
39
+ ```
40
+
41
+ List sharing links of a folder by url.
42
+
43
+ ```sh
44
+ m365 spo folder sharinglink list --webUrl https://contoso.sharepoint.com/sites/demo --folderUrl "/sites/demo/shared documents/folder"
45
+ ```
46
+
47
+ List anonymous sharing links of a folder by url.
48
+
49
+ ```sh
50
+ m365 spo folder sharinglink list --webUrl https://contoso.sharepoint.com/sites/demo --folderUrl "/sites/demo/shared documents/folder" --scope anonymous
51
+ ```
52
+
53
+ ## Response
54
+
55
+ <Tabs>
56
+ <TabItem value="JSON">
57
+
58
+ ```json
59
+ [
60
+ {
61
+ "id": "e6100f73-981c-4bde-986b-eed262f04659",
62
+ "roles": [
63
+ "write"
64
+ ],
65
+ "shareId": "u!aHR0cHM6Ly83NTY2YXZhLnNoYXJlcG9pbnQuY29tLzpmOi9nL0V2QVFpdnpLV2ZoT3ZJOHJiNm1UVEhjQmQzUUxCOXVsUGIyQTQ1UG81ZmRuYWc",
66
+ "hasPassword": false,
67
+ "grantedToIdentitiesV2": [],
68
+ "grantedToIdentities": [],
69
+ "link": {
70
+ "scope": "anonymous",
71
+ "type": "edit",
72
+ "webUrl": "https://contoso.sharepoint.com/:f:/g/EvAQivzKWfhOvI8rb6mTTHcBd3QLB9ulPb2A45Po5fdnag",
73
+ "preventsDownload": false
74
+ }
75
+ }
76
+ ]
77
+ ```
78
+
79
+ </TabItem>
80
+ <TabItem value="Text">
81
+
82
+ ```text
83
+ id scope roles link
84
+ ------------------------------------ ------------ ----- -----------------------------------------------------------------------------------
85
+ e6100f73-981c-4bde-986b-eed262f04659 anonymous write https://contoso.sharepoint.com/:f:/g/EvAQivzKWfhOvI8rb6mTTHcBd3QLB9ulPb2A45Po5fdnag
86
+ ```
87
+
88
+ </TabItem>
89
+ <TabItem value="CSV">
90
+
91
+ ```csv
92
+ id,shareId,hasPassword
93
+ e6100f73-981c-4bde-986b-eed262f04659,u!aHR0cHM6Ly83NTY2YXZhLnNoYXJlcG9pbnQuY29tLzpmOi9nL0V2QVFpdnpLV2ZoT3ZJOHJiNm1UVEhjQmQzUUxCOXVsUGIyQTQ1UG81ZmRuYWc,
94
+ ```
95
+
96
+ </TabItem>
97
+ <TabItem value="Markdown">
98
+
99
+ ```md
100
+ # spo folder sharinglink list --webUrl "https://contoso.sharepoint.com/" --folderUrl "/shared documents/folder1"
101
+
102
+ Date: 24/04/2024
103
+
104
+ ## e6100f73-981c-4bde-986b-eed262f04659
105
+
106
+ Property | Value
107
+ ---------|-------
108
+ id | e6100f73-981c-4bde-986b-eed262f04659
109
+ shareId | u!aHR0cHM6Ly83NTY2YXZhLnNoYXJlcG9pbnQuY29tLzpmOi9nL0V2QVFpdnpLV2ZoT3ZJOHJiNm1UVEhjQmQzUUxCOXVsUGIyQTQ1UG81ZmRuYWc
110
+ hasPassword | false
111
+ ```
112
+
113
+ </TabItem>
114
+ </Tabs>
@@ -91,6 +91,11 @@ m365 spo list get --title Documents --webUrl https://contoso.sharepoint.com/site
91
91
 
92
92
  ```json
93
93
  {
94
+ "VersionPolicies": {
95
+ "DefaultExpireAfterDays": 0,
96
+ "DefaultTrimMode": 0,
97
+ "DefaultTrimModeValue": "NoExpiration"
98
+ },
94
99
  "AllowContentTypes": true,
95
100
  "BaseTemplate": 100,
96
101
  "BaseType": 0,
@@ -210,6 +215,7 @@ m365 spo list get --title Documents --webUrl https://contoso.sharepoint.com/site
210
215
  ServerTemplateCanCreateFolders : true
211
216
  TemplateFeatureId : 00bfea71-de22-43b2-a848-c05709900100
212
217
  Title : Test
218
+ VersionPolicies : {"DefaultExpireAfterDays": 0,"DefaultTrimMode": 0,"DefaultTrimModeValue": "NoExpiration"}
213
219
  ```
214
220
 
215
221
  </TabItem>
@@ -126,8 +126,7 @@ m365 spo list list --webUrl https://contoso.sharepoint.com/sites/project-x --fil
126
126
  "ParserDisabled": false,
127
127
  "ServerTemplateCanCreateFolders": false,
128
128
  "TemplateFeatureId": "00000000-0000-0000-0000-000000000000",
129
- "Title": "Theme Gallery",
130
- "Url": "/_catalogs/theme"
129
+ "Title": "Theme Gallery"
131
130
  }
132
131
  ]
133
132
  ```
@@ -136,17 +135,17 @@ m365 spo list list --webUrl https://contoso.sharepoint.com/sites/project-x --fil
136
135
  <TabItem value="Text">
137
136
 
138
137
  ```text
139
- Id Url
138
+ Id Title
140
139
  ------------------------------------ ----------------
141
- 66e5148c-7060-4479-88e7-636d79579148 /_catalogs/theme
140
+ 66e5148c-7060-4479-88e7-636d79579148 Theme Gallery
142
141
  ```
143
142
 
144
143
  </TabItem>
145
144
  <TabItem value="CSV">
146
145
 
147
146
  ```csv
148
- Id,Url
149
- Theme Gallery,/_catalogs/theme,66e5148c-7060-4479-88e7-636d79579148
147
+ Id,Title
148
+ 66e5148c-7060-4479-88e7-636d79579148,Theme Gallery
150
149
  ```
151
150
 
152
151
  </TabItem>
@@ -211,7 +210,6 @@ m365 spo list list --webUrl https://contoso.sharepoint.com/sites/project-x --fil
211
210
  ServerTemplateCanCreateFolders | true
212
211
  TemplateFeatureId | 00000000-0000-0000-0000-000000000000
213
212
  Title | Theme Gallery
214
- Url | //\_catalogs/theme
215
213
  ```
216
214
 
217
215
  </TabItem>
@@ -26,13 +26,19 @@ m365 spo list roleassignment add [options]
26
26
  : Relative URL of the list. Specify either `listId`, `listTitle`, or `listUrl` but not multiple.
27
27
 
28
28
  `--principalId [principalId]`
29
- : SharePoint ID of principal it may be either user id or group id we want to add permissions to. Specify either `principalId`, `upn`, or `groupName` but not multiple.
29
+ : SharePoint ID of principal it may be either user id or group id we want to add permissions to. Specify either `principalId`, `upn`, `groupName`, `entraGroupId`, or `entraGroupName`.
30
30
 
31
31
  `--upn [upn]`
32
- : The upn/email of user to assign role to. Specify either `principalId`, `upn`, or `groupName` but not multiple.
32
+ : The upn/email of user to assign role to. Specify either `principalId`, `upn`, `groupName`, `entraGroupId`, or `entraGroupName`.
33
+
34
+ `--entraGroupId [entraGroupId]`
35
+ : ID of the Microsoft Entra group to assign permissions to. Specify either `principalId`, `upn`, `groupName`, `entraGroupId`, or `entraGroupName`.
36
+
37
+ `--entraGroupName [entraGroupName]`
38
+ : Display name of the Microsoft Entra group to assign permissions to. Specify either `principalId`, `upn`, `groupName`, `entraGroupId`, or `entraGroupName`.
33
39
 
34
40
  `--groupName [groupName]`
35
- : The group name of Microsoft Entra or SharePoint group. Specify either `principalId`, `upn`, or `groupName` but not multiple.
41
+ : The group name of the SharePoint group. Specify either `principalId`, `upn`, `groupName`, `entraGroupId`, or `entraGroupName`.
36
42
 
37
43
  `--roleDefinitionId [roleDefinitionId]`
38
44
  : ID of role definition. Specify either `roleDefinitionId` or `roleDefinitionName` but not both.
@@ -81,6 +87,12 @@ Adds role assignment to list by title located in a specific site for given princ
81
87
  m365 spo list roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --principalId 11 --roleDefinitionName "Full Control"
82
88
  ```
83
89
 
90
+ Adds role assignment to list for a Microsoft Entra group specified by display name.
91
+
92
+ ```sh
93
+ m365 spo list roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --entraGroupName "Marketing" --roleDefinitionName "Full Control"
94
+ ```
95
+
84
96
  ## Response
85
97
 
86
98
  The command won't return a response on success.
@@ -26,13 +26,19 @@ m365 spo list roleassignment remove [options]
26
26
  : Relative URL of the list. Specify either `listId`, `listTitle`, or `listUrl` but not multiple.
27
27
 
28
28
  `--principalId [principalId]`
29
- : SharePoint ID of principal it may be either user id or group id you want to remove permissions. Specify either `principalId`, `upn`, or `groupName` but not multiple.
29
+ : SharePoint ID of principal it may be either user id or group id you want to remove permissions. Specify either `principalId`, `upn`, `groupName`, `entraGroupId`, or `entraGroupName`.
30
30
 
31
31
  `--upn [upn]`
32
- : The upn/email of user. Specify either `principalId`, `upn`, or `groupName` but not multiple.
32
+ : The upn/email of user. Specify either `principalId`, `upn`, `groupName`, `entraGroupId`, or `entraGroupName`.
33
33
 
34
34
  `--groupName [groupName]`
35
- : The group name of Microsoft Entra or SharePoint group. Specify either `principalId`, `upn`, or `groupName` but not multiple.
35
+ : The group name of the SharePoint group. Specify either `principalId`, `upn`, `groupName`, `entraGroupId`, or `entraGroupName`.
36
+
37
+ `--entraGroupId [entraGroupId]`
38
+ : ID of the Microsoft Entra group. Specify either `principalId`, `upn`, `groupName`, `entraGroupId`, or `entraGroupName`.
39
+
40
+ `--entraGroupName [entraGroupName]`
41
+ : Display name of the Microsoft Entra group. Specify either `principalId`, `upn`, `groupName`, `entraGroupId`, or `entraGroupName`.
36
42
 
37
43
  `-f, --force`
38
44
  : Don't prompt for confirming removing the role assignment.
@@ -60,6 +66,12 @@ Remove roleassignment from list by url based on principal Id.
60
66
  m365 spo list roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --listUrl '/sites/contoso-sales/lists/Events' --principalId 2
61
67
  ```
62
68
 
69
+ Remove roleassignment from Microsoft Entra group specified by display name.
70
+
71
+ ```sh
72
+ m365 spo list roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --listUrl '/sites/contoso-sales/lists/Events' --entraGroupName "Sales Team"
73
+ ```
74
+
63
75
  ## Response
64
76
 
65
77
  The command won't return a response on success.
@@ -14,19 +14,19 @@ m365 spo listitem retentionlabel ensure [options]
14
14
 
15
15
  ```md definition-list
16
16
  `-u, --webUrl <webUrl>`
17
- : URL of the site where the retentionlabel from a listitem to apply is located
17
+ : URL of the site where the retentionlabel from a list item to apply is located.
18
18
 
19
19
  `--listItemId <listItemId>`
20
20
  : The ID of the list item for which the retention label should be applied.
21
21
 
22
22
  `--listId [listId]`
23
- : ID of the list where the retention label should be applied. Specify either `listTitle`, `listId` or `listUrl`
23
+ : ID of the list where the retention label should be applied. Specify either `listTitle`, `listId` or `listUrl`.
24
24
 
25
25
  `--listTitle [listTitle]`
26
- : Title of the list where the retention label should be applied. Specify either `listTitle`, `listId` or `listUrl`
26
+ : Title of the list where the retention label should be applied. Specify either `listTitle`, `listId` or `listUrl`.
27
27
 
28
28
  `--listUrl [listUrl]`
29
- : Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`
29
+ : Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`.
30
30
 
31
31
  `-n, --name [name]`
32
32
  : The name of the retention label. Specify either `name` or `id`.
@@ -14,7 +14,7 @@ m365 spo listitem retentionlabel remove [options]
14
14
 
15
15
  ```md definition-list
16
16
  `-u, --webUrl <webUrl>`
17
- : URL of the site where the retentionlabel from a listitem to remove is located
17
+ : URL of the site where the retentionlabel from a list item to remove is located
18
18
 
19
19
  `-i, --listItemId <listItemId>`
20
20
  : The ID of the list item for which the retention label should be removed.
@@ -14,7 +14,7 @@ m365 spo listitem roleassignment add [options]
14
14
 
15
15
  ```md definition-list
16
16
  `-u, --webUrl <webUrl>`
17
- : URL of the site where the listitem is located
17
+ : URL of the site where the list item is located
18
18
 
19
19
  `--listId [listId]`
20
20
  : ID of the list. Specify either `listId`, `listTitle` or `listUrl` but not multiple.
@@ -26,7 +26,7 @@ m365 spo listitem roleassignment add [options]
26
26
  : Relative URL of the list. Specify either `listId`, `listTitle` or `listUrl` but not multiple.
27
27
 
28
28
  `--listItemId <listItemId>`
29
- : Id of the listitem to assign the role to.
29
+ : Id of the list item to assign the role to.
30
30
 
31
31
  `--principalId [principalId]`
32
32
  : The SharePoint Id of the principal. It may be either a user id or group id to add a role assignment for. Specify either `upn`, `groupName` or `principalId`.
@@ -35,7 +35,7 @@ m365 spo listitem roleassignment add [options]
35
35
  : The upn/email of user to assign role to. Specify either `upn`, `groupName` or `principalId`.
36
36
 
37
37
  `--groupName [groupName]`
38
- : The group name of Microsoft Entra or SharePoint group. Specify either `upn`, `groupName` or `principalId`.
38
+ : The group name of the SharePoint group Specify either `upn`, `groupName` or `principalId`.
39
39
 
40
40
  `--roleDefinitionId [roleDefinitionId]`
41
41
  : ID of role definition. Specify either `roleDefinitionId` or `roleDefinitionName` but not both.
@@ -48,37 +48,37 @@ m365 spo listitem roleassignment add [options]
48
48
 
49
49
  ## Examples
50
50
 
51
- Add role assignment to specified listitem in specified list located in specified site for specified principal id and specified role definition id.
51
+ Add role assignment to specified list item in specified list located in specified site for specified principal id and specified role definition id.
52
52
 
53
53
  ```sh
54
54
  m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --listItemId 1 --principalId 11 --roleDefinitionId 1073741829
55
55
  ```
56
56
 
57
- Add role assignment to specified listitem in specified list located in specified site for specified principal id and specified role definition id.
57
+ Add role assignment to specified list item in specified list located in specified site for specified principal id and specified role definition id.
58
58
 
59
59
  ```sh
60
60
  m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listId "0CD891EF-AFCE-4E55-B836-FCE03286CCCF" --listItemId 1 --principalId 11 --roleDefinitionId 1073741829
61
61
  ```
62
62
 
63
- Add role assignment to specified listitem in specified list located in specified site for specified principal id and specified role definition id.
63
+ Add role assignment to specified list item in specified list located in specified site for specified principal id and specified role definition id.
64
64
 
65
65
  ```sh
66
66
  m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listUrl "sites/documents" --listItemId 1 --principalId 11 --roleDefinitionId 1073741829
67
67
  ```
68
68
 
69
- Add role assignment to specified listitem in specified list located in specified site for specified upn and specified role definition id.
69
+ Add role assignment to specified list item in specified list located in specified site for specified upn and specified role definition id.
70
70
 
71
71
  ```sh
72
72
  m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --listItemId 1 --upn "someaccount@tenant.onmicrosoft.com" --roleDefinitionId 1073741829
73
73
  ```
74
74
 
75
- Add role assignment to specified listitem in specified list located in specified site for specified group and specified role definition id.
75
+ Add role assignment to specified list item in specified list located in specified site for specified group and specified role definition id.
76
76
 
77
77
  ```sh
78
78
  m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --listItemId 1 --groupName "someGroup" --roleDefinitionId 1073741829
79
79
  ```
80
80
 
81
- Add role assignment to specified listitem in specified list located in specified site for specified principal id and specified role definition name.
81
+ Add role assignment to specified list item in specified list located in specified site for specified principal id and specified role definition name.
82
82
 
83
83
  ```sh
84
84
  m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --listItemId 1 --principalId 11 --roleDefinitionName "Full Control"
@@ -14,7 +14,7 @@ m365 spo listitem roleassignment remove [options]
14
14
 
15
15
  ```md definition-list
16
16
  `-u, --webUrl <webUrl>`
17
- : URL of the site where the listitem is located.
17
+ : URL of the site where the list item is located.
18
18
 
19
19
  `-i, --listId [listId]`
20
20
  : ID of the list. Specify either `listId`, `listTitle`, or `listUrl` but not multiple.
@@ -26,7 +26,7 @@ m365 spo listitem roleassignment remove [options]
26
26
  : Relative URL of the list. Specify either `listId`, `listTitle`, or `listUrl` but not multiple.
27
27
 
28
28
  `--listItemId <listItemId>`
29
- : Id of the listitem to remove the role from.
29
+ : Id of the list item to remove the role from.
30
30
 
31
31
  `--principalId [principalId]`
32
32
  : SharePoint ID of principal it may be either user id or group id we want to remove permissions. Specify either `principalId`, `upn`, or `groupName` but not multiple.
@@ -35,7 +35,7 @@ m365 spo listitem roleassignment remove [options]
35
35
  : The upn/email of user. Specify either `principalId`, `upn`, or `groupName` but not multiple.
36
36
 
37
37
  `--groupName [groupName]`
38
- : The group name of Microsoft Entra or SharePoint group. Specify either `principalId`, `upn`, or `groupName` but not multiple.
38
+ : The group name of the SharePoint group Specify either `principalId`, `upn`, or `groupName` but not multiple.
39
39
 
40
40
  `-f, --force`
41
41
  : Don't prompt for confirming removing the role assignment.
@@ -45,26 +45,26 @@ m365 spo listitem roleassignment remove [options]
45
45
 
46
46
  ## Examples
47
47
 
48
- Remove roleassignment from listitem getting list by title based on group name
48
+ Remove roleassignment from list item getting list by title based on group name
49
49
 
50
50
  ```sh
51
51
  m365 spo listitem roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --listTitle "someList" --listItemId 1 --groupName "saleGroup"
52
52
  ```
53
53
 
54
- Remove roleassignment from listitem getting list by title based on principal Id
54
+ Remove roleassignment from list item getting list by title based on principal Id
55
55
 
56
56
  ```sh
57
57
  m365 spo listitem roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --listTitle "Events" --listItemId 1 --principalId 2
58
58
  ```
59
59
 
60
- Remove roleassignment from listitem getting list by url based on principal Id
60
+ Remove roleassignment from list item getting list by url based on principal Id
61
61
 
62
62
  ```sh
63
63
  m365 spo listitem roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --listUrl '/sites/contoso-sales/lists/Events' --listItemId 1 --principalId 2
64
64
  ```
65
65
 
66
66
 
67
- Remove roleassignment from listitem getting list by url based on principal Id without prompting for confirmation
67
+ Remove roleassignment from list item getting list by url based on principal Id without prompting for confirmation
68
68
 
69
69
  ```sh
70
70
  m365 spo listitem roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --listUrl '/sites/contoso-sales/lists/Events' --listItemId 1 --principalId 2 --force
@@ -14,7 +14,10 @@ m365 spo site appcatalog remove [options]
14
14
 
15
15
  ```md definition-list
16
16
  `-u, --siteUrl <siteUrl>`
17
- : URL of the site collection containing the app catalog to disable
17
+ : URL of the site collection containing the app catalog to disable.
18
+
19
+ `-f, --force`
20
+ : Don't prompt for confirmation.
18
21
  ```
19
22
 
20
23
  <Global />
@@ -31,12 +34,18 @@ To use this command you have to have permissions to access the tenant admin site
31
34
 
32
35
  ## Examples
33
36
 
34
- Remove the site collection app catalog from specified site
37
+ Remove the site collection app catalog from specified site.
35
38
 
36
39
  ```sh
37
40
  m365 spo site appcatalog remove --siteUrl https://contoso.sharepoint/sites/site
38
41
  ```
39
42
 
43
+ Remove the site collection app catalog from specified site without prompting for confirmation.
44
+
45
+ ```sh
46
+ m365 spo site appcatalog remove --siteUrl https://contoso.sharepoint/sites/site --force
47
+ ```
48
+
40
49
  ## Response
41
50
 
42
51
  The command won't return a response on success.
@@ -19,7 +19,7 @@ m365 spo site recyclebinitem list [options]
19
19
  : URL of the site for which to retrieve the recycle bin items
20
20
 
21
21
  `--type [type]`
22
- : Type of items which should be retrieved (listItems, folders, files)
22
+ : Type of items which should be retrieved. Valid values: `listItems`, `folders`, `files`.
23
23
 
24
24
  `--secondary`
25
25
  : Use this switch to retrieve items from secondary recycle bin
@@ -22,9 +22,6 @@ m365 spo site remove [options]
22
22
  `--fromRecycleBin`
23
23
  : Set to remove the site from the recycle bin.
24
24
 
25
- `--wait`
26
- : (deprecated) Wait for the site to be removed before completing the command.
27
-
28
25
  `-f, --force`
29
26
  : Don't prompt for confirmation.
30
27
  ```
@@ -17,9 +17,6 @@ m365 spo tenant recyclebinitem restore [options]
17
17
  ```md definition-list
18
18
  `-u, --siteUrl <siteUrl>`
19
19
  : URL of the site.
20
-
21
- `--wait`
22
- : (deprecated) Wait for the site collection to be restored before completing the command.
23
20
  ```
24
21
 
25
22
  <Global />
@@ -34,7 +31,7 @@ To use this command you must be a Global or SharePoint administrator.
34
31
 
35
32
  ## Examples
36
33
 
37
- Restore a deleted site collection from tenant recycle bin
34
+ Restores a deleted site collection from tenant recycle bin.
38
35
 
39
36
  ```sh
40
37
  m365 spo tenant recyclebinitem restore --siteUrl https://contoso.sharepoint.com/sites/team
@@ -42,48 +39,4 @@ m365 spo tenant recyclebinitem restore --siteUrl https://contoso.sharepoint.com/
42
39
 
43
40
  ## Response
44
41
 
45
- <Tabs>
46
- <TabItem value="JSON">
47
-
48
- ```json
49
- {
50
- "HasTimedout": false,
51
- "IsComplete": true,
52
- "PollingInterval": 15000
53
- }
54
- ```
55
-
56
- </TabItem>
57
- <TabItem value="Text">
58
-
59
- ```text
60
- HasTimedout : false
61
- IsComplete : true
62
- PollingInterval: 15000
63
- ```
64
-
65
- </TabItem>
66
- <TabItem value="CSV">
67
-
68
- ```csv
69
- HasTimedout,IsComplete,PollingInterval
70
- ,1,15000
71
- ```
72
-
73
- </TabItem>
74
- <TabItem value="Markdown">
75
-
76
- ```md
77
- # spo tenant recyclebinitem restore --siteUrl "https://contoso.sharepoint.com/teams/team1"
78
-
79
- Date: 2023-06-22
80
-
81
- Property | Value
82
- ---------|-------
83
- HasTimedout | false
84
- IsComplete | true
85
- PollingInterval | 15000
86
- ```
87
-
88
- </TabItem>
89
- </Tabs>
42
+ The command won't return a response on success.
@@ -23,7 +23,7 @@ m365 spo web roleassignment add [options]
23
23
  : The upn/email of user to assign role to. Specify either `principalId`, `upn`, or `groupName` but not multiple.
24
24
 
25
25
  `--groupName [groupName]`
26
- : The group name of Microsoft Entra or SharePoint group. Specify either `principalId`, `upn`, or `groupName` but not multiple.
26
+ : The group name of the SharePoint group Specify either `principalId`, `upn`, or `groupName` but not multiple.
27
27
 
28
28
  `--roleDefinitionId [roleDefinitionId]`
29
29
  : ID of role definition. Specify either `roleDefinitionId` or `roleDefinitionName` but not both.
@@ -23,7 +23,7 @@ m365 spo web roleassignment remove [options]
23
23
  : The upn/email of user to assign role to. Specify either `principalId`, `upn`, or `groupName` but not multiple.
24
24
 
25
25
  `--groupName [groupName]`
26
- : The group name of Microsoft Entra or SharePoint group. Specify either `principalId`, `upn`, or `groupName` but not multiple.
26
+ : The group name of the SharePoint group Specify either `principalId`, `upn`, or `groupName` but not multiple.
27
27
 
28
28
  `-f, --force`
29
29
  : Don't prompt for confirming removing the roleassignment.