@pnp/cli-microsoft365 7.10.0-beta.0d80e6e → 7.10.0-beta.4ffb095

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 (31) hide show
  1. package/.eslintrc.cjs +2 -0
  2. package/allCommands.json +1 -1
  3. package/allCommandsFull.json +1 -1
  4. package/dist/Auth.js +1 -1
  5. package/dist/chili/chili.js +9 -77
  6. package/dist/m365/entra/commands/app/app-permission-remove.js +287 -0
  7. package/dist/m365/entra/commands/pim/pim-role-assignment-eligibility-list.js +124 -0
  8. package/dist/m365/entra/commands/pim/pim-role-request-list.js +149 -0
  9. package/dist/m365/entra/commands.js +3 -0
  10. package/dist/m365/spo/commands/file/file-add.js +41 -38
  11. package/dist/m365/spo/commands/folder/folder-add.js +65 -21
  12. package/dist/m365/spo/commands/site/site-admin-list.js +144 -0
  13. package/dist/m365/spo/commands/site/site-set.js +22 -24
  14. package/dist/m365/spo/commands/tenant/tenant-site-archive.js +99 -0
  15. package/dist/m365/spo/commands/tenant/tenant-site-unarchive.js +98 -0
  16. package/dist/m365/spo/commands.js +3 -0
  17. package/dist/m365/teams/commands/user/user-app-add.js +17 -17
  18. package/dist/m365/teams/commands/user/user-app-upgrade.js +106 -0
  19. package/dist/m365/teams/commands.js +2 -1
  20. package/dist/utils/md.js +2 -2
  21. package/docs/docs/cmd/entra/app/app-permission-remove.mdx +60 -0
  22. package/docs/docs/cmd/entra/pim/pim-role-assignment-eligibility-list.mdx +205 -0
  23. package/docs/docs/cmd/entra/pim/pim-role-request-list.mdx +261 -0
  24. package/docs/docs/cmd/spo/folder/folder-add.mdx +9 -0
  25. package/docs/docs/cmd/spo/site/site-admin-list.mdx +115 -0
  26. package/docs/docs/cmd/spo/tenant/tenant-site-archive.mdx +63 -0
  27. package/docs/docs/cmd/spo/tenant/tenant-site-unarchive.mdx +67 -0
  28. package/docs/docs/cmd/status.mdx +10 -9
  29. package/docs/docs/cmd/teams/user/user-app-upgrade.mdx +59 -0
  30. package/npm-shrinkwrap.json +181 -90
  31. package/package.json +16 -15
@@ -0,0 +1,205 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+ import Tabs from '@theme/Tabs';
3
+ import TabItem from '@theme/TabItem';
4
+
5
+ # entra pim role assignment eligibility list
6
+
7
+ Retrieves a list of eligible roles a user or group can be assigned to
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 entra pim role assignment eligibility list [options]
13
+ ```
14
+
15
+ ## Options
16
+
17
+ ```md definition-list
18
+ `--userId [userId]`
19
+ : Id of the user for which to list eligible roles. Specify either `userId`, `userName`, `groupId` or `groupName`. If not specified, all eligible roles will be listed.
20
+
21
+ `--userName [userName]`
22
+ : UPN of the user for which to list eligible roles. Specify either `userId`, `userName`, `groupId` or `groupName`. If not specified, all eligible roles will be listed.
23
+
24
+ `--groupId [groupId]`
25
+ : Id of the group for which to list eligible roles. Specify either `userId`, `userName`, `groupId` or `groupName`. If not specified, all eligible roles will be listed.
26
+
27
+ `--groupName [groupName]`
28
+ : Display name of the group for which to list eligible roles. Specify either `userId`, `userName`, `groupId` or `groupName`. If not specified, all eligible roles will be listed.
29
+
30
+ `--includePrincipalDetails`
31
+ : An optional flag to include details of the principals that were eligible for a role.
32
+ ```
33
+
34
+ <Global />
35
+
36
+ ## Examples
37
+
38
+ Get a list of eligible roles for any user.
39
+
40
+ ```sh
41
+ m365 entra pim role assignment eligibility list
42
+ ```
43
+
44
+ Get a list of eligible roles for the current user.
45
+
46
+ ```sh
47
+ m365 entra pim role assignment eligibility list --userId '@meID'
48
+ ```
49
+
50
+ Get a list of eligible roles for any user with principal details.
51
+
52
+ ```sh
53
+ m365 entra pim role assignment eligibility list --includePrincipalDetails
54
+ ```
55
+
56
+ ## Response
57
+
58
+ ### Standard response
59
+
60
+ <Tabs>
61
+ <TabItem value="JSON">
62
+
63
+ ```json
64
+ [
65
+ {
66
+ "id": "XrtkCdube02sKVjnlIYqQBht8lJR0U9DrhSkqDEisrI-1-e",
67
+ "principalId": "52f26d18-d151-434f-ae14-a4a83122b2b2",
68
+ "roleDefinitionId": "0964bb5e-9bdb-4d7b-ac29-58e794862a40",
69
+ "directoryScopeId": "/",
70
+ "appScopeId": null,
71
+ "startDateTime": "2024-04-08T10:14:01.153Z",
72
+ "endDateTime": null,
73
+ "memberType": "Direct",
74
+ "roleEligibilityScheduleId": "7a135e3d-5be5-403c-bdad-47ccbac434e3",
75
+ "roleDefinitionName": "displayName": "Search Administrator"
76
+ }
77
+ ]
78
+ ```
79
+
80
+ </TabItem>
81
+ <TabItem value="Text">
82
+
83
+ ```text
84
+ roleDefinitionId roleDefinitionName principalId
85
+ ------------------------------------ -------------------- ------------------------------------
86
+ 0964bb5e-9bdb-4d7b-ac29-58e794862a40 Search Administrator 52f26d18-d151-434f-ae14-a4a83122b2b2
87
+ 744ec460-397e-42ad-a462-8b3f9747a02c Knowledge Manager 61b0c52f-a902-4769-9a09-c6628335b00a
88
+ ```
89
+
90
+ </TabItem>
91
+ <TabItem value="CSV">
92
+
93
+ ```csv
94
+ id,principalId,roleDefinitionId,directoryScopeId,appScopeId,startDateTime,endDateTime,memberType,roleEligibilityScheduleId,roleDefinitionName
95
+ XrtkCdube02sKVjnlIYqQBht8lJR0U9DrhSkqDEisrI-1-e,52f26d18-d151-434f-ae14-a4a83122b2b2,0964bb5e-9bdb-4d7b-ac29-58e794862a40,/,,2024-04-08T10:14:01.153Z,,Direct,7a135e3d-5be5-403c-bdad-47ccbac434e3,Search Administrator
96
+ YMROdH45rUKkYos_l0egLC_FsGECqWlHmgnGYoM1sAo-1-e,61b0c52f-a902-4769-9a09-c6628335b00a,744ec460-397e-42ad-a462-8b3f9747a02c,/,,2024-04-08T10:13:04.913Z,2025-04-08T10:12:36.9Z,Direct,0606b8a1-ba92-42b7-804c-8e32dfdec2b8,Knowledge Manager
97
+ ```
98
+
99
+ </TabItem>
100
+ <TabItem value="Markdown">
101
+
102
+ ```md
103
+ # entra pim role assignment eligibility list
104
+
105
+ Date: 4/8/2024
106
+
107
+ ## XrtkCdube02sKVjnlIYqQBht8lJR0U9DrhSkqDEisrI-1-e
108
+
109
+ Property | Value
110
+ ---------|-------
111
+ id | XrtkCdube02sKVjnlIYqQBht8lJR0U9DrhSkqDEisrI-1-e
112
+ principalId | 52f26d18-d151-434f-ae14-a4a83122b2b2
113
+ roleDefinitionId | 0964bb5e-9bdb-4d7b-ac29-58e794862a40
114
+ directoryScopeId | /
115
+ startDateTime | 2024-04-08T10:14:01.153Z
116
+ memberType | Direct
117
+ roleEligibilityScheduleId | 7a135e3d-5be5-403c-bdad-47ccbac434e3
118
+ roleDefinitionName | Search Administrator
119
+ ```
120
+
121
+ </TabItem>
122
+ </Tabs>
123
+
124
+ ### `includePrincipalDetails` response
125
+
126
+ When we make use of the option `includePrincipalDetails` the response will differ.
127
+
128
+ <Tabs>
129
+ <TabItem value="JSON">
130
+
131
+ ```json
132
+ [
133
+ {
134
+ "id": "XrtkCdube02sKVjnlIYqQBht8lJR0U9DrhSkqDEisrI-1-e",
135
+ "principalId": "52f26d18-d151-434f-ae14-a4a83122b2b2",
136
+ "roleDefinitionId": "0964bb5e-9bdb-4d7b-ac29-58e794862a40",
137
+ "directoryScopeId": "/",
138
+ "appScopeId": null,
139
+ "startDateTime": "2024-04-08T10:14:01.153Z",
140
+ "endDateTime": null,
141
+ "memberType": "Direct",
142
+ "roleEligibilityScheduleId": "7a135e3d-5be5-403c-bdad-47ccbac434e3",
143
+ "roleDefinitionName": "Search Administrator",
144
+ "principal": {
145
+ "id": "52f26d18-d151-434f-ae14-a4a83122b2b2",
146
+ "displayName": "Alex Wilber",
147
+ "userPrincipalName": "AlexW@contoso.onmicrosoft.com",
148
+ "mail": "AlexW@contoso.onmicrosoft.com",
149
+ "businessPhones": [
150
+ "+1 858 555 0110"
151
+ ],
152
+ "givenName": "Alex",
153
+ "jobTitle": "Marketing Assistant",
154
+ "mobilePhone": null,
155
+ "officeLocation": "131/1104",
156
+ "preferredLanguage": "en-US",
157
+ "surname": "Wilber"
158
+ }
159
+ }
160
+ ]
161
+ ```
162
+
163
+ </TabItem>
164
+ <TabItem value="Text">
165
+
166
+ ```text
167
+ roleDefinitionId roleDefinitionName principalId
168
+ ------------------------------------ -------------------- ------------------------------------
169
+ 0964bb5e-9bdb-4d7b-ac29-58e794862a40 Search Administrator 52f26d18-d151-434f-ae14-a4a83122b2b2
170
+ 744ec460-397e-42ad-a462-8b3f9747a02c Knowledge Manager 61b0c52f-a902-4769-9a09-c6628335b00a
171
+ ```
172
+
173
+ </TabItem>
174
+ <TabItem value="CSV">
175
+
176
+ ```csv
177
+ id,principalId,roleDefinitionId,directoryScopeId,appScopeId,startDateTime,endDateTime,memberType,roleEligibilityScheduleId,roleDefinitionName
178
+ XrtkCdube02sKVjnlIYqQBht8lJR0U9DrhSkqDEisrI-1-e,52f26d18-d151-434f-ae14-a4a83122b2b2,0964bb5e-9bdb-4d7b-ac29-58e794862a40,/,,2024-04-08T10:14:01.153Z,,Direct,7a135e3d-5be5-403c-bdad-47ccbac434e3,Search Administrator
179
+ YMROdH45rUKkYos_l0egLC_FsGECqWlHmgnGYoM1sAo-1-e,61b0c52f-a902-4769-9a09-c6628335b00a,744ec460-397e-42ad-a462-8b3f9747a02c,/,,2024-04-08T10:13:04.913Z,2025-04-08T10:12:36.9Z,Direct,0606b8a1-ba92-42b7-804c-8e32dfdec2b8,Knowledge Manager
180
+ ```
181
+
182
+ </TabItem>
183
+ <TabItem value="Markdown">
184
+
185
+ ```md
186
+ # entra pim role assignment eligibility list --includePrincipalDetails "true"
187
+
188
+ Date: 4/8/2024
189
+
190
+ ## XrtkCdube02sKVjnlIYqQBht8lJR0U9DrhSkqDEisrI-1-e
191
+
192
+ Property | Value
193
+ ---------|-------
194
+ id | XrtkCdube02sKVjnlIYqQBht8lJR0U9DrhSkqDEisrI-1-e
195
+ principalId | 52f26d18-d151-434f-ae14-a4a83122b2b2
196
+ roleDefinitionId | 0964bb5e-9bdb-4d7b-ac29-58e794862a40
197
+ directoryScopeId | /
198
+ startDateTime | 2024-04-08T10:14:01.153Z
199
+ memberType | Direct
200
+ roleEligibilityScheduleId | 7a135e3d-5be5-403c-bdad-47ccbac434e3
201
+ roleDefinitionName | Search Administrator
202
+ ```
203
+
204
+ </TabItem>
205
+ </Tabs>
@@ -0,0 +1,261 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+ import Tabs from '@theme/Tabs';
3
+ import TabItem from '@theme/TabItem';
4
+
5
+ # entra pim role request list
6
+
7
+ Retrieves a list of PIM requests for roles
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 entra pim role request list [options]
13
+ ```
14
+
15
+ ## Options
16
+
17
+ ```md definition-list
18
+ `--userId [userId]`
19
+ : Id of the user for which to list requests. Specify either `userId`, `userName`, `groupId` or `groupName`. If not specified, all requests will be listed.
20
+
21
+ `--userName [userName]`
22
+ : UPN of the user for which to list requests. Specify either `userId`, `userName`, `groupId` or `groupName`. If not specified, all requests will be listed.
23
+
24
+ `--groupId [groupId]`
25
+ : Id of the group for which to list requests. Specify either `userId`, `userName`, `groupId` or `groupName`. If not specified, all requests will be listed.
26
+
27
+ `--groupName [groupName]`
28
+ : Display name of the group for which to list requests. Specify either `userId`, `userName`, `groupId` or `groupName`. If not specified, all requests will be listed.
29
+
30
+ `-c, --createdDateTime [createdDateTime]`
31
+ : An optional ISO 8601 formatted date filter to search from.
32
+
33
+ `-s, --status [status]`
34
+ : An optional value to filter the list of requests. Allowed values are: `Canceled`, `Denied`, `Failed`, `Granted`, `PendingAdminDecision`, `PendingApproval`, `PendingProvisioning`, `PendingScheduleCreation`, `Provisioned`, `Revoked`, and `ScheduleCreated`.
35
+
36
+ `--includePrincipalDetails`
37
+ : An optional flag to include details of the principals that were assigned a role.
38
+ ```
39
+
40
+ <Global />
41
+
42
+ ## Examples
43
+
44
+ Get a list of PIM requests for roles.
45
+
46
+ ```sh
47
+ m365 entra pim role request list
48
+ ```
49
+
50
+ Get a list of PIM requests for the current user.
51
+
52
+ ```sh
53
+ m365 entra pim role request list --userId '@meID'
54
+ ```
55
+
56
+ Get a list of PIM requests for a specified user since the first of January 2024.
57
+
58
+ ```sh
59
+ m365 entra pim role request list --createdDateTime 2024-01-01T00:00:00Z
60
+ ```
61
+
62
+ Get a list of PIM requests with principal details.
63
+
64
+ ```sh
65
+ m365 entra pim role request list --includePrincipalDetails
66
+ ```
67
+
68
+ Get a list of PIM requests with pending approvals.
69
+
70
+ ```sh
71
+ m365 entra pim role request list --status PendingApproval
72
+ ```
73
+
74
+ ## Response
75
+
76
+ ### Standard response
77
+
78
+ <Tabs>
79
+ <TabItem value="JSON">
80
+
81
+ ```json
82
+ [
83
+ {
84
+ "id": "80231d2f-95a1-47a5-8339-acf3d71efec7",
85
+ "status": "Revoked",
86
+ "createdDateTime": "2024-02-12T14:08:38.82Z",
87
+ "completedDateTime": null,
88
+ "approvalId": null,
89
+ "customData": null,
90
+ "action": "adminRemove",
91
+ "principalId": "61b0c52f-a902-4769-9a09-c6628335b00a",
92
+ "roleDefinitionId": "f28a1f50-f6e7-4571-818b-6a12f2af6b6c",
93
+ "directoryScopeId": "/",
94
+ "appScopeId": null,
95
+ "isValidationOnly": false,
96
+ "targetScheduleId": null,
97
+ "justification": null,
98
+ "scheduleInfo": null,
99
+ "createdBy": {
100
+ "application": null,
101
+ "device": null,
102
+ "user": {
103
+ "displayName": null,
104
+ "id": "893f9116-e024-4bc6-8e98-54c245129485"
105
+ }
106
+ },
107
+ "ticketInfo": {
108
+ "ticketNumber": null,
109
+ "ticketSystem": null
110
+ },
111
+ "roleDefinitionName": "SharePoint Administrator"
112
+ }
113
+ ]
114
+ ```
115
+
116
+ </TabItem>
117
+ <TabItem value="Text">
118
+
119
+ ```text
120
+ id roleDefinitionName principalId
121
+ ------------------------------------ ------------------------ ------------------------------------
122
+ 48eed833-155f-46ce-87f2-e02e94667dd8 SharePoint Administrator 61b0c52f-a902-4769-9a09-c6628335b00a
123
+ da1cb564-78ba-4198-b94a-613d892ed73e User Administrator 61b0c52f-a902-4769-9a09-c6628335b00a
124
+ ```
125
+
126
+ </TabItem>
127
+ <TabItem value="CSV">
128
+
129
+ ```csv
130
+ id,status,createdDateTime,completedDateTime,approvalId,customData,action,principalId,roleDefinitionId,directoryScopeId,appScopeId,isValidationOnly,targetScheduleId,justification,scheduleInfo,roleDefinitionName
131
+ da1cb564-78ba-4198-b94a-613d892ed73e,Revoked,2023-10-15T12:35:08.167Z,,,,adminRemove,61b0c52f-a902-4769-9a09-c6628335b00a,fe930be7-5e62-47db-91af-98c3a49a38b1,/administrativeUnits/0a22c83d-c4ac-43e2-bb5e-87af3015d49f,,,,,,User Administrator
132
+ 38d6295f-19e9-4945-90f4-75a2284676ea,Revoked,2024-02-12T08:19:25.037Z,,,,adminRemove,61b0c52f-a902-4769-9a09-c6628335b00a,f28a1f50-f6e7-4571-818b-6a12f2af6b6c,/administrativeUnits/81bb36e4-f4c6-4984-8e56-d4f8feae9e09,,,,,,SharePoint Administrator
133
+ ```
134
+
135
+ </TabItem>
136
+ <TabItem value="Markdown">
137
+
138
+ ```md
139
+ # entra pim role request list
140
+
141
+ Date: 5/30/2024
142
+
143
+ ## da1cb564-78ba-4198-b94a-613d892ed73e
144
+
145
+ Property | Value
146
+ ---------|-------
147
+ id | da1cb564-78ba-4198-b94a-613d892ed73e
148
+ status | Revoked
149
+ createdDateTime | 2023-10-15T12:35:08.167Z
150
+ action | adminRemove
151
+ principalId | 61b0c52f-a902-4769-9a09-c6628335b00a
152
+ roleDefinitionId | fe930be7-5e62-47db-91af-98c3a49a38b1
153
+ directoryScopeId | /administrativeUnits/0a22c83d-c4ac-43e2-bb5e-87af3015d49f
154
+ isValidationOnly | false
155
+ roleDefinitionName | User Administrator
156
+ ```
157
+
158
+ </TabItem>
159
+ </Tabs>
160
+
161
+ ### `includePrincipalDetails` response
162
+
163
+ When we make use of the option `includePrincipalDetails` the response will differ.
164
+
165
+ <Tabs>
166
+ <TabItem value="JSON">
167
+
168
+ ```json
169
+ [
170
+ {
171
+ "id": "80231d2f-95a1-47a5-8339-acf3d71efec7",
172
+ "status": "Revoked",
173
+ "createdDateTime": "2024-02-12T14:08:38.82Z",
174
+ "completedDateTime": null,
175
+ "approvalId": null,
176
+ "customData": null,
177
+ "action": "adminRemove",
178
+ "principalId": "61b0c52f-a902-4769-9a09-c6628335b00a",
179
+ "roleDefinitionId": "f28a1f50-f6e7-4571-818b-6a12f2af6b6c",
180
+ "directoryScopeId": "/",
181
+ "appScopeId": null,
182
+ "isValidationOnly": false,
183
+ "targetScheduleId": null,
184
+ "justification": null,
185
+ "scheduleInfo": null,
186
+ "createdBy": {
187
+ "application": null,
188
+ "device": null,
189
+ "user": {
190
+ "displayName": null,
191
+ "id": "893f9116-e024-4bc6-8e98-54c245129485"
192
+ }
193
+ },
194
+ "ticketInfo": {
195
+ "ticketNumber": null,
196
+ "ticketSystem": null
197
+ },
198
+ "roleDefinitionName": "SharePoint Administrator",
199
+ "principal": {
200
+ "id": "61b0c52f-a902-4769-9a09-c6628335b00a",
201
+ "displayName": "John Doe",
202
+ "userPrincipalName": "JohnDoe@contoso.onmicrosoft.com",
203
+ "mail": "JohnDoe@contoso.onmicrosoft.com",
204
+ "businessPhones": [
205
+ "+1 425 555 0109"
206
+ ],
207
+ "givenName": "John",
208
+ "jobTitle": "Retail Manager",
209
+ "mobilePhone": null,
210
+ "officeLocation": "18/2111",
211
+ "preferredLanguage": "en-US",
212
+ "surname": "Doe"
213
+ }
214
+ }
215
+ ]
216
+ ```
217
+
218
+ </TabItem>
219
+ <TabItem value="Text">
220
+
221
+ ```text
222
+ id roleDefinitionName principalId
223
+ ------------------------------------ ------------------------ ------------------------------------
224
+ 48eed833-155f-46ce-87f2-e02e94667dd8 SharePoint Administrator 61b0c52f-a902-4769-9a09-c6628335b00a
225
+ da1cb564-78ba-4198-b94a-613d892ed73e User Administrator 61b0c52f-a902-4769-9a09-c6628335b00a
226
+ ```
227
+
228
+ </TabItem>
229
+ <TabItem value="CSV">
230
+
231
+ ```csv
232
+ id,status,createdDateTime,completedDateTime,approvalId,customData,action,principalId,roleDefinitionId,directoryScopeId,appScopeId,isValidationOnly,targetScheduleId,justification,scheduleInfo,roleDefinitionName
233
+ da1cb564-78ba-4198-b94a-613d892ed73e,Revoked,2023-10-15T12:35:08.167Z,,,,adminRemove,61b0c52f-a902-4769-9a09-c6628335b00a,fe930be7-5e62-47db-91af-98c3a49a38b1,/administrativeUnits/0a22c83d-c4ac-43e2-bb5e-87af3015d49f,,,,,,User Administrator
234
+ 38d6295f-19e9-4945-90f4-75a2284676ea,Revoked,2024-02-12T08:19:25.037Z,,,,adminRemove,61b0c52f-a902-4769-9a09-c6628335b00a,f28a1f50-f6e7-4571-818b-6a12f2af6b6c,/administrativeUnits/81bb36e4-f4c6-4984-8e56-d4f8feae9e09,,,,,,SharePoint Administrator
235
+ ```
236
+
237
+ </TabItem>
238
+ <TabItem value="Markdown">
239
+
240
+ ```md
241
+ # entra pim role request list --includePrincipalDetails "true"
242
+
243
+ Date: 5/30/2024
244
+
245
+ ## da1cb564-78ba-4198-b94a-613d892ed73e
246
+
247
+ Property | Value
248
+ ---------|-------
249
+ id | da1cb564-78ba-4198-b94a-613d892ed73e
250
+ status | Revoked
251
+ createdDateTime | 2023-10-15T12:35:08.167Z
252
+ action | adminRemove
253
+ principalId | 61b0c52f-a902-4769-9a09-c6628335b00a
254
+ roleDefinitionId | fe930be7-5e62-47db-91af-98c3a49a38b1
255
+ directoryScopeId | /administrativeUnits/0a22c83d-c4ac-43e2-bb5e-87af3015d49f
256
+ isValidationOnly | false
257
+ roleDefinitionName | User Administrator
258
+ ```
259
+
260
+ </TabItem>
261
+ </Tabs>
@@ -26,6 +26,9 @@ m365 spo folder add [options]
26
26
 
27
27
  `--color [color]`
28
28
  : Visual color of the folder. Valid values are a color name or a number. Check remarks for more info.
29
+
30
+ `--ensureParentFolders [ensureParentFolders]`
31
+ : Ensure that the parent folder path is available. Any missing folders will be created recursively.
29
32
  ```
30
33
 
31
34
  <Global />
@@ -79,6 +82,12 @@ Create a folder with a light teal look
79
82
  m365 spo folder add --webUrl https://contoso.sharepoint.com --url '/ProjectFiles/Project-x' --color lightTeal
80
83
  ```
81
84
 
85
+ Create a folder and make sure that any missing folders specified as parent folders are created.
86
+
87
+ ```sh
88
+ m365 spo folder add --webUrl https://contoso.sharepoint.com/sites/project-x --parentFolderUrl '/Projects/2024/Q1/Reports' --name Financial --ensureParentFolders
89
+ ```
90
+
82
91
  ## Response
83
92
 
84
93
  <Tabs>
@@ -0,0 +1,115 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+ import Tabs from '@theme/Tabs';
3
+ import TabItem from '@theme/TabItem';
4
+
5
+ # spo site admin list
6
+
7
+ Lists all administrators of a specific SharePoint site
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 spo site admin list [options]
13
+ ```
14
+
15
+ ## Options
16
+
17
+ ```md definition-list
18
+ `-u, --siteUrl <siteUrl>`
19
+ : The URL of the SharePoint site
20
+
21
+ `--asAdmin`
22
+ : List admins as admin for sites you don't have permission to
23
+ ```
24
+
25
+ <Global />
26
+
27
+ ## Remarks
28
+
29
+ :::info
30
+
31
+ To use this command with the `--asAdmin` mode, you must have permission to access the tenant admin site.
32
+
33
+ Without this parameter, you must have site collection admin permissions for the requested site.
34
+
35
+ In `--asAdmin` mode, the Id, PrincipalType, and PrincipalTypeString properties are not exported.
36
+
37
+ :::
38
+
39
+ ## Examples
40
+
41
+ Lists all admins of a SharePoint site
42
+
43
+ ```sh
44
+ m365 spo site admin list --siteUrl https://contoso.sharepoint.com
45
+ ```
46
+
47
+ Lists all admins of a SharePoint site as admin
48
+
49
+ ```sh
50
+ m365 spo site admin list --siteUrl https://contoso.sharepoint.com --asAdmin
51
+ ```
52
+
53
+ ## Response
54
+
55
+ <Tabs>
56
+ <TabItem value="JSON">
57
+
58
+ ```json
59
+ [
60
+ {
61
+ "Id": 6,
62
+ "LoginName": "i:0#.f|membership|user@contoso.com",
63
+ "Title": "User Example",
64
+ "PrincipalType": 1,
65
+ "PrincipalTypeString": "User",
66
+ "Email": "user@contoso.com",
67
+ "IsPrimaryAdmin": true
68
+ }
69
+ ]
70
+ ```
71
+
72
+ </TabItem>
73
+ <TabItem value="Text">
74
+
75
+ ```text
76
+ Email : user@contoso.com
77
+ Id : 6
78
+ LoginName : i:0#.f|membership|user@contoso.com
79
+ PrincipalType : 1
80
+ PrincipalTypeString : User
81
+ Title : User Example
82
+ IsPrimaryAdmin : true
83
+ ```
84
+
85
+ </TabItem>
86
+ <TabItem value="CSV">
87
+
88
+ ```csv
89
+ Id,LoginName,Title,PrincipalType,PrincipalTypeString,Email,IsPrimaryAdmin
90
+ 6,i:0#.f|membership|user@contoso.com,User Example,1,User,user@contoso.com,1
91
+ ```
92
+
93
+ </TabItem>
94
+ <TabItem value="Markdown">
95
+
96
+ ```md
97
+ # spo site admin list --siteUrl "https://contoso.sharepoint.com/sites/Test"
98
+
99
+ Date: 20/03/2024
100
+
101
+ ## User
102
+
103
+ Property | Value
104
+ ---------|-------
105
+ Id | 6
106
+ LoginName | i:0#.f\|membership\|user@contoso.com
107
+ Title | User Example
108
+ PrincipalType | 1
109
+ PrincipalTypeString | User
110
+ Email | user@contoso.com
111
+ IsPrimaryAdmin | true
112
+ ```
113
+
114
+ </TabItem>
115
+ </Tabs>
@@ -0,0 +1,63 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+ import Tabs from '@theme/Tabs';
3
+ import TabItem from '@theme/TabItem';
4
+
5
+ # spo tenant site archive
6
+
7
+ Archives a site collection
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 spo tenant site archive [options]
13
+ ```
14
+
15
+ ## Options
16
+
17
+ ```md definition-list
18
+ `-u, --url <url>`
19
+ : URL of the site collection.
20
+
21
+ `-f, --force`
22
+ : Don't prompt for confirmation.
23
+ ```
24
+
25
+ <Global />
26
+
27
+ ## Remarks
28
+
29
+ :::info
30
+
31
+ To use this command, you must be a Global or SharePoint administrator.
32
+
33
+ :::
34
+
35
+ :::note
36
+
37
+ After running this command, it may take a few minutes for the site to be fully archived.
38
+
39
+ :::
40
+
41
+
42
+ ## Examples
43
+
44
+ Archive a specific SharePoint site collection
45
+
46
+ ```sh
47
+ m365 spo tenant site archive --url "https://contoso.sharepoint.com/sites/Marketing"
48
+ ```
49
+
50
+ Archive a specific SharePoint site collection without confirmation prompt
51
+
52
+ ```sh
53
+ m365 spo tenant site archive --url "https://contoso.sharepoint.com/sites/Marketing" --force
54
+ ```
55
+
56
+ ## Response
57
+
58
+ The command won't return a response on success.
59
+
60
+ ## More information
61
+
62
+ - Pricing model for Microsoft 365 Archive: [https://learn.microsoft.com/microsoft-365/archive/archive-pricing](https://learn.microsoft.com/microsoft-365/archive/archive-pricing)
63
+ - Set up Microsoft 365 Archive: [https://learn.microsoft.com/microsoft-365/archive/archive-setup](https://learn.microsoft.com/microsoft-365/archive/archive-setup)