@pnp/cli-microsoft365 9.0.0-beta.62575a1 → 9.0.0-beta.e16d09c

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 (61) hide show
  1. package/allCommands.json +1 -1
  2. package/allCommandsFull.json +1 -1
  3. package/dist/Auth.js +9 -9
  4. package/dist/Command.js +49 -2
  5. package/dist/cli/cli.js +60 -38
  6. package/dist/m365/commands/login.js +44 -96
  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/multitenant/multitenant-add.js +65 -0
  11. package/dist/m365/entra/commands/multitenant/multitenant-remove.js +118 -0
  12. package/dist/m365/entra/commands/multitenant/multitenant-set.js +72 -0
  13. package/dist/m365/entra/commands.js +3 -0
  14. package/dist/m365/spe/ContainerTypeProperties.js +2 -0
  15. package/dist/m365/spe/commands/containertype/containertype-list.js +49 -0
  16. package/dist/m365/spe/commands.js +2 -1
  17. package/dist/m365/spo/commands/applicationcustomizer/applicationcustomizer-get.js +16 -21
  18. package/dist/m365/spo/commands/commandset/commandset-get.js +31 -17
  19. package/dist/m365/spo/commands/file/file-roleassignment-add.js +1 -1
  20. package/dist/m365/spo/commands/file/file-roleinheritance-break.js +1 -1
  21. package/dist/m365/spo/commands/file/file-roleinheritance-reset.js +1 -1
  22. package/dist/m365/spo/commands/folder/folder-retentionlabel-ensure.js +1 -1
  23. package/dist/m365/spo/commands/list/list-roleassignment-add.js +46 -21
  24. package/dist/m365/spo/commands/list/list-roleassignment-remove.js +48 -46
  25. package/dist/m365/spo/commands/tenant/tenant-applicationcustomizer-get.js +19 -5
  26. package/dist/m365/spo/commands/tenant/tenant-commandset-get.js +20 -6
  27. package/dist/utils/formatting.js +16 -0
  28. package/dist/utils/spo.js +37 -6
  29. package/dist/utils/zod.js +124 -0
  30. package/docs/docs/cmd/connection/connection-use.mdx +8 -2
  31. package/docs/docs/cmd/entra/multitenant/multitenant-add.mdx +107 -0
  32. package/docs/docs/cmd/entra/multitenant/multitenant-remove.mdx +58 -0
  33. package/docs/docs/cmd/entra/multitenant/multitenant-set.mdx +53 -0
  34. package/docs/docs/cmd/planner/plan/plan-remove.mdx +1 -1
  35. package/docs/docs/cmd/spe/containertype/containertype-list.mdx +102 -0
  36. package/docs/docs/cmd/spo/applicationcustomizer/applicationcustomizer-get.mdx +87 -38
  37. package/docs/docs/cmd/spo/applicationcustomizer/applicationcustomizer-list.mdx +22 -28
  38. package/docs/docs/cmd/spo/commandset/commandset-get.mdx +75 -24
  39. package/docs/docs/cmd/spo/commandset/commandset-list.mdx +26 -32
  40. package/docs/docs/cmd/spo/file/file-retentionlabel-ensure.mdx +1 -1
  41. package/docs/docs/cmd/spo/file/file-roleassignment-add.mdx +2 -2
  42. package/docs/docs/cmd/spo/file/file-roleassignment-remove.mdx +1 -1
  43. package/docs/docs/cmd/spo/file/file-roleinheritance-break.mdx +1 -1
  44. package/docs/docs/cmd/spo/file/file-roleinheritance-reset.mdx +1 -1
  45. package/docs/docs/cmd/spo/folder/folder-retentionlabel-ensure.mdx +2 -2
  46. package/docs/docs/cmd/spo/list/list-roleassignment-add.mdx +15 -3
  47. package/docs/docs/cmd/spo/list/list-roleassignment-remove.mdx +15 -3
  48. package/docs/docs/cmd/spo/listitem/listitem-retentionlabel-ensure.mdx +4 -4
  49. package/docs/docs/cmd/spo/listitem/listitem-retentionlabel-remove.mdx +1 -1
  50. package/docs/docs/cmd/spo/listitem/listitem-roleassignment-add.mdx +9 -9
  51. package/docs/docs/cmd/spo/listitem/listitem-roleassignment-remove.mdx +7 -7
  52. package/docs/docs/cmd/spo/site/site-recyclebinitem-list.mdx +1 -1
  53. package/docs/docs/cmd/spo/tenant/tenant-applicationcustomizer-get.mdx +79 -30
  54. package/docs/docs/cmd/spo/tenant/tenant-applicationcustomizer-list.mdx +20 -19
  55. package/docs/docs/cmd/spo/tenant/tenant-commandset-get.mdx +84 -38
  56. package/docs/docs/cmd/spo/tenant/tenant-commandset-list.mdx +20 -19
  57. package/docs/docs/cmd/spo/web/web-roleassignment-add.mdx +1 -1
  58. package/docs/docs/cmd/spo/web/web-roleassignment-remove.mdx +1 -1
  59. package/docs/docs/cmd/teams/meeting/meeting-list.mdx +7 -3
  60. package/npm-shrinkwrap.json +604 -843
  61. package/package.json +6 -2
@@ -24,6 +24,10 @@ m365 spo applicationcustomizer list [options]
24
24
 
25
25
  <Global />
26
26
 
27
+ ## Remarks
28
+
29
+ This command can be used for retrieving a list of application customizers from a specific site. To retrieve a list of application customizers that are installed tenant-wide, view our dedicated [spo tenant applicationcustomizer list](../tenant/tenant-applicationcustomizer-list.mdx) command.
30
+
27
31
  ## Examples
28
32
 
29
33
  Retrieves a list of application customizers.
@@ -32,10 +36,6 @@ Retrieves a list of application customizers.
32
36
  m365 spo applicationcustomizer list --webUrl https://contoso.sharepoint.com/sites/sales
33
37
  ```
34
38
 
35
- ## Remarks
36
-
37
- This command can be used for retrieving a list of application customizers from a specific site. To retrieve a list of application customizers that are installed tenant-wide, view our dedicated [spo tenant applicationcustomizer list](../tenant/tenant-applicationcustomizer-list.mdx) command.
38
-
39
39
  ## Response
40
40
 
41
41
  <Tabs>
@@ -44,16 +44,16 @@ This command can be used for retrieving a list of application customizers from a
44
44
  ```json
45
45
  [
46
46
  {
47
- "ClientSideComponentId": "4358e70e-ec3c-4713-beb6-39c88f7621d1",
48
- "ClientSideComponentProperties": "{\"listTitle\":\"News\",\"listViewTitle\":\"Published News\"}",
47
+ "ClientSideComponentId": "9a8b100c-246b-4592-9454-67826523e159",
48
+ "ClientSideComponentProperties": "{\"testMessage\":\"Test message\"}",
49
49
  "CommandUIExtension": null,
50
50
  "Description": null,
51
51
  "Group": null,
52
52
  "HostProperties": "",
53
- "Id": "f405303c-6048-4636-9660-1b7b2cadaef9",
53
+ "Id": "4a428b32-08cf-45c7-9986-17585af38806",
54
54
  "ImageUrl": null,
55
55
  "Location": "ClientSideExtension.ApplicationCustomizer",
56
- "Name": "{f405303c-6048-4636-9660-1b7b2cadaef9}",
56
+ "Name": "{4a428b32-08cf-45c7-9986-17585af38806}",
57
57
  "RegistrationId": null,
58
58
  "RegistrationType": 0,
59
59
  "Rights": {
@@ -64,7 +64,7 @@ This command can be used for retrieving a list of application customizers from a
64
64
  "ScriptBlock": null,
65
65
  "ScriptSrc": null,
66
66
  "Sequence": 65536,
67
- "Title": "NewsTicker",
67
+ "Title": "HelloWorld",
68
68
  "Url": null,
69
69
  "VersionOfUserCustomAction": "1.0.1.0"
70
70
  }
@@ -75,47 +75,41 @@ This command can be used for retrieving a list of application customizers from a
75
75
  <TabItem value="Text">
76
76
 
77
77
  ```text
78
- Name Location Scope Id
79
- -------------------------------------- ----------------------------------------- ----- ------------------------------------
80
- {f405303c-6048-4636-9660-1b7b2cadaef9} ClientSideExtension.ApplicationCustomizer 3 f405303c-6048-4636-9660-1b7b2cadaef9
78
+ Id Location Name Scope
79
+ ------------------------------------ ----------------------------------------- -------------------------------------- -----
80
+ 4a428b32-08cf-45c7-9986-17585af38806 ClientSideExtension.ApplicationCustomizer {4a428b32-08cf-45c7-9986-17585af38806} 3
81
81
  ```
82
82
 
83
83
  </TabItem>
84
84
  <TabItem value="CSV">
85
85
 
86
86
  ```csv
87
- Name,Location,Scope,Id
88
- {f405303c-6048-4636-9660-1b7b2cadaef9},ClientSideExtension.ApplicationCustomizer,3,f405303c-6048-4636-9660-1b7b2cadaef9
87
+ ClientSideComponentId,ClientSideComponentProperties,CommandUIExtension,Description,Group,HostProperties,Id,ImageUrl,Location,Name,RegistrationId,RegistrationType,Scope,ScriptBlock,ScriptSrc,Sequence,Title,Url,VersionOfUserCustomAction
88
+ 9a8b100c-246b-4592-9454-67826523e159,"{""testMessage"":""Test message""}",,,,,4a428b32-08cf-45c7-9986-17585af38806,,ClientSideExtension.ApplicationCustomizer,{4a428b32-08cf-45c7-9986-17585af38806},,0,3,,,65536,HelloWorld,,1.0.1.0
89
89
  ```
90
90
 
91
91
  </TabItem>
92
92
  <TabItem value="Markdown">
93
93
 
94
94
  ```md
95
- # spo applicationcustomizer list --webUrl "https://contoso.sharepoint.com"
95
+ # spo applicationcustomizer list --webUrl "https://contoso.sharepoint.com/sites/Marketing"
96
96
 
97
- Date: 28/2/2023
97
+ Date: 16/05/2024
98
98
 
99
- ## NewsTicker (f405303c-6048-4636-9660-1b7b2cadaef9)
99
+ ## HelloWorld (4a428b32-08cf-45c7-9986-17585af38806)
100
100
 
101
101
  Property | Value
102
102
  ---------|-------
103
- ClientSideComponentId | 4358e70e-ec3c-4713-beb6-39c88f7621d1
104
- CommandUIExtension | null
105
- Description | null
106
- Group | null
103
+ ClientSideComponentId | 9a8b100c-246b-4592-9454-67826523e159
104
+ ClientSideComponentProperties | {"testMessage":"Test message"}
107
105
  HostProperties |
108
- Id | f405303c-6048-4636-9660-1b7b2cadaef9
109
- ImageUrl | null
106
+ Id | 4a428b32-08cf-45c7-9986-17585af38806
110
107
  Location | ClientSideExtension.ApplicationCustomizer
111
- RegistrationId | null
108
+ Name | {4a428b32-08cf-45c7-9986-17585af38806}
112
109
  RegistrationType | 0
113
110
  Scope | 3
114
- ScriptBlock | null
115
- ScriptSrc | null
116
111
  Sequence | 65536
117
- Title | NewsTicker
118
- Url | null
112
+ Title | HelloWorld
119
113
  VersionOfUserCustomAction | 1.0.1.0
120
114
  ```
121
115
 
@@ -29,6 +29,9 @@ m365 spo commandset get [options]
29
29
 
30
30
  `-s, --scope [scope]`
31
31
  : Scope of the ListView Command Set. Allowed values: `Site`, `Web`, `All`. Defaults to `All`.
32
+
33
+ `-p, --clientSideComponentProperties`
34
+ : Only output the client-side component properties.
32
35
  ```
33
36
 
34
37
  <Global />
@@ -50,7 +53,7 @@ m365 spo commandset get --title "Some customizer" --webUrl https://contoso.share
50
53
  Retrieves a ListView Command Set by id with scope 'Web'.
51
54
 
52
55
  ```sh
53
- m365 spo commandset get --id 14125658-a9bc-4ddf-9c75-1b5767c9a337 --webUrl https://contoso.sharepoint.com/sites/sales -scope Web
56
+ m365 spo commandset get --id 14125658-a9bc-4ddf-9c75-1b5767c9a337 --webUrl https://contoso.sharepoint.com/sites/sales --scope Web
54
57
  ```
55
58
 
56
59
  Retrieves a ListView Command Set by clientSideComponentId with scope 'Site'.
@@ -59,23 +62,31 @@ Retrieves a ListView Command Set by clientSideComponentId with scope 'Site'.
59
62
  m365 spo commandset get --clientSideComponentId c1cbd896-5140-428d-8b0c-4873be19f5ac --webUrl https://contoso.sharepoint.com/sites/sales --scope Site
60
63
  ```
61
64
 
65
+ Retrieves the client-side component properties of a ListView Command Set.
66
+
67
+ ```sh
68
+ m365 spo commandset get --id 14125658-a9bc-4ddf-9c75-1b5767c9a337 --webUrl https://contoso.sharepoint.com/sites/sales --clientSideComponentProperties
69
+ ```
70
+
62
71
  ## Response
63
72
 
73
+ ### Standard response
74
+
64
75
  <Tabs>
65
76
  <TabItem value="JSON">
66
77
 
67
78
  ```json
68
79
  {
69
- "ClientSideComponentId": "c1cbd896-5140-428d-8b0c-4873be19f5ac",
80
+ "ClientSideComponentId": "53dd6a38-1461-44e0-9bf0-14883316a316",
70
81
  "ClientSideComponentProperties": "{\"sampleTextOne\":\"One item is selected in the list.\", \"sampleTextTwo\":\"This command is always visible.\"}",
71
82
  "CommandUIExtension": null,
72
83
  "Description": null,
73
84
  "Group": null,
74
85
  "HostProperties": "",
75
- "Id": "9a0674de-2f3d-4a26-ba79-62b460ddd327",
86
+ "Id": "bb26547d-c9b7-4ed1-b793-00cbe53388d6",
76
87
  "ImageUrl": null,
77
88
  "Location": "ClientSideExtension.ListViewCommandSet.CommandBar",
78
- "Name": "{9a0674de-2f3d-4a26-ba79-62b460ddd327}",
89
+ "Name": "{bb26547d-c9b7-4ed1-b793-00cbe53388d6}",
79
90
  "RegistrationId": "100",
80
91
  "RegistrationType": 1,
81
92
  "Rights": {
@@ -86,7 +97,7 @@ m365 spo commandset get --clientSideComponentId c1cbd896-5140-428d-8b0c-4873be19
86
97
  "ScriptBlock": null,
87
98
  "ScriptSrc": null,
88
99
  "Sequence": 65536,
89
- "Title": "Notification",
100
+ "Title": "HelloWorld",
90
101
  "Url": null,
91
102
  "VersionOfUserCustomAction": "1.0.1.0"
92
103
  }
@@ -96,16 +107,16 @@ m365 spo commandset get --clientSideComponentId c1cbd896-5140-428d-8b0c-4873be19
96
107
  <TabItem value="Text">
97
108
 
98
109
  ```text
99
- ClientSideComponentId : c1cbd896-5140-428d-8b0c-4873be19f5ac
110
+ ClientSideComponentId : 53dd6a38-1461-44e0-9bf0-14883316a316
100
111
  ClientSideComponentProperties: {"sampleTextOne":"One item is selected in the list.", "sampleTextTwo":"This command is always visible."}
101
112
  CommandUIExtension : null
102
113
  Description : null
103
114
  Group : null
104
115
  HostProperties :
105
- Id : 9a0674de-2f3d-4a26-ba79-62b460ddd327
116
+ Id : bb26547d-c9b7-4ed1-b793-00cbe53388d6
106
117
  ImageUrl : null
107
118
  Location : ClientSideExtension.ListViewCommandSet.CommandBar
108
- Name : {9a0674de-2f3d-4a26-ba79-62b460ddd327}
119
+ Name : {bb26547d-c9b7-4ed1-b793-00cbe53388d6}
109
120
  RegistrationId : 100
110
121
  RegistrationType : 1
111
122
  Rights : {"High":"0","Low":"0"}
@@ -113,7 +124,7 @@ m365 spo commandset get --clientSideComponentId c1cbd896-5140-428d-8b0c-4873be19
113
124
  ScriptBlock : null
114
125
  ScriptSrc : null
115
126
  Sequence : 65536
116
- Title : Notification
127
+ Title : HelloWorld
117
128
  Url : null
118
129
  VersionOfUserCustomAction : 1.0.1.0
119
130
  ```
@@ -122,40 +133,80 @@ m365 spo commandset get --clientSideComponentId c1cbd896-5140-428d-8b0c-4873be19
122
133
  <TabItem value="CSV">
123
134
 
124
135
  ```csv
125
- ClientSideComponentId,ClientSideComponentProperties,CommandUIExtension,Description,Group,HostProperties,Id,ImageUrl,Location,Name,RegistrationId,RegistrationType,Rights,Scope,ScriptBlock,ScriptSrc,Sequence,Title,Url,VersionOfUserCustomAction
126
- c1cbd896-5140-428d-8b0c-4873be19f5ac,"{""sampleTextOne"":""One item is selected in the list."", ""sampleTextTwo"":""This command is always visible.""}",,,,,9a0674de-2f3d-4a26-ba79-62b460ddd327,,ClientSideExtension.ListViewCommandSet.CommandBar,{9a0674de-2f3d-4a26-ba79-62b460ddd327},100,1,"{""High"":""0"",""Low"":""0""}",3,,,65536,Notification,,1.0.1.0
136
+ ClientSideComponentId,ClientSideComponentProperties,CommandUIExtension,Description,Group,HostProperties,Id,ImageUrl,Location,Name,RegistrationId,RegistrationType,Scope,ScriptBlock,ScriptSrc,Sequence,Title,Url,VersionOfUserCustomAction
137
+ 53dd6a38-1461-44e0-9bf0-14883316a316,"{""sampleTextOne"":""One item is selected in the list."", ""sampleTextTwo"":""This command is always visible.""}",,,,,bb26547d-c9b7-4ed1-b793-00cbe53388d6,,ClientSideExtension.ListViewCommandSet.CommandBar,{bb26547d-c9b7-4ed1-b793-00cbe53388d6},100,1,3,,,65536,HelloWorld,,1.0.1.0
127
138
  ```
128
139
 
129
140
  </TabItem>
130
141
  <TabItem value="Markdown">
131
142
 
132
143
  ```md
133
- # spo commandset get --webUrl "https://contoso.sharepoint.com/sites/sales" --id "9a0674de-2f3d-4a26-ba79-62b460ddd327"
144
+ # spo commandset get --webUrl "https://contoso.sharepoint.com/sites/sales" --id "bb26547d-c9b7-4ed1-b793-00cbe53388d6"
134
145
 
135
- Date: 27/02/2023
146
+ Date: 16/05/2024
136
147
 
137
- ## Notification (9a0674de-2f3d-4a26-ba79-62b460ddd327)
148
+ ## HelloWorld (bb26547d-c9b7-4ed1-b793-00cbe53388d6)
138
149
 
139
150
  Property | Value
140
151
  ---------|-------
141
- ClientSideComponentId | c1cbd896-5140-428d-8b0c-4873be19f5ac
142
- CommandUIExtension | null
143
- Description | null
144
- Group | null
152
+ ClientSideComponentId | 53dd6a38-1461-44e0-9bf0-14883316a316
153
+ ClientSideComponentProperties | {"sampleTextOne":"One item is selected in the list.", "sampleTextTwo":"This command is always visible."}
145
154
  HostProperties |
146
- Id | 9a0674de-2f3d-4a26-ba79-62b460ddd327
147
- ImageUrl | null
155
+ Id | bb26547d-c9b7-4ed1-b793-00cbe53388d6
148
156
  Location | ClientSideExtension.ListViewCommandSet.CommandBar
157
+ Name | {bb26547d-c9b7-4ed1-b793-00cbe53388d6}
149
158
  RegistrationId | 100
150
159
  RegistrationType | 1
151
160
  Scope | 3
152
- ScriptBlock | null
153
- ScriptSrc | null
154
161
  Sequence | 65536
155
- Title | Notification
156
- Url | null
162
+ Title | HelloWorld
157
163
  VersionOfUserCustomAction | 1.0.1.0
158
164
  ```
159
165
 
160
166
  </TabItem>
161
167
  </Tabs>
168
+
169
+ ### `clientSideComponentProperties` response
170
+
171
+ <Tabs>
172
+ <TabItem value="JSON">
173
+
174
+ ```json
175
+ {
176
+ "sampleTextOne": "One item is selected in the list.",
177
+ "sampleTextTwo": "This command is always visible."
178
+ }
179
+ ```
180
+
181
+ </TabItem>
182
+ <TabItem value="Text">
183
+
184
+ ```txt
185
+ sampleTextOne: One item is selected in the list.
186
+ sampleTextTwo: This command is always visible.
187
+ ```
188
+
189
+ </TabItem>
190
+ <TabItem value="CSV">
191
+
192
+ ```csv
193
+ sampleTextOne,sampleTextTwo
194
+ One item is selected in the list.,This command is always visible.
195
+ ```
196
+
197
+ </TabItem>
198
+ <TabItem value="Markdown">
199
+
200
+ ```md
201
+ # spo commandset get --webUrl "https://contoso.sharepoint.com/sites/sales" --id "9a0674de-2f3d-4a26-ba79-62b460ddd327" --clientSideComponentProperties "true"
202
+
203
+ Date: 15/05/2024
204
+
205
+ Property | Value
206
+ ---------|-------
207
+ sampleTextOne | One item is selected in the list.
208
+ sampleTextTwo | This command is always visible.
209
+ ```
210
+
211
+ </TabItem>
212
+ </Tabs>
@@ -44,29 +44,29 @@ m365 spo commandset list --webUrl https://contoso.sharepoint.com/sites/sales
44
44
  ```json
45
45
  [
46
46
  {
47
- "ClientSideComponentId": "b206e130-1a5b-4ae7-86a7-4f91c9924d0a",
48
- "ClientSideComponentProperties": "",
47
+ "ClientSideComponentId": "53dd6a38-1461-44e0-9bf0-14883316a316",
48
+ "ClientSideComponentProperties": "{\"sampleTextOne\":\"One item is selected in the list.\", \"sampleTextTwo\":\"This command is always visible.\"}",
49
49
  "CommandUIExtension": null,
50
50
  "Description": null,
51
51
  "Group": null,
52
52
  "HostProperties": "",
53
- "Id": "e7000aef-f756-4997-9420-01cc84f9ac9c",
53
+ "Id": "bb26547d-c9b7-4ed1-b793-00cbe53388d6",
54
54
  "ImageUrl": null,
55
55
  "Location": "ClientSideExtension.ListViewCommandSet.CommandBar",
56
- "Name": "{e7000aef-f756-4997-9420-01cc84f9ac9c}",
56
+ "Name": "{bb26547d-c9b7-4ed1-b793-00cbe53388d6}",
57
57
  "RegistrationId": "100",
58
- "RegistrationType": 0,
58
+ "RegistrationType": 1,
59
59
  "Rights": {
60
60
  "High": 0,
61
61
  "Low": 0
62
62
  },
63
- "Scope": 2,
63
+ "Scope": 3,
64
64
  "ScriptBlock": null,
65
65
  "ScriptSrc": null,
66
- "Sequence": 0,
67
- "Title": "test",
66
+ "Sequence": 65536,
67
+ "Title": "HelloWorld",
68
68
  "Url": null,
69
- "VersionOfUserCustomAction": "16.0.1.0"
69
+ "VersionOfUserCustomAction": "1.0.1.0"
70
70
  }
71
71
  ]
72
72
  ```
@@ -75,49 +75,43 @@ m365 spo commandset list --webUrl https://contoso.sharepoint.com/sites/sales
75
75
  <TabItem value="Text">
76
76
 
77
77
  ```text
78
- Name Location Scope Id
79
- -------------------------------------- ------------------------------------------------- ----- ------------------------------------
80
- {e7000aef-f756-4997-9420-01cc84f9ac9c} ClientSideExtension.ListViewCommandSet.CommandBar 2 e7000aef-f756-4997-9420-01cc84f9ac9c
78
+ Id Location Name Scope
79
+ ------------------------------------ ------------------------------------------------- -------------------------------------- -----
80
+ bb26547d-c9b7-4ed1-b793-00cbe53388d6 ClientSideExtension.ListViewCommandSet.CommandBar {bb26547d-c9b7-4ed1-b793-00cbe53388d6} 3
81
81
  ```
82
82
 
83
83
  </TabItem>
84
84
  <TabItem value="CSV">
85
85
 
86
86
  ```csv
87
- Name,Location,Scope,Id
88
- {e7000aef-f756-4997-9420-01cc84f9ac9c},ClientSideExtension.ListViewCommandSet.CommandBar,2,e7000aef-f756-4997-9420-01cc84f9ac9c
87
+ ClientSideComponentId,ClientSideComponentProperties,CommandUIExtension,Description,Group,HostProperties,Id,ImageUrl,Location,Name,RegistrationId,RegistrationType,Scope,ScriptBlock,ScriptSrc,Sequence,Title,Url,VersionOfUserCustomAction
88
+ 53dd6a38-1461-44e0-9bf0-14883316a316,"{""sampleTextOne"":""One item is selected in the list."", ""sampleTextTwo"":""This command is always visible.""}",,,,,bb26547d-c9b7-4ed1-b793-00cbe53388d6,,ClientSideExtension.ListViewCommandSet.CommandBar,{bb26547d-c9b7-4ed1-b793-00cbe53388d6},100,1,3,,,65536,HelloWorld,,1.0.1.0
89
89
  ```
90
90
 
91
91
  </TabItem>
92
92
  <TabItem value="Markdown">
93
93
 
94
94
  ```md
95
- # spo commandset list --webUrl "https://ordidev.sharepoint.com"
95
+ # spo commandset list --webUrl "https://contoso.sharepoint.com/sites/Marketing"
96
96
 
97
- Date: 20/2/2023
97
+ Date: 16/05/2024
98
98
 
99
- ## test (e7000aef-f756-4997-9420-01cc84f9ac9c)
99
+ ## HelloWorld (bb26547d-c9b7-4ed1-b793-00cbe53388d6)
100
100
 
101
101
  Property | Value
102
102
  ---------|-------
103
- ClientSideComponentId | b206e130-1a5b-4ae7-86a7-4f91c9924d0a
104
- ClientSideComponentProperties |
105
- CommandUIExtension | null
106
- Description | null
107
- Group | null
103
+ ClientSideComponentId | 53dd6a38-1461-44e0-9bf0-14883316a316
104
+ ClientSideComponentProperties | {"sampleTextOne":"One item is selected in the list.", "sampleTextTwo":"This command is always visible."}
108
105
  HostProperties |
109
- Id | e7000aef-f756-4997-9420-01cc84f9ac9c
110
- ImageUrl | null
106
+ Id | bb26547d-c9b7-4ed1-b793-00cbe53388d6
111
107
  Location | ClientSideExtension.ListViewCommandSet.CommandBar
108
+ Name | {bb26547d-c9b7-4ed1-b793-00cbe53388d6}
112
109
  RegistrationId | 100
113
- RegistrationType | 0
114
- Scope | 2
115
- ScriptBlock | null
116
- ScriptSrc | null
117
- Sequence | 0
118
- Title | test
119
- Url | null
120
- VersionOfUserCustomAction | 16.0.1.0
110
+ RegistrationType | 1
111
+ Scope | 3
112
+ Sequence | 65536
113
+ Title | HelloWorld
114
+ VersionOfUserCustomAction | 1.0.1.0
121
115
  ```
122
116
 
123
117
  </TabItem>
@@ -33,7 +33,7 @@ m365 spo file retentionlabel ensure [options]
33
33
 
34
34
  ## Remarks
35
35
 
36
- You can also use [spo listitem retentionlabel remove](./../../../cmd/spo/listitem/listitem-retentionlabel-remove.mdx) for removing the retention label from a listitem.
36
+ You can also use [spo listitem retentionlabel remove](./../../../cmd/spo/listitem/listitem-retentionlabel-remove.mdx) for removing the retention label from a list item.
37
37
 
38
38
  The `--assetId` option has to do with event-based retention. Event-based retention is about starting a retention period when a specific event occurs, instead of the moment a document was labeled or created.
39
39
 
@@ -19,7 +19,7 @@ m365 spo file roleassignment add [options]
19
19
  `--fileUrl [fileUrl]`
20
20
  : The server- or site-relative decoded URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both.
21
21
 
22
- `i, --fileId [fileId]`
22
+ `-i, --fileId [fileId]`
23
23
  : The UniqueId (GUID) of the file to retrieve. Specify either `fileUrl` or `fileId` but not both.
24
24
 
25
25
  `--principalId [principalId]`
@@ -29,7 +29,7 @@ m365 spo file roleassignment add [options]
29
29
  : The upn/email of user to assign role to. Specify either `upn`, `groupName`, or `principalId` but not multiple.
30
30
 
31
31
  `--groupName [groupName]`
32
- : The group name of Microsoft Entra or SharePoint group. Specify either `upn`, `groupName`, or `principalId` but not multiple.
32
+ : The group name of the SharePoint group Specify either `upn`, `groupName`, or `principalId` but not multiple.
33
33
 
34
34
  `--roleDefinitionId [roleDefinitionId]`
35
35
  : ID of role definition. Specify either `roleDefinitionId` or `roleDefinitionName` but not both.
@@ -29,7 +29,7 @@ m365 spo file roleassignment remove [options]
29
29
  : The upn/email of the user. Specify either `upn`, `groupName`, or `principalId` but not multiple.
30
30
 
31
31
  `--groupName [groupName]`
32
- : The group name of a Microsoft Entra or SharePoint group. Specify either `upn`, `groupName`, or `principalId` but not multiple.
32
+ : The group name of the SharePoint group Specify either `upn`, `groupName`, or `principalId` but not multiple.
33
33
 
34
34
  `-f, --force`
35
35
  : Don't prompt for confirmation.
@@ -19,7 +19,7 @@ m365 spo file roleinheritance break [options]
19
19
  `--fileUrl [fileUrl]`
20
20
  : The server- or site-relative decoded URL of the file. Specify either `fileUrl` or `fileId` but not both.
21
21
 
22
- `i, --fileId [fileId]`
22
+ `-i, --fileId [fileId]`
23
23
  : The UniqueId (GUID) of the file. Specify either `fileUrl` or `fileId` but not both.
24
24
 
25
25
  `-c, --clearExistingPermissions`
@@ -19,7 +19,7 @@ m365 spo file roleinheritance reset [options]
19
19
  `--fileUrl [fileUrl]`
20
20
  : The server- or site-relative decoded URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both.
21
21
 
22
- `i, --fileId [fileId]`
22
+ `-i, --fileId [fileId]`
23
23
  : The UniqueId (GUID) of the file to retrieve. Specify either `fileUrl` or `fileId` but not both.
24
24
 
25
25
  `-f, --force`
@@ -19,7 +19,7 @@ m365 spo folder retentionlabel ensure [options]
19
19
  `--folderUrl [folderUrl]`
20
20
  : The server- or site-relative decoded URL of the folder that should be labelled. Specify either `folderUrl` or `folderId` but not both.
21
21
 
22
- `i, --folderId [folderId]`
22
+ `-i, --folderId [folderId]`
23
23
  : The UniqueId (GUID) of the folder that should be labelled. Specify either `folderUrl` or `folderId` but not both.
24
24
 
25
25
  `--name <name>`
@@ -30,7 +30,7 @@ m365 spo folder retentionlabel ensure [options]
30
30
 
31
31
  ## Remarks
32
32
 
33
- You can also use [spo listitem retentionlabel remove](./../../../cmd/spo/listitem/listitem-retentionlabel-remove.mdx) for removing the retention label from a listitem.
33
+ You can also use [spo listitem retentionlabel remove](./../../../cmd/spo/listitem/listitem-retentionlabel-remove.mdx) for removing the retention label from a list item.
34
34
 
35
35
  ## Examples
36
36
 
@@ -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.