@pnp/cli-microsoft365 8.0.0 → 8.1.0-beta.309a9b8

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 (92) 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 +50 -5
  5. package/dist/cli/cli.js +101 -39
  6. package/dist/m365/commands/login.js +49 -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/enterpriseapp/enterpriseapp-remove.js +123 -0
  11. package/dist/m365/entra/commands/group/group-set.js +256 -0
  12. package/dist/m365/entra/commands/m365group/m365group-user-add.js +109 -32
  13. package/dist/m365/entra/commands/m365group/m365group-user-set.js +159 -84
  14. package/dist/m365/entra/commands/multitenant/multitenant-add.js +65 -0
  15. package/dist/m365/entra/commands/multitenant/multitenant-remove.js +118 -0
  16. package/dist/m365/entra/commands/multitenant/multitenant-set.js +72 -0
  17. package/dist/m365/entra/commands.js +6 -0
  18. package/dist/m365/flow/commands/flow-get.js +1 -1
  19. package/dist/m365/onenote/commands/notebook/notebook-add.js +132 -0
  20. package/dist/m365/onenote/commands.js +1 -0
  21. package/dist/m365/pa/commands/app/app-export.js +13 -7
  22. package/dist/m365/spe/ContainerTypeProperties.js +2 -0
  23. package/dist/m365/spe/commands/containertype/containertype-list.js +49 -0
  24. package/dist/m365/spe/commands.js +2 -1
  25. package/dist/m365/spo/commands/applicationcustomizer/applicationcustomizer-get.js +16 -21
  26. package/dist/m365/spo/commands/commandset/commandset-get.js +31 -17
  27. package/dist/m365/spo/commands/file/file-roleassignment-add.js +1 -1
  28. package/dist/m365/spo/commands/file/file-roleinheritance-break.js +1 -1
  29. package/dist/m365/spo/commands/file/file-roleinheritance-reset.js +1 -1
  30. package/dist/m365/spo/commands/folder/folder-retentionlabel-ensure.js +1 -1
  31. package/dist/m365/spo/commands/folder/folder-sharinglink-get.js +86 -0
  32. package/dist/m365/spo/commands/folder/folder-sharinglink-list.js +110 -0
  33. package/dist/m365/spo/commands/list/ListInstance.js +6 -1
  34. package/dist/m365/spo/commands/list/list-get.js +9 -3
  35. package/dist/m365/spo/commands/list/list-roleassignment-add.js +46 -21
  36. package/dist/m365/spo/commands/list/list-roleassignment-remove.js +48 -46
  37. package/dist/m365/spo/commands/site/site-get.js +12 -16
  38. package/dist/m365/spo/commands/tenant/tenant-applicationcustomizer-get.js +19 -5
  39. package/dist/m365/spo/commands/tenant/tenant-commandset-get.js +20 -6
  40. package/dist/m365/spo/commands.js +2 -0
  41. package/dist/m365/teams/commands/message/message-restore.js +106 -0
  42. package/dist/m365/teams/commands.js +1 -0
  43. package/dist/utils/drive.js +61 -0
  44. package/dist/utils/formatting.js +16 -0
  45. package/dist/utils/spo.js +69 -6
  46. package/dist/utils/zod.js +124 -0
  47. package/docs/docs/cmd/connection/connection-use.mdx +8 -2
  48. package/docs/docs/cmd/entra/enterpriseapp/enterpriseapp-remove.mdx +65 -0
  49. package/docs/docs/cmd/entra/group/group-add.mdx +0 -4
  50. package/docs/docs/cmd/entra/group/group-set.mdx +89 -0
  51. package/docs/docs/cmd/entra/m365group/m365group-user-add.mdx +28 -10
  52. package/docs/docs/cmd/entra/m365group/m365group-user-set.mdx +35 -11
  53. package/docs/docs/cmd/entra/multitenant/multitenant-add.mdx +107 -0
  54. package/docs/docs/cmd/entra/multitenant/multitenant-remove.mdx +58 -0
  55. package/docs/docs/cmd/entra/multitenant/multitenant-set.mdx +53 -0
  56. package/docs/docs/cmd/flow/flow-get.mdx +149 -283
  57. package/docs/docs/cmd/onenote/notebook/notebook-add.mdx +169 -0
  58. package/docs/docs/cmd/pa/app/app-export.mdx +15 -9
  59. package/docs/docs/cmd/planner/plan/plan-remove.mdx +1 -1
  60. package/docs/docs/cmd/spe/containertype/containertype-list.mdx +102 -0
  61. package/docs/docs/cmd/spo/app/app-uninstall.mdx +1 -1
  62. package/docs/docs/cmd/spo/applicationcustomizer/applicationcustomizer-get.mdx +87 -38
  63. package/docs/docs/cmd/spo/applicationcustomizer/applicationcustomizer-list.mdx +22 -28
  64. package/docs/docs/cmd/spo/commandset/commandset-get.mdx +75 -24
  65. package/docs/docs/cmd/spo/commandset/commandset-list.mdx +26 -32
  66. package/docs/docs/cmd/spo/file/file-retentionlabel-ensure.mdx +1 -1
  67. package/docs/docs/cmd/spo/file/file-roleassignment-add.mdx +2 -2
  68. package/docs/docs/cmd/spo/file/file-roleassignment-remove.mdx +1 -1
  69. package/docs/docs/cmd/spo/file/file-roleinheritance-break.mdx +1 -1
  70. package/docs/docs/cmd/spo/file/file-roleinheritance-reset.mdx +1 -1
  71. package/docs/docs/cmd/spo/folder/folder-retentionlabel-ensure.mdx +2 -2
  72. package/docs/docs/cmd/spo/folder/folder-sharinglink-get.mdx +110 -0
  73. package/docs/docs/cmd/spo/folder/folder-sharinglink-list.mdx +114 -0
  74. package/docs/docs/cmd/spo/list/list-get.mdx +6 -0
  75. package/docs/docs/cmd/spo/list/list-roleassignment-add.mdx +15 -3
  76. package/docs/docs/cmd/spo/list/list-roleassignment-remove.mdx +15 -3
  77. package/docs/docs/cmd/spo/listitem/listitem-retentionlabel-ensure.mdx +4 -4
  78. package/docs/docs/cmd/spo/listitem/listitem-retentionlabel-remove.mdx +1 -1
  79. package/docs/docs/cmd/spo/listitem/listitem-roleassignment-add.mdx +9 -9
  80. package/docs/docs/cmd/spo/listitem/listitem-roleassignment-remove.mdx +7 -7
  81. package/docs/docs/cmd/spo/site/site-recyclebinitem-list.mdx +1 -1
  82. package/docs/docs/cmd/spo/tenant/tenant-applicationcustomizer-get.mdx +79 -30
  83. package/docs/docs/cmd/spo/tenant/tenant-applicationcustomizer-list.mdx +20 -19
  84. package/docs/docs/cmd/spo/tenant/tenant-commandset-get.mdx +84 -38
  85. package/docs/docs/cmd/spo/tenant/tenant-commandset-list.mdx +20 -19
  86. package/docs/docs/cmd/spo/web/web-roleassignment-add.mdx +1 -1
  87. package/docs/docs/cmd/spo/web/web-roleassignment-remove.mdx +1 -1
  88. package/docs/docs/cmd/teams/meeting/meeting-list.mdx +7 -3
  89. package/docs/docs/cmd/teams/message/message-remove.mdx +2 -1
  90. package/docs/docs/cmd/teams/message/message-restore.mdx +62 -0
  91. package/npm-shrinkwrap.json +1003 -1148
  92. package/package.json +27 -24
@@ -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
 
@@ -0,0 +1,110 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+ import Tabs from '@theme/Tabs';
3
+ import TabItem from '@theme/TabItem';
4
+
5
+ # spo folder sharinglink get
6
+
7
+ Gets details about a specific sharing link on a folder
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 spo folder sharinglink get [options]
13
+ ```
14
+
15
+ ## Options
16
+
17
+ ```md definition-list
18
+ `-u, --webUrl <webUrl>`
19
+ : The URL of the site where the folder is located.
20
+
21
+ `--folderUrl [folderUrl]`
22
+ : The server- or site-relative decoded URL of the folder. Specify either `folderUrl` or `folderId` but not both.
23
+
24
+ `--folderId [folderId]`
25
+ : The Unique ID (GUID) of the folder. Specify either `folderUrl` or `folderId` but not both.
26
+
27
+ `-i, --id <id>`
28
+ : The sharing link ID.
29
+ ```
30
+
31
+ <Global />
32
+
33
+ ## Examples
34
+
35
+ Gets a specific sharing link of a folder by id.
36
+
37
+ ```sh
38
+ m365 spo folder sharinglink get --webUrl https://contoso.sharepoint.com/sites/demo --id 45fa6aed-362f-48b1-b04e-6da85a526506 --folderId daebb04b-a773-4baa-b1d1-3625418e3234
39
+ ```
40
+
41
+ Gets a specific sharing link of a folder by url.
42
+
43
+ ```sh
44
+ m365 spo folder sharinglink get --webUrl https://contoso.sharepoint.com/sites/demo --id 45fa6aed-362f-48b1-b04e-6da85a526506 --folderUrl "/sites/demo/shared documents/folder"
45
+ ```
46
+
47
+ ## Response
48
+
49
+ <Tabs>
50
+ <TabItem value="JSON">
51
+
52
+ ```json
53
+ {
54
+ "id": "d6f6a428-9857-471f-9635-edd68d5aa6c1",
55
+ "roles": [
56
+ "write"
57
+ ],
58
+ "shareId": "u!aHR0cHM6Ly9uYWNoYW4zNjUuc2hhcmVwb2ludC5jb20vOmY6L3MvU1BEZW1vL0VxXzlYcXRIdks1RW9wd3NfX1kteko0QlNybFFNUy1qUTBFOWJsazhVLVNTdVE",
59
+ "hasPassword": false,
60
+ "grantedToIdentitiesV2": [],
61
+ "grantedToIdentities": [],
62
+ "link": {
63
+ "scope": "anonymous",
64
+ "type": "edit",
65
+ "webUrl": "https://contoso.sharepoint.com/:f:/s/demo/Eq_9XqtHvK5Eopws__Y-zJ4BSrlQMS-jQ0E9blk8U-SSuQ",
66
+ "preventsDownload": false
67
+ }
68
+ }
69
+ ```
70
+
71
+ </TabItem>
72
+ <TabItem value="Text">
73
+
74
+ ```text
75
+ grantedToIdentities : []
76
+ grantedToIdentitiesV2 : []
77
+ hasPassword : false
78
+ id : d6f6a428-9857-471f-9635-edd68d5aa6c1
79
+ link : {"scope":"anonymous","type":"edit","webUrl":"https://contoso.sharepoint.com/:f:/s/demo/Eq_9XqtHvK5Eopws__Y-zJ4BSrlQMS-jQ0E9blk8U-SSuQ","preventsDownload":false}
80
+ roles : ["write"]
81
+ shareId : u!aHR0cHM6Ly9uYWNoYW4zNjUuc2hhcmVwb2ludC5jb20vOmY6L3MvU1BEZW1vL0VxXzlYcXRIdks1RW9wd3NfX1kteko0QlNybFFNUy1qUTBFOWJsazhVLVNTdVE
82
+ ```
83
+
84
+ </TabItem>
85
+ <TabItem value="CSV">
86
+
87
+ ```csv
88
+ id,shareId,hasPassword
89
+ d6f6a428-9857-471f-9635-edd68d5aa6c1,u!aHR0cHM6Ly9uYWNoYW4zNjUuc2hhcmVwb2ludC5jb20vOmY6L3MvU1BEZW1vL0VxXzlYcXRIdks1RW9wd3NfX1kteko0QlNybFFNUy1qUTBFOWJsazhVLVNTdVE,
90
+ ```
91
+
92
+ </TabItem>
93
+ <TabItem value="Markdown">
94
+
95
+ ```md
96
+ # spo folder sharinglink get --webUrl "https://contoso.sharepoint.com/sites/demo" --id "d6f6a428-9857-471f-9635-edd68d5aa6c1" --folderUrl "/sites/demo/shared documents/Test"
97
+
98
+ Date: 5/2/2024
99
+
100
+ ## d6f6a428-9857-471f-9635-edd68d5aa6c1
101
+
102
+ Property | Value
103
+ ---------|-------
104
+ id | d6f6a428-9857-471f-9635-edd68d5aa6c1
105
+ shareId | u!aHR0cHM6Ly9uYWNoYW4zNjUuc2hhcmVwb2ludC5jb20vOmY6L3MvU1BEZW1vL0VxXzlYcXRIdks1RW9wd3NfX1kteko0QlNybFFNUy1qUTBFOWJsazhVLVNTdVE
106
+ hasPassword | false
107
+ ```
108
+
109
+ </TabItem>
110
+ </Tabs>
@@ -0,0 +1,114 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+ import Tabs from '@theme/Tabs';
3
+ import TabItem from '@theme/TabItem';
4
+
5
+ # spo folder sharinglink list
6
+
7
+ Lists all the sharing links of a specific folder
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 spo folder sharinglink list [options]
13
+ ```
14
+
15
+ ## Options
16
+
17
+ ```md definition-list
18
+ `-u, --webUrl <webUrl>`
19
+ : The URL of the site where the folder is located.
20
+
21
+ `--folderUrl [folderUrl]`
22
+ : The server- or site-relative decoded URL of the folder. Specify either `folderUrl` or `folderId` but not both.
23
+
24
+ `--folderId [folderId]`
25
+ : The UniqueId (GUID) of the folder. Specify either `folderUrl` or `folderId` but not both.
26
+
27
+ `-s, --scope [scope]`
28
+ : Filter the results to only sharing links of a given scope: `anonymous`, `users` or `organization`. By default all sharing links are listed.
29
+ ```
30
+
31
+ <Global />
32
+
33
+ ## Examples
34
+
35
+ List sharing links of a folder by id.
36
+
37
+ ```sh
38
+ m365 spo folder sharinglink list --webUrl https://contoso.sharepoint.com/sites/demo --folderId daebb04b-a773-4baa-b1d1-3625418e3234
39
+ ```
40
+
41
+ List sharing links of a folder by url.
42
+
43
+ ```sh
44
+ m365 spo folder sharinglink list --webUrl https://contoso.sharepoint.com/sites/demo --folderUrl "/sites/demo/shared documents/folder"
45
+ ```
46
+
47
+ List anonymous sharing links of a folder by url.
48
+
49
+ ```sh
50
+ m365 spo folder sharinglink list --webUrl https://contoso.sharepoint.com/sites/demo --folderUrl "/sites/demo/shared documents/folder" --scope anonymous
51
+ ```
52
+
53
+ ## Response
54
+
55
+ <Tabs>
56
+ <TabItem value="JSON">
57
+
58
+ ```json
59
+ [
60
+ {
61
+ "id": "e6100f73-981c-4bde-986b-eed262f04659",
62
+ "roles": [
63
+ "write"
64
+ ],
65
+ "shareId": "u!aHR0cHM6Ly83NTY2YXZhLnNoYXJlcG9pbnQuY29tLzpmOi9nL0V2QVFpdnpLV2ZoT3ZJOHJiNm1UVEhjQmQzUUxCOXVsUGIyQTQ1UG81ZmRuYWc",
66
+ "hasPassword": false,
67
+ "grantedToIdentitiesV2": [],
68
+ "grantedToIdentities": [],
69
+ "link": {
70
+ "scope": "anonymous",
71
+ "type": "edit",
72
+ "webUrl": "https://contoso.sharepoint.com/:f:/g/EvAQivzKWfhOvI8rb6mTTHcBd3QLB9ulPb2A45Po5fdnag",
73
+ "preventsDownload": false
74
+ }
75
+ }
76
+ ]
77
+ ```
78
+
79
+ </TabItem>
80
+ <TabItem value="Text">
81
+
82
+ ```text
83
+ id scope roles link
84
+ ------------------------------------ ------------ ----- -----------------------------------------------------------------------------------
85
+ e6100f73-981c-4bde-986b-eed262f04659 anonymous write https://contoso.sharepoint.com/:f:/g/EvAQivzKWfhOvI8rb6mTTHcBd3QLB9ulPb2A45Po5fdnag
86
+ ```
87
+
88
+ </TabItem>
89
+ <TabItem value="CSV">
90
+
91
+ ```csv
92
+ id,shareId,hasPassword
93
+ e6100f73-981c-4bde-986b-eed262f04659,u!aHR0cHM6Ly83NTY2YXZhLnNoYXJlcG9pbnQuY29tLzpmOi9nL0V2QVFpdnpLV2ZoT3ZJOHJiNm1UVEhjQmQzUUxCOXVsUGIyQTQ1UG81ZmRuYWc,
94
+ ```
95
+
96
+ </TabItem>
97
+ <TabItem value="Markdown">
98
+
99
+ ```md
100
+ # spo folder sharinglink list --webUrl "https://contoso.sharepoint.com/" --folderUrl "/shared documents/folder1"
101
+
102
+ Date: 24/04/2024
103
+
104
+ ## e6100f73-981c-4bde-986b-eed262f04659
105
+
106
+ Property | Value
107
+ ---------|-------
108
+ id | e6100f73-981c-4bde-986b-eed262f04659
109
+ shareId | u!aHR0cHM6Ly83NTY2YXZhLnNoYXJlcG9pbnQuY29tLzpmOi9nL0V2QVFpdnpLV2ZoT3ZJOHJiNm1UVEhjQmQzUUxCOXVsUGIyQTQ1UG81ZmRuYWc
110
+ hasPassword | false
111
+ ```
112
+
113
+ </TabItem>
114
+ </Tabs>
@@ -91,6 +91,11 @@ m365 spo list get --title Documents --webUrl https://contoso.sharepoint.com/site
91
91
 
92
92
  ```json
93
93
  {
94
+ "VersionPolicies": {
95
+ "DefaultExpireAfterDays": 0,
96
+ "DefaultTrimMode": 0,
97
+ "DefaultTrimModeValue": "NoExpiration"
98
+ },
94
99
  "AllowContentTypes": true,
95
100
  "BaseTemplate": 100,
96
101
  "BaseType": 0,
@@ -210,6 +215,7 @@ m365 spo list get --title Documents --webUrl https://contoso.sharepoint.com/site
210
215
  ServerTemplateCanCreateFolders : true
211
216
  TemplateFeatureId : 00bfea71-de22-43b2-a848-c05709900100
212
217
  Title : Test
218
+ VersionPolicies : {"DefaultExpireAfterDays": 0,"DefaultTrimMode": 0,"DefaultTrimModeValue": "NoExpiration"}
213
219
  ```
214
220
 
215
221
  </TabItem>
@@ -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.