@pnp/cli-microsoft365 9.0.0-beta.2f8dd1e → 9.0.0-beta.33615bd

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 (118) hide show
  1. package/.eslintrc.cjs +1 -0
  2. package/allCommands.json +1 -1
  3. package/allCommandsFull.json +1 -1
  4. package/dist/Auth.js +10 -18
  5. package/dist/Command.js +49 -2
  6. package/dist/chili/chili.js +0 -23
  7. package/dist/cli/cli.js +61 -101
  8. package/dist/m365/app/commands/permission/permission-add.js +9 -9
  9. package/dist/m365/commands/login.js +44 -96
  10. package/dist/m365/commands/setup.js +0 -4
  11. package/dist/m365/connection/commands/connection-remove.js +6 -2
  12. package/dist/m365/connection/commands/connection-set.js +4 -1
  13. package/dist/m365/connection/commands/connection-use.js +25 -4
  14. package/dist/m365/entra/commands/group/group-user-list.js +4 -4
  15. package/dist/m365/entra/commands/m365group/m365group-conversation-post-list.js +4 -4
  16. package/dist/m365/entra/commands/m365group/m365group-recyclebinitem-list.js +3 -3
  17. package/dist/m365/entra/commands/m365group/m365group-set.js +66 -29
  18. package/dist/m365/entra/commands/m365group/m365group-user-list.js +6 -9
  19. package/dist/m365/entra/commands/multitenant/MultitenantOrganization.js +2 -0
  20. package/dist/m365/entra/commands/multitenant/multitenant-add.js +65 -0
  21. package/dist/m365/entra/commands/multitenant/multitenant-get.js +32 -0
  22. package/dist/m365/entra/commands/multitenant/multitenant-remove.js +118 -0
  23. package/dist/m365/entra/commands/multitenant/multitenant-set.js +72 -0
  24. package/dist/m365/entra/commands.js +4 -0
  25. package/dist/m365/external/commands/connection/connection-doctor.js +10 -24
  26. package/dist/m365/flow/commands/flow-list.js +23 -24
  27. package/dist/m365/graph/commands/subscription/subscription-add.js +4 -2
  28. package/dist/m365/outlook/commands/message/message-get.js +11 -11
  29. package/dist/m365/spe/ContainerTypeProperties.js +2 -0
  30. package/dist/m365/spe/commands/containertype/containertype-list.js +49 -0
  31. package/dist/m365/spe/commands.js +2 -1
  32. package/dist/m365/spfx/commands/project/base-project-command.js +36 -126
  33. package/dist/m365/spo/commands/applicationcustomizer/applicationcustomizer-get.js +16 -21
  34. package/dist/m365/spo/commands/cdn/cdn-get.js +12 -15
  35. package/dist/m365/spo/commands/cdn/cdn-set.js +6 -4
  36. package/dist/m365/spo/commands/commandset/commandset-get.js +31 -17
  37. package/dist/m365/spo/commands/contenttype/contenttype-field-list.js +124 -0
  38. package/dist/m365/spo/commands/field/field-list.js +1 -1
  39. package/dist/m365/spo/commands/file/file-roleassignment-add.js +1 -1
  40. package/dist/m365/spo/commands/file/file-roleinheritance-break.js +1 -1
  41. package/dist/m365/spo/commands/file/file-roleinheritance-reset.js +1 -1
  42. package/dist/m365/spo/commands/folder/folder-retentionlabel-ensure.js +1 -1
  43. package/dist/m365/spo/commands/group/group-member-add.js +103 -99
  44. package/dist/m365/spo/commands/list/list-list.js +1 -4
  45. package/dist/m365/spo/commands/list/list-roleassignment-add.js +46 -21
  46. package/dist/m365/spo/commands/list/list-roleassignment-remove.js +48 -46
  47. package/dist/m365/spo/commands/page/page-clientsidewebpart-add.js +2 -3
  48. package/dist/m365/spo/commands/page/page-text-add.js +2 -3
  49. package/dist/m365/spo/commands/site/site-appcatalog-remove.js +48 -24
  50. package/dist/m365/spo/commands/spo-search.js +3 -4
  51. package/dist/m365/spo/commands/tenant/tenant-applicationcustomizer-get.js +19 -5
  52. package/dist/m365/spo/commands/tenant/tenant-commandset-get.js +20 -6
  53. package/dist/m365/spo/commands/tenant/tenant-recyclebinitem-restore.js +2 -22
  54. package/dist/m365/spo/commands.js +1 -0
  55. package/dist/m365/teams/commands/meeting/meeting-attendancereport-get.js +119 -0
  56. package/dist/m365/teams/commands/message/message-remove.js +112 -0
  57. package/dist/m365/teams/commands.js +2 -0
  58. package/dist/m365/viva/commands/engage/engage-community-add.js +166 -0
  59. package/dist/m365/viva/commands.js +1 -0
  60. package/dist/utils/formatting.js +30 -1
  61. package/dist/utils/spo.js +37 -6
  62. package/dist/utils/teams.js +49 -0
  63. package/dist/utils/validation.js +19 -0
  64. package/dist/utils/zod.js +124 -0
  65. package/docs/docs/cmd/app/permission/permission-add.mdx +5 -5
  66. package/docs/docs/cmd/connection/connection-use.mdx +8 -2
  67. package/docs/docs/cmd/entra/group/group-user-list.mdx +7 -7
  68. package/docs/docs/cmd/entra/m365group/m365group-conversation-post-list.mdx +5 -5
  69. package/docs/docs/cmd/entra/m365group/m365group-recyclebinitem-list.mdx +3 -3
  70. package/docs/docs/cmd/entra/m365group/m365group-set.mdx +37 -7
  71. package/docs/docs/cmd/entra/m365group/m365group-user-list.mdx +1 -1
  72. package/docs/docs/cmd/entra/multitenant/multitenant-add.mdx +107 -0
  73. package/docs/docs/cmd/entra/multitenant/multitenant-get.mdx +94 -0
  74. package/docs/docs/cmd/entra/multitenant/multitenant-remove.mdx +58 -0
  75. package/docs/docs/cmd/entra/multitenant/multitenant-set.mdx +53 -0
  76. package/docs/docs/cmd/external/connection/connection-doctor.mdx +9 -9
  77. package/docs/docs/cmd/flow/flow-list.mdx +114 -56
  78. package/docs/docs/cmd/graph/subscription/subscription-add.mdx +18 -0
  79. package/docs/docs/cmd/outlook/message/message-get.mdx +5 -5
  80. package/docs/docs/cmd/planner/plan/plan-remove.mdx +1 -1
  81. package/docs/docs/cmd/spe/containertype/containertype-list.mdx +102 -0
  82. package/docs/docs/cmd/spo/applicationcustomizer/applicationcustomizer-get.mdx +87 -38
  83. package/docs/docs/cmd/spo/applicationcustomizer/applicationcustomizer-list.mdx +22 -28
  84. package/docs/docs/cmd/spo/cdn/cdn-set.mdx +3 -3
  85. package/docs/docs/cmd/spo/commandset/commandset-get.mdx +75 -24
  86. package/docs/docs/cmd/spo/commandset/commandset-list.mdx +26 -32
  87. package/docs/docs/cmd/spo/contenttype/contenttype-field-list.mdx +172 -0
  88. package/docs/docs/cmd/spo/contenttype/contenttype-list.mdx +3 -3
  89. package/docs/docs/cmd/spo/field/field-list.mdx +3 -3
  90. package/docs/docs/cmd/spo/file/file-retentionlabel-ensure.mdx +1 -1
  91. package/docs/docs/cmd/spo/file/file-roleassignment-add.mdx +2 -2
  92. package/docs/docs/cmd/spo/file/file-roleassignment-remove.mdx +1 -1
  93. package/docs/docs/cmd/spo/file/file-roleinheritance-break.mdx +1 -1
  94. package/docs/docs/cmd/spo/file/file-roleinheritance-reset.mdx +1 -1
  95. package/docs/docs/cmd/spo/folder/folder-retentionlabel-ensure.mdx +2 -2
  96. package/docs/docs/cmd/spo/group/group-member-add.mdx +34 -27
  97. package/docs/docs/cmd/spo/list/list-list.mdx +5 -7
  98. package/docs/docs/cmd/spo/list/list-roleassignment-add.mdx +15 -3
  99. package/docs/docs/cmd/spo/list/list-roleassignment-remove.mdx +15 -3
  100. package/docs/docs/cmd/spo/listitem/listitem-retentionlabel-ensure.mdx +4 -4
  101. package/docs/docs/cmd/spo/listitem/listitem-retentionlabel-remove.mdx +1 -1
  102. package/docs/docs/cmd/spo/listitem/listitem-roleassignment-add.mdx +9 -9
  103. package/docs/docs/cmd/spo/listitem/listitem-roleassignment-remove.mdx +7 -7
  104. package/docs/docs/cmd/spo/site/site-appcatalog-remove.mdx +11 -2
  105. package/docs/docs/cmd/spo/site/site-recyclebinitem-list.mdx +1 -1
  106. package/docs/docs/cmd/spo/tenant/tenant-applicationcustomizer-get.mdx +79 -30
  107. package/docs/docs/cmd/spo/tenant/tenant-applicationcustomizer-list.mdx +20 -19
  108. package/docs/docs/cmd/spo/tenant/tenant-commandset-get.mdx +84 -38
  109. package/docs/docs/cmd/spo/tenant/tenant-commandset-list.mdx +20 -19
  110. package/docs/docs/cmd/spo/tenant/tenant-recyclebinitem-restore.mdx +2 -49
  111. package/docs/docs/cmd/spo/web/web-roleassignment-add.mdx +1 -1
  112. package/docs/docs/cmd/spo/web/web-roleassignment-remove.mdx +1 -1
  113. package/docs/docs/cmd/teams/meeting/meeting-attendancereport-get.mdx +138 -0
  114. package/docs/docs/cmd/teams/meeting/meeting-list.mdx +7 -3
  115. package/docs/docs/cmd/teams/message/message-remove.mdx +63 -0
  116. package/docs/docs/cmd/viva/engage/engage-community-add.mdx +168 -0
  117. package/npm-shrinkwrap.json +588 -1022
  118. package/package.json +7 -3
@@ -110,17 +110,21 @@ m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --
110
110
  ```json
111
111
  [
112
112
  {
113
- "AllowedRoles": [
114
- 0
115
- ],
116
- "CurrentRole": 0,
117
- "DisplayName": "John Doe",
118
- "Email": "john.doe@contoso.onmicrosoft.com",
119
- "InvitationLink": null,
120
- "IsUserKnown": true,
121
- "Message": null,
122
- "Status": true,
123
- "User": "i:0#.f|membership|john.doe@contoso.onmicrosoft.com"
113
+ "Id": 11,
114
+ "IsHiddenInUI": false,
115
+ "LoginName": "i:0#.f|membership|adelev@contoso.onmicrosoft.com",
116
+ "Title": "Adele Vance",
117
+ "PrincipalType": 1,
118
+ "Email": "Adele.Vance@contoso.onmicrosoft.com",
119
+ "Expiration": "",
120
+ "IsEmailAuthenticationGuestUser": false,
121
+ "IsShareByEmailGuestUser": false,
122
+ "IsSiteAdmin": false,
123
+ "UserId": {
124
+ "NameId": "10032001f5ac2029",
125
+ "NameIdIssuer": "urn:federation:microsoftonline"
126
+ },
127
+ "UserPrincipalName": "adelev@contoso.onmicrosoft.com"
124
128
  }
125
129
  ]
126
130
  ```
@@ -129,39 +133,42 @@ m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --
129
133
  <TabItem value="Text">
130
134
 
131
135
  ```text
132
- DisplayName Email
133
- ----------- ---------------------------------
134
- John Doe john.doe@contoso.onmicrosoft.com
136
+ Title UserPrincipalName
137
+ ----------- -------------------------------------
138
+ Adele Vance Adele.Vance@contoso.onmicrosoft.com
135
139
  ```
136
140
 
137
141
  </TabItem>
138
142
  <TabItem value="CSV">
139
143
 
140
144
  ```csv
141
- DisplayName,Email
142
- John Doe,john.doe@contoso.onmicrosoft.com
145
+ Id,IsHiddenInUI,LoginName,Title,PrincipalType,Email,Expiration,IsEmailAuthenticationGuestUser,IsShareByEmailGuestUser,IsSiteAdmin,UserPrincipalName
146
+ 11,,i:0#.f|membership|adelev@contoso.onmicrosoft.com,Adele Vance,1,Adele.Vance@contoso.onmicrosoft.com,,,,,adelev@contoso.onmicrosoft.com
143
147
  ```
144
148
 
145
149
  </TabItem>
146
150
  <TabItem value="Markdown">
147
151
 
148
152
  ```md
149
- # spo group member add --webUrl "https://contoso.sharepoint.com" --groupId "5" --aadGroupIds "f2fb2f10-cfd2-4054-8ffd-64533657a5ab"
153
+ # spo group member add --webUrl "https://contoso.sharepoint.com/sites/Marketing" --groupId "5" --userNames "AdeleV@contoso.onmicrosoft.com"
150
154
 
151
- Date: 13/2/2023
155
+ Date: 10/07/2024
152
156
 
153
- ## All Company Members
157
+ ## Adele Vance (11)
154
158
 
155
159
  Property | Value
156
160
  ---------|-------
157
- CurrentRole | 0
158
- DisplayName | All Company Members
159
- Email | allcompany@contoso.onmicrosoft.com
160
- InvitationLink | null
161
- IsUserKnown | true
162
- Message | null
163
- Status | true
164
- User | c:0o.c\|federateddirectoryclaimprovider\|f2fb2f10-cfd2-4054-8ffd-64533657a5ab
161
+ Id | 11
162
+ IsHiddenInUI | false
163
+ LoginName | i:0#.f\|membership\|adelev@contoso.onmicrosoft.com
164
+ Title | Adele Vance
165
+ PrincipalType | 1
166
+ Email | Adele.Vance@contoso.onmicrosoft.com
167
+ Expiration |
168
+ IsEmailAuthenticationGuestUser | false
169
+ IsShareByEmailGuestUser | false
170
+ IsSiteAdmin | false
171
+ UserPrincipalName | adelev@contoso.onmicrosoft.com
165
172
  ```
166
173
 
167
174
  </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
@@ -23,6 +23,9 @@ m365 spo tenant applicationcustomizer get [options]
23
23
 
24
24
  `-c, --clientSideComponentId [clientSideComponentId]`
25
25
  : The Client Side Component Id (GUID) of the application customizer. Specify either `title`, `id`, or `clientSideComponentId`.
26
+
27
+ `-p, --tenantWideExtensionComponentProperties`
28
+ : Only output the tenant wide extension component properties.
26
29
  ```
27
30
 
28
31
  <Global />
@@ -53,26 +56,29 @@ This command can be used for retrieving an application customizer that's install
53
56
 
54
57
  ## Response
55
58
 
59
+ ### Standard response
60
+
56
61
  <Tabs>
57
62
  <TabItem value="JSON">
58
63
 
59
64
  ```json
60
65
  {
61
66
  "FileSystemObjectType": 0,
62
- "Id": 4,
67
+ "Id": 2,
63
68
  "ServerRedirectedEmbedUri": null,
64
69
  "ServerRedirectedEmbedUrl": "",
65
- "ContentTypeId": "0x00693E2C487575B448BD420C12CEAE7EFE",
66
- "Title": "Some customizer",
67
- "Modified": "2023-01-11T15:47:38Z",
68
- "Created": "2023-01-11T15:47:38Z",
70
+ "ContentTypeId": "0x00DBF24546DE6018449BB43573F3581BF0",
71
+ "Title": "HelloWorld",
72
+ "Modified": "2024-05-16T21:59:09Z",
73
+ "Created": "2024-05-16T21:59:09Z",
69
74
  "AuthorId": 9,
70
75
  "EditorId": 9,
71
76
  "OData__UIVersionString": "1.0",
72
77
  "Attachments": false,
73
- "GUID": "14125658-a9bc-4ddf-9c75-1b5767c9a337",
78
+ "GUID": "dfc6a646-742b-4d9d-9fcf-892a972298ff",
79
+ "OData__ColorTag": null,
74
80
  "ComplianceAssetId": null,
75
- "TenantWideExtensionComponentId": "7096cded-b83d-4eab-96f0-df477ed7c0bc",
81
+ "TenantWideExtensionComponentId": "9a8b100c-246b-4592-9454-67826523e159",
76
82
  "TenantWideExtensionComponentProperties": "{\"testMessage\":\"Test message\"}",
77
83
  "TenantWideExtensionWebTemplate": null,
78
84
  "TenantWideExtensionListTemplate": 0,
@@ -90,17 +96,18 @@ This command can be used for retrieving an application customizer that's install
90
96
  Attachments : false
91
97
  AuthorId : 9
92
98
  ComplianceAssetId : null
93
- ContentTypeId : 0x00693E2C487575B448BD420C12CEAE7EFE
94
- Created : 2023-01-11T15:47:38Z
99
+ ContentTypeId : 0x00DBF24546DE6018449BB43573F3581BF0
100
+ Created : 2024-05-16T21:59:09Z
95
101
  EditorId : 9
96
102
  FileSystemObjectType : 0
97
- GUID : 14125658-a9bc-4ddf-9c75-1b5767c9a337
98
- Id : 4
99
- Modified : 2023-01-11T15:47:38Z
103
+ GUID : dfc6a646-742b-4d9d-9fcf-892a972298ff
104
+ Id : 2
105
+ Modified : 2024-05-16T21:59:09Z
106
+ OData__ColorTag : null
100
107
  OData__UIVersionString : 1.0
101
108
  ServerRedirectedEmbedUri : null
102
109
  ServerRedirectedEmbedUrl :
103
- TenantWideExtensionComponentId : 7096cded-b83d-4eab-96f0-df477ed7c0bc
110
+ TenantWideExtensionComponentId : 9a8b100c-246b-4592-9454-67826523e159
104
111
  TenantWideExtensionComponentProperties: {"testMessage":"Test message"}
105
112
  TenantWideExtensionDisabled : false
106
113
  TenantWideExtensionHostProperties : null
@@ -108,51 +115,93 @@ This command can be used for retrieving an application customizer that's install
108
115
  TenantWideExtensionLocation : ClientSideExtension.ApplicationCustomizer
109
116
  TenantWideExtensionSequence : 0
110
117
  TenantWideExtensionWebTemplate : null
111
- Title : Some customizer
118
+ Title : HelloWorld
112
119
  ```
113
120
 
114
121
  </TabItem>
115
122
  <TabItem value="CSV">
116
123
 
117
124
  ```csv
118
- FileSystemObjectType,Id,ServerRedirectedEmbedUri,ServerRedirectedEmbedUrl,ContentTypeId,Title,Modified,Created,AuthorId,EditorId,OData__UIVersionString,Attachments,GUID,ComplianceAssetId,TenantWideExtensionComponentId,TenantWideExtensionComponentProperties,TenantWideExtensionWebTemplate,TenantWideExtensionListTemplate,TenantWideExtensionLocation,TenantWideExtensionSequence,TenantWideExtensionHostProperties,TenantWideExtensionDisabled
119
- 0,4,,,0x00693E2C487575B448BD420C12CEAE7EFE,Some customizer,2023-01-11T15:47:38Z,2023-01-11T15:47:38Z,9,9,1.0,,14125658-a9bc-4ddf-9c75-1b5767c9a337,,7096cded-b83d-4eab-96f0-df477ed7c0bc,"{""testMessage"":""Test message""}",,0,ClientSideExtension.ApplicationCustomizer,0,,
125
+ FileSystemObjectType,Id,ServerRedirectedEmbedUri,ServerRedirectedEmbedUrl,ContentTypeId,Title,Modified,Created,AuthorId,EditorId,OData__UIVersionString,Attachments,GUID,OData__ColorTag,ComplianceAssetId,TenantWideExtensionComponentId,TenantWideExtensionComponentProperties,TenantWideExtensionWebTemplate,TenantWideExtensionListTemplate,TenantWideExtensionLocation,TenantWideExtensionSequence,TenantWideExtensionHostProperties,TenantWideExtensionDisabled
126
+ 0,2,,,0x00DBF24546DE6018449BB43573F3581BF0,HelloWorld,2024-05-16T21:59:09Z,2024-05-16T21:59:09Z,9,9,1.0,,dfc6a646-742b-4d9d-9fcf-892a972298ff,,,9a8b100c-246b-4592-9454-67826523e159,"{""testMessage"":""Test message""}",,0,ClientSideExtension.ApplicationCustomizer,0,,
120
127
  ```
121
128
 
122
129
  </TabItem>
123
130
  <TabItem value="Markdown">
124
131
 
125
132
  ```md
126
- # spo tenant applicationcustomizer get --title "Some customizer"
133
+ # spo tenant applicationcustomizer get --id "2"
127
134
 
128
- Date: 1/13/2023
135
+ Date: 17/05/2024
129
136
 
130
- ## Some customizer (4)
137
+ ## HelloWorld (2)
131
138
 
132
139
  Property | Value
133
140
  ---------|-------
134
141
  FileSystemObjectType | 0
135
- Id | 4
136
- ServerRedirectedEmbedUri | null
142
+ Id | 2
137
143
  ServerRedirectedEmbedUrl |
138
- ContentTypeId | 0x00693E2C487575B448BD420C12CEAE7EFE
139
- Title | Some customizer
140
- Modified | 2023-01-11T15:47:38Z
141
- Created | 2023-01-11T15:47:38Z
144
+ ContentTypeId | 0x00DBF24546DE6018449BB43573F3581BF0
145
+ Title | HelloWorld
146
+ Modified | 2024-05-16T21:59:09Z
147
+ Created | 2024-05-16T21:59:09Z
142
148
  AuthorId | 9
143
149
  EditorId | 9
144
150
  OData\_\_UIVersionString | 1.0
145
151
  Attachments | false
146
- GUID | 14125658-a9bc-4ddf-9c75-1b5767c9a337
147
- ComplianceAssetId | null
148
- TenantWideExtensionComponentId | 7096cded-b83d-4eab-96f0-df477ed7c0bc
149
- TenantWideExtensionWebTemplate | null
152
+ GUID | dfc6a646-742b-4d9d-9fcf-892a972298ff
153
+ TenantWideExtensionComponentId | 9a8b100c-246b-4592-9454-67826523e159
154
+ TenantWideExtensionComponentProperties | {"testMessage":"Test message"}
150
155
  TenantWideExtensionListTemplate | 0
151
156
  TenantWideExtensionLocation | ClientSideExtension.ApplicationCustomizer
152
157
  TenantWideExtensionSequence | 0
153
- TenantWideExtensionHostProperties | null
154
158
  TenantWideExtensionDisabled | false
155
159
  ```
156
160
 
157
161
  </TabItem>
158
162
  </Tabs>
163
+
164
+ ### `tenantWideExtensionComponentProperties` response
165
+
166
+ <Tabs>
167
+ <TabItem value="JSON">
168
+
169
+ ```json
170
+ {
171
+ "sampleTextOne": "One item is selected in the list.",
172
+ "sampleTextTwo": "This command is always visible."
173
+ }
174
+ ```
175
+
176
+ </TabItem>
177
+ <TabItem value="Text">
178
+
179
+ ```txt
180
+ sampleTextOne: One item is selected in the list.
181
+ sampleTextTwo: This command is always visible.
182
+ ```
183
+
184
+ </TabItem>
185
+ <TabItem value="CSV">
186
+
187
+ ```csv
188
+ sampleTextOne,sampleTextTwo
189
+ One item is selected in the list.,This command is always visible.
190
+ ```
191
+
192
+ </TabItem>
193
+ <TabItem value="Markdown">
194
+
195
+ ```md
196
+ # spo tenant commandset get --id "1" --tenantWideExtensionComponentProperties "true"
197
+
198
+ Date: 16/05/2024
199
+
200
+ Property | Value
201
+ ---------|-------
202
+ sampleTextOne | One item is selected in the list.
203
+ sampleTextTwo | This command is always visible.
204
+ ```
205
+
206
+ </TabItem>
207
+ </Tabs>