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

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