@pnp/cli-microsoft365 6.3.0 → 6.4.0-beta.140530d

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 (212) hide show
  1. package/.devcontainer/Dockerfile +5 -2
  2. package/.eslintrc.js +4 -0
  3. package/Dockerfile +6 -3
  4. package/README.md +12 -1
  5. package/dist/Auth.js +1 -3
  6. package/dist/Command.js +1 -0
  7. package/dist/m365/aad/commands/user/user-get.js +3 -0
  8. package/dist/m365/aad/commands/user/user-license-remove.js +2 -1
  9. package/dist/m365/aad/commands/user/user-recyclebinitem-restore.js +2 -9
  10. package/dist/m365/aad/commands/user/user-set.js +3 -0
  11. package/dist/m365/aad/commands/user/user-signin-list.js +3 -0
  12. package/dist/m365/file/commands/file-list.js +5 -1
  13. package/dist/m365/flow/commands/flow-disable.js +9 -2
  14. package/dist/m365/flow/commands/flow-enable.js +9 -2
  15. package/dist/m365/flow/commands/flow-get.js +9 -2
  16. package/dist/m365/flow/commands/flow-list.js +1 -1
  17. package/dist/m365/flow/commands/flow-remove.js +2 -2
  18. package/dist/m365/flow/commands/owner/owner-ensure.js +147 -0
  19. package/dist/m365/flow/commands/owner/owner-list.js +89 -0
  20. package/dist/m365/flow/commands/owner/owner-remove.js +147 -0
  21. package/dist/m365/flow/commands/run/run-cancel.js +9 -2
  22. package/dist/m365/flow/commands/run/run-list.js +5 -2
  23. package/dist/m365/flow/commands.js +3 -0
  24. package/dist/m365/planner/commands/roster/roster-member-add.js +3 -0
  25. package/dist/m365/planner/commands/roster/roster-member-get.js +98 -0
  26. package/dist/m365/planner/commands.js +1 -0
  27. package/dist/m365/purview/commands/retentionevent/retentionevent-add.js +138 -0
  28. package/dist/m365/purview/commands/retentionlabel/retentionlabel-add.js +48 -14
  29. package/dist/m365/purview/commands.js +1 -0
  30. package/dist/m365/spfx/commands/project/project-upgrade/upgrade-1.17.0-beta.1.js +59 -0
  31. package/dist/m365/spfx/commands/project/project-upgrade.js +16 -13
  32. package/dist/m365/spfx/commands/spfx-doctor.js +43 -29
  33. package/dist/m365/spo/commands/commandset/commandset-add.js +138 -0
  34. package/dist/m365/spo/commands/commandset/commandset-get.js +128 -0
  35. package/dist/m365/spo/commands/commandset/commandset-list.js +77 -0
  36. package/dist/m365/spo/commands/commandset/commandset-remove.js +146 -0
  37. package/dist/m365/spo/commands/commandset/commandset-set.js +182 -0
  38. package/dist/m365/spo/commands/customaction/customaction-get.js +27 -7
  39. package/dist/m365/spo/commands/file/file-move.js +1 -1
  40. package/dist/m365/spo/commands/group/group-member-add.js +54 -95
  41. package/dist/m365/spo/commands/list/list-add.js +11 -8
  42. package/dist/m365/spo/commands/list/list-set.js +3 -3
  43. package/dist/m365/spo/commands/navigation/navigation-node-add.js +5 -4
  44. package/dist/m365/spo/commands/navigation/navigation-node-set.js +5 -1
  45. package/dist/m365/spo/commands/tenant/tenant-applicationcustomizer-get.js +118 -0
  46. package/dist/m365/spo/commands/term/term-get.js +68 -48
  47. package/dist/m365/spo/commands/user/user-ensure.js +105 -0
  48. package/dist/m365/spo/commands.js +7 -0
  49. package/dist/m365/todo/commands/task/task-add.js +35 -3
  50. package/dist/utils/aadGroup.js +18 -0
  51. package/dist/utils/aadUser.js +37 -0
  52. package/dist/utils/md.js +7 -0
  53. package/dist/utils/spo.js +32 -0
  54. package/docs/docs/cmd/aad/app/app-add.md +3 -3
  55. package/docs/docs/cmd/aad/approleassignment/approleassignment-add.md +5 -5
  56. package/docs/docs/cmd/aad/approleassignment/approleassignment-remove.md +3 -3
  57. package/docs/docs/cmd/aad/user/user-remove.md +1 -1
  58. package/docs/docs/cmd/cli/completion/completion-clink-update.md +4 -4
  59. package/docs/docs/cmd/flow/owner/owner-ensure.md +61 -0
  60. package/docs/docs/cmd/flow/owner/owner-list.md +90 -0
  61. package/docs/docs/cmd/flow/owner/owner-remove.md +67 -0
  62. package/docs/docs/cmd/flow/run/run-list.md +28 -0
  63. package/docs/docs/cmd/onenote/page/page-list.md +1 -1
  64. package/docs/docs/cmd/outlook/mail/mail-send.md +7 -3
  65. package/docs/docs/cmd/outlook/message/message-get.md +143 -0
  66. package/docs/docs/cmd/outlook/message/message-list.md +119 -0
  67. package/docs/docs/cmd/outlook/message/message-move.md +4 -0
  68. package/docs/docs/cmd/outlook/report/report-mailactivitycounts.md +40 -0
  69. package/docs/docs/cmd/outlook/report/report-mailactivityusercounts.md +40 -0
  70. package/docs/docs/cmd/outlook/report/report-mailactivityuserdetail.md +45 -0
  71. package/docs/docs/cmd/outlook/report/report-mailappusageappsusercounts.md +43 -0
  72. package/docs/docs/cmd/outlook/report/report-mailappusageusercounts.md +44 -0
  73. package/docs/docs/cmd/outlook/report/report-mailappusageuserdetail.md +48 -0
  74. package/docs/docs/cmd/outlook/report/report-mailappusageversionsusercounts.md +41 -0
  75. package/docs/docs/cmd/outlook/report/report-mailboxusagedetail.md +49 -0
  76. package/docs/docs/cmd/outlook/report/report-mailboxusagemailboxcount.md +37 -0
  77. package/docs/docs/cmd/outlook/report/report-mailboxusagequotastatusmailboxcounts.md +40 -0
  78. package/docs/docs/cmd/outlook/report/report-mailboxusagestorage.md +36 -0
  79. package/docs/docs/cmd/outlook/room/room-list.md +81 -0
  80. package/docs/docs/cmd/outlook/roomlist/roomlist-list.md +58 -0
  81. package/docs/docs/cmd/planner/plan/plan-add.md +3 -3
  82. package/docs/docs/cmd/planner/plan/plan-set.md +73 -7
  83. package/docs/docs/cmd/planner/roster/roster-add.md +16 -1
  84. package/docs/docs/cmd/planner/roster/roster-member-get.md +87 -0
  85. package/docs/docs/cmd/planner/task/task-add.md +230 -0
  86. package/docs/docs/cmd/planner/task/task-checklistitem-add.md +55 -0
  87. package/docs/docs/cmd/planner/task/task-checklistitem-list.md +55 -0
  88. package/docs/docs/cmd/planner/task/task-checklistitem-remove.md +4 -0
  89. package/docs/docs/cmd/planner/task/task-get.md +131 -0
  90. package/docs/docs/cmd/planner/task/task-list.md +92 -0
  91. package/docs/docs/cmd/planner/task/task-reference-add.md +46 -0
  92. package/docs/docs/cmd/planner/task/task-reference-list.md +46 -0
  93. package/docs/docs/cmd/planner/task/task-reference-remove.md +4 -0
  94. package/docs/docs/cmd/planner/task/task-remove.md +4 -0
  95. package/docs/docs/cmd/planner/task/task-set.md +230 -0
  96. package/docs/docs/cmd/planner/tenant/tenant-settings-list.md +55 -0
  97. package/docs/docs/cmd/planner/tenant/tenant-settings-set.md +55 -0
  98. package/docs/docs/cmd/pp/card/card-get.md +2 -2
  99. package/docs/docs/cmd/pp/card/card-list.md +2 -2
  100. package/docs/docs/cmd/purview/retentionevent/retentionevent-add.md +149 -0
  101. package/docs/docs/cmd/purview/retentioneventtype/retentioneventtype-add.md +7 -7
  102. package/docs/docs/cmd/purview/retentionlabel/retentionlabel-add.md +12 -0
  103. package/docs/docs/cmd/skype/report/report-activitycounts.md +38 -0
  104. package/docs/docs/cmd/skype/report/report-activityusercounts.md +38 -0
  105. package/docs/docs/cmd/skype/report/report-activityuserdetail.md +67 -0
  106. package/docs/docs/cmd/spfx/project/project-doctor.md +3 -3
  107. package/docs/docs/cmd/spfx/project/project-externalize.md +3 -3
  108. package/docs/docs/cmd/spfx/project/project-permissions-grant.md +21 -0
  109. package/docs/docs/cmd/spfx/project/project-upgrade.md +3 -3
  110. package/docs/docs/cmd/spfx/spfx-doctor.md +3 -3
  111. package/docs/docs/cmd/spo/cdn/cdn-get.md +6 -6
  112. package/docs/docs/cmd/spo/cdn/cdn-origin-add.md +3 -3
  113. package/docs/docs/cmd/spo/cdn/cdn-origin-list.md +3 -3
  114. package/docs/docs/cmd/spo/cdn/cdn-origin-remove.md +3 -3
  115. package/docs/docs/cmd/spo/cdn/cdn-policy-list.md +3 -3
  116. package/docs/docs/cmd/spo/cdn/cdn-policy-set.md +3 -3
  117. package/docs/docs/cmd/spo/cdn/cdn-set.md +3 -3
  118. package/docs/docs/cmd/spo/commandset/commandset-add.md +159 -0
  119. package/docs/docs/cmd/spo/commandset/commandset-get.md +149 -0
  120. package/docs/docs/cmd/spo/commandset/commandset-list.md +109 -0
  121. package/docs/docs/cmd/spo/commandset/commandset-remove.md +55 -0
  122. package/docs/docs/cmd/spo/commandset/commandset-set.md +71 -0
  123. package/docs/docs/cmd/spo/customaction/customaction-get.md +113 -11
  124. package/docs/docs/cmd/spo/externaluser/externaluser-list.md +2 -0
  125. package/docs/docs/cmd/spo/group/group-member-add.md +26 -4
  126. package/docs/docs/cmd/spo/hidedefaultthemes/hidedefaultthemes-get.md +2 -0
  127. package/docs/docs/cmd/spo/hidedefaultthemes/hidedefaultthemes-set.md +2 -0
  128. package/docs/docs/cmd/spo/homesite/homesite-remove.md +2 -0
  129. package/docs/docs/cmd/spo/homesite/homesite-set.md +2 -0
  130. package/docs/docs/cmd/spo/knowledgehub/knowledgehub-get.md +2 -0
  131. package/docs/docs/cmd/spo/knowledgehub/knowledgehub-remove.md +2 -0
  132. package/docs/docs/cmd/spo/knowledgehub/knowledgehub-set.md +3 -3
  133. package/docs/docs/cmd/spo/list/list-add.md +2 -2
  134. package/docs/docs/cmd/spo/list/list-set.md +2 -2
  135. package/docs/docs/cmd/spo/listitem/listitem-add.md +1 -1
  136. package/docs/docs/cmd/spo/listitem/listitem-batch-add.md +1 -1
  137. package/docs/docs/cmd/spo/listitem/listitem-set.md +1 -1
  138. package/docs/docs/cmd/spo/navigation/navigation-node-add.md +3 -3
  139. package/docs/docs/cmd/spo/navigation/navigation-node-set.md +2 -2
  140. package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-add.md +2 -0
  141. package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-list.md +2 -0
  142. package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-remove.md +2 -0
  143. package/docs/docs/cmd/spo/orgnewssite/orgnewssite-list.md +2 -0
  144. package/docs/docs/cmd/spo/orgnewssite/orgnewssite-remove.md +2 -0
  145. package/docs/docs/cmd/spo/orgnewssite/orgnewssite-set.md +3 -3
  146. package/docs/docs/cmd/spo/site/site-appcatalog-add.md +2 -0
  147. package/docs/docs/cmd/spo/site/site-appcatalog-remove.md +3 -3
  148. package/docs/docs/cmd/spo/site/site-commsite-enable.md +2 -0
  149. package/docs/docs/cmd/spo/site/site-list.md +3 -3
  150. package/docs/docs/cmd/spo/site/site-remove.md +3 -3
  151. package/docs/docs/cmd/spo/site/site-rename.md +3 -3
  152. package/docs/docs/cmd/spo/site/site-set.md +5 -5
  153. package/docs/docs/cmd/spo/storageentity/storageentity-remove.md +3 -3
  154. package/docs/docs/cmd/spo/storageentity/storageentity-set.md +3 -3
  155. package/docs/docs/cmd/spo/tenant/tenant-appcatalog-add.md +3 -3
  156. package/docs/docs/cmd/spo/tenant/tenant-appcatalogurl-get.md +2 -0
  157. package/docs/docs/cmd/spo/tenant/tenant-applicationcustomizer-add.md +3 -3
  158. package/docs/docs/cmd/spo/tenant/tenant-applicationcustomizer-get.md +142 -0
  159. package/docs/docs/cmd/spo/tenant/tenant-recyclebinitem-list.md +2 -0
  160. package/docs/docs/cmd/spo/tenant/tenant-recyclebinitem-remove.md +3 -3
  161. package/docs/docs/cmd/spo/tenant/tenant-recyclebinitem-restore.md +3 -3
  162. package/docs/docs/cmd/spo/tenant/tenant-settings-list.md +2 -0
  163. package/docs/docs/cmd/spo/tenant/tenant-settings-set.md +28 -26
  164. package/docs/docs/cmd/spo/term/term-add.md +3 -3
  165. package/docs/docs/cmd/spo/term/term-get.md +3 -3
  166. package/docs/docs/cmd/spo/term/term-group-add.md +2 -0
  167. package/docs/docs/cmd/spo/term/term-group-get.md +2 -0
  168. package/docs/docs/cmd/spo/term/term-group-list.md +2 -0
  169. package/docs/docs/cmd/spo/term/term-list.md +3 -1
  170. package/docs/docs/cmd/spo/term/term-set-add.md +3 -3
  171. package/docs/docs/cmd/spo/term/term-set-get.md +2 -0
  172. package/docs/docs/cmd/spo/term/term-set-list.md +2 -0
  173. package/docs/docs/cmd/spo/theme/theme-apply.md +3 -3
  174. package/docs/docs/cmd/spo/theme/theme-get.md +2 -0
  175. package/docs/docs/cmd/spo/theme/theme-list.md +2 -0
  176. package/docs/docs/cmd/spo/theme/theme-remove.md +2 -0
  177. package/docs/docs/cmd/spo/theme/theme-set.md +3 -3
  178. package/docs/docs/cmd/spo/user/user-ensure.md +109 -0
  179. package/docs/docs/cmd/teams/channel/channel-get.md +1 -1
  180. package/docs/docs/cmd/teams/channel/channel-member-add.md +2 -2
  181. package/docs/docs/cmd/teams/message/message-get.md +39 -4
  182. package/docs/docs/cmd/teams/message/message-list.md +41 -6
  183. package/docs/docs/cmd/teams/message/message-reply-list.md +39 -4
  184. package/docs/docs/cmd/teams/messagingsettings/messagingsettings-list.md +20 -2
  185. package/docs/docs/cmd/teams/messagingsettings/messagingsettings-set.md +8 -8
  186. package/docs/docs/cmd/teams/report/report-deviceusagedistributionusercounts.md +12 -5
  187. package/docs/docs/cmd/teams/report/report-deviceusageusercounts.md +13 -6
  188. package/docs/docs/cmd/teams/report/report-deviceusageuserdetail.md +14 -7
  189. package/docs/docs/cmd/teams/report/report-directroutingcalls.md +13 -6
  190. package/docs/docs/cmd/teams/report/report-pstncalls.md +13 -6
  191. package/docs/docs/cmd/teams/report/report-useractivitycounts.md +13 -6
  192. package/docs/docs/cmd/teams/report/report-useractivityusercounts.md +13 -6
  193. package/docs/docs/cmd/teams/report/report-useractivityuserdetail.md +13 -6
  194. package/docs/docs/cmd/teams/tab/tab-add.md +16 -0
  195. package/docs/docs/cmd/teams/tab/tab-get.md +17 -0
  196. package/docs/docs/cmd/teams/tab/tab-list.md +19 -0
  197. package/docs/docs/cmd/teams/team/team-add.md +77 -8
  198. package/docs/docs/cmd/teams/team/team-app-list.md +18 -2
  199. package/docs/docs/cmd/teams/team/team-archive.md +2 -2
  200. package/docs/docs/cmd/teams/team/team-clone.md +8 -8
  201. package/docs/docs/cmd/teams/team/team-get.md +34 -4
  202. package/docs/docs/cmd/teams/team/team-list.md +34 -3
  203. package/docs/docs/cmd/teams/team/team-remove.md +3 -3
  204. package/docs/docs/cmd/teams/team/team-set.md +8 -8
  205. package/docs/docs/cmd/teams/team/team-unarchive.md +3 -2
  206. package/docs/docs/cmd/teams/user/user-app-add.md +3 -3
  207. package/docs/docs/cmd/teams/user/user-app-list.md +18 -2
  208. package/docs/docs/cmd/teams/user/user-app-remove.md +4 -4
  209. package/docs/docs/cmd/teams/user/user-list.md +21 -4
  210. package/docs/docs/cmd/todo/task/task-add.md +47 -2
  211. package/npm-shrinkwrap.json +279 -194
  212. package/package.json +15 -14
@@ -15,13 +15,13 @@ m365 spo knowledgehub set [options]
15
15
 
16
16
  --8<-- "docs/cmd/_global.md"
17
17
 
18
- !!! important
19
- To use this command you have to have permissions to access the tenant admin site.
20
-
21
18
  ## Remarks
22
19
 
23
20
  If the specified url doesn't refer to an existing site collection, you will get a `404 - "404 FILE NOT FOUND"` error.
24
21
 
22
+ !!! important
23
+ To use this command you have to have permissions to access the tenant admin site.
24
+
25
25
  ## Examples
26
26
 
27
27
  Sets the Knowledge Hub Site for your tenant.
@@ -13,8 +13,8 @@ m365 spo list add [options]
13
13
  `-t, --title <title>`
14
14
  : Title of the list to add.
15
15
 
16
- `--baseTemplate <baseTemplate>`
17
- : The list definition type on which the list is based. Allowed values `Announcements`, `Contacts`, `CustomGrid`, `DataSources`,`DiscussionBoard`, `DocumentLibrary`, `Events`, `GanttTasks`, `GenericList`, `IssuesTracking`, `Links`, `NoCodeWorkflows`,`PictureLibrary`, `Survey`, `Tasks`, `WebPageLibrary`, `WorkflowHistory`, `WorkflowProcess`, `XmlForm`. Default `GenericList`.
16
+ `--baseTemplate [baseTemplate]`
17
+ : The list definition type on which the list is based. Allowed values `Announcements`, `Contacts`, `CustomGrid`, `DataSources`,`DiscussionBoard`, `DocumentLibrary`, `Events`, `GanttTasks`, `GenericList`, `IssuesTracking`, `Links`, `NoCodeWorkflows`,`PictureLibrary`, `Survey`, `Tasks`, `WebPageLibrary`, `WorkflowHistory`, `WorkflowProcess`, `XmlForm`. Default value is `GenericList`.
18
18
 
19
19
  `-u, --webUrl <webUrl>`
20
20
  : URL of the site where the list should be added.
@@ -59,7 +59,7 @@ m365 spo list set [options]
59
59
  : Property for assigning or retrieving grid editing on the list. Valid values are `true`, `false`.
60
60
 
61
61
  `--draftVersionVisibility [draftVersionVisibility]`
62
- : Value that specifies the minimum permission required to view minor versions and drafts within the list. Allowed values `Reader`, `Author`, `Approver`. Default `Reader`.
62
+ : Value that specifies the minimum permission required to view minor versions and drafts within the list. Allowed values `Reader`, `Author`, `Approver`.
63
63
 
64
64
  `--emailAlias [emailAlias]`
65
65
  : If e-mail notification is enabled, gets or sets the e-mail address to use tonotify to the owner of an item when an assignment has changed or the item has been updated.
@@ -137,7 +137,7 @@ m365 spo list set [options]
137
137
  : Indicates whether this list should be treated as a top level navigation object or not.
138
138
 
139
139
  `--listExperienceOptions [listExperienceOptions]`
140
- : Gets or sets the list experience for the list. Allowed values `Auto`, `NewExperience`, `ClassicExperience`. Default `Auto`.
140
+ : Gets or sets the list experience for the list. Allowed values `Auto`, `NewExperience`, `ClassicExperience`.
141
141
 
142
142
  `--majorVersionLimit [majorVersionLimit]`
143
143
  : Gets or sets the maximum number of major versions allowed for an item in a document library that uses version control with major versions only.
@@ -59,7 +59,7 @@ m365 spo listitem add --listTitle "Demo List" --webUrl https://contoso.sharepoin
59
59
  Add an item with Title _Demo Multi Person Field_ and a multi-select people field named _MultiPeopleField_ to list with title _Demo List_ in site _https://contoso.sharepoint.com/sites/project-x_
60
60
 
61
61
  ```sh
62
- m365 spo listitem add --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --Title "Demo Multi Person Field" --MultiPeopleField "[{'Key':'i:0#.f|membership|markh@conotoso.com'},{'Key':'i:0#.f|membership|adamb@conotoso.com'}]"
62
+ m365 spo listitem add --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --Title "Demo Multi Person Field" --MultiPeopleField "[{'Key':'i:0#.f|membership|markh@conotoso.com'},{'Key':'i:0#.f|membership|john.doe@conotoso.com'}]"
63
63
  ```
64
64
 
65
65
  Add an item with Title _Demo Hyperlink Field_ and a hyperlink field named _CustomHyperlink_ to list with title _Demo List_ in site _https://contoso.sharepoint.com/sites/project-x_
@@ -53,7 +53,7 @@ A sample CSV can be found below. The first line of the CSV-file should contain t
53
53
 
54
54
  ```csv
55
55
  ContentType,Title,SingleChoiceField,MultiChoiceField,SingleMetadataField,MultiMetadataField,SinglePeopleField,MultiPeopleField,CustomHyperlink,NumberField
56
- Item,Title A,Choice 1,Choice 1;#Choice 2,Engineering|4a3cc5f3-a4a6-433e-a07a-746978ff1760;,Engineering|4a3cc5f3-a4a6-433e-a07a-746978ff1760;Finance|f994a4ac-cf34-448e-a22c-2b35fd9bbffa;,[{'Key':'i:0#.f|membership|markh@contoso.com'}],"[{'Key':'i:0#.f|membership|markh@contoso.com'},{'Key':'i:0#.f|membership|adamb@contoso.com'}]","https://bing.com, URL",5
56
+ Item,Title A,Choice 1,Choice 1;#Choice 2,Engineering|4a3cc5f3-a4a6-433e-a07a-746978ff1760;,Engineering|4a3cc5f3-a4a6-433e-a07a-746978ff1760;Finance|f994a4ac-cf34-448e-a22c-2b35fd9bbffa;,[{'Key':'i:0#.f|membership|markh@contoso.com'}],"[{'Key':'i:0#.f|membership|markh@contoso.com'},{'Key':'i:0#.f|membership|john.doe@contoso.com'}]","https://bing.com, URL",5
57
57
  ```
58
58
 
59
59
  ## Response
@@ -62,7 +62,7 @@ m365 spo listitem set --listTitle "Demo List" --id 147 --webUrl https://contoso.
62
62
  Update an item with id _147_ with Title _Demo Multi Person Field_ and a multi-select people field named _MultiPeopleField_ to list with title _Demo List_ in site _https://contoso.sharepoint.com/sites/project-x_
63
63
 
64
64
  ```sh
65
- m365 spo listitem set --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --Title "Demo Multi Person Field" --MultiPeopleField "[{'Key':'i:0#.f|membership|markh@conotoso.com'},{'Key':'i:0#.f|membership|adamb@conotoso.com'}]"
65
+ m365 spo listitem set --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --Title "Demo Multi Person Field" --MultiPeopleField "[{'Key':'i:0#.f|membership|markh@conotoso.com'},{'Key':'i:0#.f|membership|john.doe@conotoso.com'}]"
66
66
  ```
67
67
 
68
68
  Update the field _Title_ and _CustomHyperlink_ of an item with a specific id in a list retrieved by server-relative URL in a specific site
@@ -19,8 +19,8 @@ m365 spo navigation node add [options]
19
19
  `-t, --title <title>`
20
20
  : Navigation node title.
21
21
 
22
- `--url <url>`
23
- : Navigation node URL.
22
+ `--url [url]`
23
+ : Navigation node URL. When not specified a linkless label will be created.
24
24
 
25
25
  `--parentNodeId [parentNodeId]`
26
26
  : ID of the node below which the node should be added. Specify either `location` or `parentNodeId` but not both.
@@ -29,7 +29,7 @@ m365 spo navigation node add [options]
29
29
  : Set, if the navigation node points to an external URL.
30
30
 
31
31
  `--audienceIds [audienceIds]`
32
- : Comma separated list of group IDs that will be used for audience targeting. The limit is 10 ids per navigation node.
32
+ : Comma-separated list of group IDs that will be used for audience targeting. The limit is 10 ids per navigation node.
33
33
 
34
34
  --8<-- "docs/cmd/_global.md"
35
35
 
@@ -20,10 +20,10 @@ m365 spo navigation node set [options]
20
20
  : New title of the navigation node.
21
21
 
22
22
  `--url [url]`
23
- : New URL of the navigation node.
23
+ : New URL of the navigation node. Specify an empty string `""` to update the navigation label to a linkless label.
24
24
 
25
25
  `--audienceIds [audienceIds]`
26
- : Comma separated list of group IDs that will be used for audience targeting. Speficy an empty string `""` to clear this value. The limit is 10 ids per navigation node.
26
+ : Comma-separated list of group IDs that will be used for audience targeting. Speficy an empty string `""` to clear this value. The limit is 10 ids per navigation node.
27
27
 
28
28
  `--isExternal [isExternal]`
29
29
  : Whether the navigation node points to an external URL. Valid values: `true` or `false`.
@@ -21,6 +21,8 @@ m365 spo orgassetslibrary add [options]
21
21
 
22
22
  --8<-- "docs/cmd/_global.md"
23
23
 
24
+ ## Remarks
25
+
24
26
  !!! important
25
27
  To use this command you have to have permissions to access the tenant admin site.
26
28
 
@@ -12,6 +12,8 @@ m365 spo orgassetslibrary list [options]
12
12
 
13
13
  --8<-- "docs/cmd/_global.md"
14
14
 
15
+ ## Remarks
16
+
15
17
  !!! important
16
18
  To use this command you have to have permissions to access the tenant admin site.
17
19
 
@@ -18,6 +18,8 @@ m365 spo orgassetslibrary remove [options]
18
18
 
19
19
  --8<-- "docs/cmd/_global.md"
20
20
 
21
+ ## Remarks
22
+
21
23
  !!! important
22
24
  To use this command you have to have permissions to access the tenant admin site.
23
25
 
@@ -12,6 +12,8 @@ m365 spo orgnewssite list [options]
12
12
 
13
13
  --8<-- "docs/cmd/_global.md"
14
14
 
15
+ ## Remarks
16
+
15
17
  !!! important
16
18
  To use this command you have to have permissions to access the tenant admin site.
17
19
 
@@ -18,6 +18,8 @@ m365 spo orgnewssite remove [options]
18
18
 
19
19
  --8<-- "docs/cmd/_global.md"
20
20
 
21
+ ## Remarks
22
+
21
23
  !!! important
22
24
  To use this command you have to have permissions to access the tenant admin site.
23
25
 
@@ -15,13 +15,13 @@ m365 spo orgnewssite set [options]
15
15
 
16
16
  --8<-- "docs/cmd/_global.md"
17
17
 
18
- !!! important
19
- To use this command you have to have permissions to access the tenant admin site.
20
-
21
18
  ## Remarks
22
19
 
23
20
  Using the `-u, --url` option you can specify which site to add to the list of organizational news sites.
24
21
 
22
+ !!! important
23
+ To use this command you have to have permissions to access the tenant admin site.
24
+
25
25
  ## Examples
26
26
 
27
27
  Set a site as an organizational news site
@@ -15,6 +15,8 @@ m365 spo site appcatalog add [options]
15
15
 
16
16
  --8<-- "docs/cmd/_global.md"
17
17
 
18
+ ## Remarks
19
+
18
20
  !!! important
19
21
  To use this command you have to have permissions to access the tenant admin site.
20
22
 
@@ -15,13 +15,13 @@ m365 spo site appcatalog remove [options]
15
15
 
16
16
  --8<-- "docs/cmd/_global.md"
17
17
 
18
- !!! important
19
- To use this command you have to have permissions to access the tenant admin site.
20
-
21
18
  ## Remarks
22
19
 
23
20
  While the command uses the term *'remove'*, like its equivalent PowerShell cmdlet, it does not remove the special library **Apps for SharePoint** from the site collection. Instead, it disables the site collection app catalog in that site. Packages deployed to the app catalog are not available within the site collection.
24
21
 
22
+ !!! important
23
+ To use this command you have to have permissions to access the tenant admin site.
24
+
25
25
  ## Examples
26
26
 
27
27
  Remove the site collection app catalog from specified site
@@ -18,6 +18,8 @@ m365 spo site commsite enable [options]
18
18
 
19
19
  --8<-- "docs/cmd/_global.md"
20
20
 
21
+ ## Remarks
22
+
21
23
  !!! important
22
24
  To use this command you have to have permissions to access the tenant admin site.
23
25
 
@@ -27,15 +27,15 @@ m365 spo site list [options]
27
27
 
28
28
  --8<-- "docs/cmd/_global.md"
29
29
 
30
- !!! important
31
- To use this command you have to have permissions to access the tenant admin site.
32
-
33
30
  ## Remarks
34
31
 
35
32
  Using the `-f, --filter` option you can specify which sites you want to retrieve. For example, to get sites with _project_ in their URL, use `Url -like 'project'` as the filter.
36
33
 
37
34
  When using the text output type, the command lists only the values of the `Title`, and `Url` properties of the site. When setting the output type to JSON, all available properties are included in the command output.
38
35
 
36
+ !!! important
37
+ To use this command you have to have permissions to access the tenant admin site.
38
+
39
39
  ## Examples
40
40
 
41
41
  List all sites in the currently connected tenant
@@ -27,9 +27,6 @@ m365 spo site remove [options]
27
27
 
28
28
  --8<-- "docs/cmd/_global.md"
29
29
 
30
- !!! important
31
- To use this command you have to have permissions to access the tenant admin site.
32
-
33
30
  ## Remarks
34
31
 
35
32
  Deleting a site collection is by default asynchronous and depending on the current state of Microsoft 365, might take up to few minutes. If you're building a script with steps that require the site to be fully deleted, you should use the `--wait` flag. When using this flag, the `spo site remove` command will keep running until it received confirmation from Microsoft 365 that the site has been fully deleted.
@@ -38,6 +35,9 @@ If the site which you have selected to remove is groupified (Modern Team Site) a
38
35
 
39
36
  If the argument `--fromRecycleBin` is passed, the selected site will be permanently removed even if it's a groupified one.
40
37
 
38
+ !!! important
39
+ To use this command you have to have permissions to access the tenant admin site.
40
+
41
41
  ## Examples
42
42
 
43
43
  Remove the specified site and place it in the Recycle Bin
@@ -30,13 +30,13 @@ m365 spo site rename [options]
30
30
 
31
31
  --8<-- "docs/cmd/_global.md"
32
32
 
33
- !!! important
34
- To use this command you must have permissions to access the tenant admin site.
35
-
36
33
  ## Remarks
37
34
 
38
35
  Renaming site collections is by default asynchronous and depending on the current state of Microsoft 365, might take up to few minutes. If you're building a script with steps that require the operation to complete fully, you should use the `--wait` flag. When using this flag, the `spo site rename` command will keep running until it receives confirmation from Microsoft 365 that the site rename operation has completed.
39
36
 
37
+ !!! important
38
+ To use this command you must have permissions to access the tenant admin site.
39
+
40
40
  ## Examples
41
41
 
42
42
  Starts the rename of the site collection with name "samplesite" to "renamed" without modifying the title
@@ -69,9 +69,6 @@ m365 spo site set [options]
69
69
 
70
70
  --8<-- "docs/cmd/_global.md"
71
71
 
72
- !!! important
73
- To use this command you have to have permissions to access the tenant admin site.
74
-
75
72
  ## Remarks
76
73
 
77
74
  If the specified url doesn't refer to an existing site collection, you will get a `404 - "404 FILE NOT FOUND"` error.
@@ -94,6 +91,9 @@ For more information on configuring no script sites see [https://support.office.
94
91
 
95
92
  Setting site properties is by default asynchronous and depending on the current state of Microsoft 365, might take up to few minutes. If you're building a script with steps that require the site to be fully configured, you should use the `--wait` flag. When using this flag, the `spo site set` command will keep running until it received confirmation from Microsoft 365 that the site has been fully configured.
96
93
 
94
+ !!! important
95
+ To use this command you have to have permissions to access the tenant admin site.
96
+
97
97
  ## Examples
98
98
 
99
99
  Update site collection's classification
@@ -159,13 +159,13 @@ m365 spo site set --url https://contoso.sharepoint.com/sites/sales --sharingCapa
159
159
  Set the logo on the site
160
160
 
161
161
  ```sh
162
- m365 spo site set --url https://estruyfdev2.sharepoint.com/sites/sales --siteLogoUrl "/sites/sales/SiteAssets/parker-ms-1200.png"
162
+ m365 spo site set --url https://contoso.sharepoint.com/sites/sales --siteLogoUrl "/sites/sales/SiteAssets/parker-ms-1200.png"
163
163
  ```
164
164
 
165
165
  Unset the logo on the site
166
166
 
167
167
  ```sh
168
- m365 spo site set --url https://estruyfdev2.sharepoint.com/sites/sales --siteLogoUrl ""
168
+ m365 spo site set --url https://contoso.sharepoint.com/sites/sales --siteLogoUrl ""
169
169
  ```
170
170
 
171
171
  Lock the site preventing users from accessing it. Wait for the configuration to complete
@@ -21,13 +21,13 @@ m365 spo storageentity remove [options]
21
21
 
22
22
  --8<-- "docs/cmd/_global.md"
23
23
 
24
- !!! important
25
- To use this command you have to have permissions to access the tenant admin site.
26
-
27
24
  ## Remarks
28
25
 
29
26
  Tenant properties are stored in the app catalog site associated with that tenant. To remove a property, you have to specify the absolute URL of the app catalog site. If you specify the URL of a site different than the app catalog, you will get an access denied error.
30
27
 
28
+ !!! important
29
+ To use this command you have to have permissions to access the tenant admin site.
30
+
31
31
  ## Examples
32
32
 
33
33
  Remove the _AnalyticsId_ tenant property. Yields a confirmation prompt before actually removing the property
@@ -27,15 +27,15 @@ m365 spo storageentity set [options]
27
27
 
28
28
  --8<-- "docs/cmd/_global.md"
29
29
 
30
- !!! important
31
- To use this command you have to have permissions to access the tenant admin site.
32
-
33
30
  ## Remarks
34
31
 
35
32
  Tenant properties are stored in the app catalog site associated with that tenant. To set a property, you have to specify the absolute URL of the app catalog site without a trailing slash. If you specify the URL with trailing slash you get the error `The managed path sites/apps is not a managed path in this tenant.`
36
33
 
37
34
  If you specify the URL of a site different than the app catalog, you will get an access denied error.
38
35
 
36
+ !!! important
37
+ To use this command you have to have permissions to access the tenant admin site.
38
+
39
39
  ## Examples
40
40
 
41
41
  Set _123_ as the value of the _AnalyticsId_ tenant property. Also include a description and a comment for additional clarification of the usage of the property.
@@ -27,9 +27,6 @@ m365 spo tenant appcatalog add [options]
27
27
 
28
28
  --8<-- "docs/cmd/_global.md"
29
29
 
30
- !!! important
31
- To use this command you have to have permissions to access the tenant admin site.
32
-
33
30
  ## Remarks
34
31
 
35
32
  If there is an app catalog registered in your tenant, creating a new app catalog using this command will fail, unless you use the `force` option.
@@ -38,6 +35,9 @@ If you use the `force` option, and either the app catalog or the site at the spe
38
35
 
39
36
  Creating an app catalog site might take a while. If you need to wait for the site to be created before continuing, use the `wait` option.
40
37
 
38
+ !!! important
39
+ To use this command you have to have permissions to access the tenant admin site.
40
+
41
41
  ## Examples
42
42
 
43
43
  Creates new app catalog. Will fail if another app catalog or site at the specified URL exists
@@ -12,6 +12,8 @@ m365 spo tenant appcatalogurl get [options]
12
12
 
13
13
  --8<-- "docs/cmd/_global.md"
14
14
 
15
+ ## Remarks
16
+
15
17
  !!! important
16
18
  To use this command you have to have permissions to access the tenant admin site.
17
19
 
@@ -24,9 +24,6 @@ m365 spo tenant applicationcustomizer add [options]
24
24
 
25
25
  --8<-- "docs/cmd/_global.md"
26
26
 
27
- !!! important
28
- To use this command, you need to be a SharePoint Admin.
29
-
30
27
  ## Remarks
31
28
 
32
29
  Running this command from the Windows Command Shell (cmd.exe) or PowerShell for Windows OS XP, 7, 8, 8.1 without bash installed might require additional formatting for command options that have JSON, XML or JavaScript values because the command shell treat quotes differently. For example, this is how ApplicationCustomizer user custom action can be created from the Windows cmd.exe:
@@ -40,6 +37,9 @@ Note, how the clientSideComponentProperties option has escaped double quotes `'{
40
37
  !!! warning "Escaping JSON in PowerShell"
41
38
  When using the `--clientSideComponentProperties` option it's possible to enter a JSON string. In PowerShell 5 to 7.2 [specific escaping rules](./../../../user-guide/using-cli.md#escaping-double-quotes-in-powershell) apply due to an issue. Remember that you can also use [file tokens](./../../../user-guide/using-cli.md#passing-complex-content-into-cli-options) instead.
42
39
 
40
+ !!! important
41
+ To use this command, you need to be a SharePoint Admin.
42
+
43
43
  ## Examples
44
44
 
45
45
  Adds an application customizer that's deployed tenant wide
@@ -0,0 +1,142 @@
1
+ # spo tenant applicationcustomizer get
2
+
3
+ Get an application customizer that is installed tenant wide
4
+
5
+ ## Usage
6
+
7
+ ```sh
8
+ spo tenant applicationcustomizer get [options]
9
+ ```
10
+
11
+ ## Options
12
+
13
+ `-t, --title [title]`
14
+ : The title of the application customizer. Specify either `title`, `id`, or `clientSideComponentId`.
15
+
16
+ `-i, --id [id]`
17
+ : The product id of the application customizer. Specify either `title`, `id`, or `clientSideComponentId`.
18
+
19
+ `-c, --clientSideComponentId [clientSideComponentId]`
20
+ : The Client Side Component Id (GUID) of the application customizer. Specify either `title`, `id`, or `clientSideComponentId`.
21
+
22
+ --8<-- "docs/cmd/_global.md"
23
+
24
+ ## Examples
25
+
26
+ Retrieves an application customizer by title.
27
+
28
+ ```sh
29
+ m365 spo tenant applicationcustomizer get --title "Some customizer"
30
+ ```
31
+
32
+ Retrieves an application customizer by id.
33
+
34
+ ```sh
35
+ m365 spo tenant applicationcustomizer get --id 14125658-a9bc-4ddf-9c75-1b5767c9a337
36
+ ```
37
+
38
+ Retrieves an application customizer by clientSideComponentId.
39
+
40
+ ```sh
41
+ m365 spo tenant applicationcustomizer get --clientSideComponentId 7096cded-b83d-4eab-96f0-df477ed7c0bc
42
+ ```
43
+
44
+ ## Response
45
+
46
+ === "JSON"
47
+
48
+ ```json
49
+ {
50
+ "FileSystemObjectType": 0,
51
+ "Id": 4,
52
+ "ServerRedirectedEmbedUri": null,
53
+ "ServerRedirectedEmbedUrl": "",
54
+ "ContentTypeId": "0x00693E2C487575B448BD420C12CEAE7EFE",
55
+ "Title": "Some customizer",
56
+ "Modified": "2023-01-11T15:47:38Z",
57
+ "Created": "2023-01-11T15:47:38Z",
58
+ "AuthorId": 9,
59
+ "EditorId": 9,
60
+ "OData__UIVersionString": "1.0",
61
+ "Attachments": false,
62
+ "GUID": "14125658-a9bc-4ddf-9c75-1b5767c9a337",
63
+ "ComplianceAssetId": null,
64
+ "TenantWideExtensionComponentId": "7096cded-b83d-4eab-96f0-df477ed7c0bc",
65
+ "TenantWideExtensionComponentProperties": "{\"testMessage\":\"Test message\"}",
66
+ "TenantWideExtensionWebTemplate": null,
67
+ "TenantWideExtensionListTemplate": 0,
68
+ "TenantWideExtensionLocation": "ClientSideExtension.ApplicationCustomizer",
69
+ "TenantWideExtensionSequence": 0,
70
+ "TenantWideExtensionHostProperties": null,
71
+ "TenantWideExtensionDisabled": false
72
+ }
73
+ ```
74
+
75
+ === "Text"
76
+
77
+ ```text
78
+ Attachments : false
79
+ AuthorId : 9
80
+ ComplianceAssetId : null
81
+ ContentTypeId : 0x00693E2C487575B448BD420C12CEAE7EFE
82
+ Created : 2023-01-11T15:47:38Z
83
+ EditorId : 9
84
+ FileSystemObjectType : 0
85
+ GUID : 14125658-a9bc-4ddf-9c75-1b5767c9a337
86
+ Id : 4
87
+ Modified : 2023-01-11T15:47:38Z
88
+ OData__UIVersionString : 1.0
89
+ ServerRedirectedEmbedUri : null
90
+ ServerRedirectedEmbedUrl :
91
+ TenantWideExtensionComponentId : 7096cded-b83d-4eab-96f0-df477ed7c0bc
92
+ TenantWideExtensionComponentProperties: {"testMessage":"Test message"}
93
+ TenantWideExtensionDisabled : false
94
+ TenantWideExtensionHostProperties : null
95
+ TenantWideExtensionListTemplate : 0
96
+ TenantWideExtensionLocation : ClientSideExtension.ApplicationCustomizer
97
+ TenantWideExtensionSequence : 0
98
+ TenantWideExtensionWebTemplate : null
99
+ Title : Some customizer
100
+ ```
101
+
102
+ === "CSV"
103
+
104
+ ```csv
105
+ FileSystemObjectType,Id,ServerRedirectedEmbedUri,ServerRedirectedEmbedUrl,ContentTypeId,Title,Modified,Created,AuthorId,EditorId,OData__UIVersionString,Attachments,GUID,ComplianceAssetId,TenantWideExtensionComponentId,TenantWideExtensionComponentProperties,TenantWideExtensionWebTemplate,TenantWideExtensionListTemplate,TenantWideExtensionLocation,TenantWideExtensionSequence,TenantWideExtensionHostProperties,TenantWideExtensionDisabled
106
+ 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,,
107
+ ```
108
+
109
+ === "Markdown"
110
+
111
+ ```md
112
+ # spo tenant applicationcustomizer get --title "Some customizer"
113
+
114
+ Date: 1/13/2023
115
+
116
+ ## Some customizer (4)
117
+
118
+ Property | Value
119
+ ---------|-------
120
+ FileSystemObjectType | 0
121
+ Id | 4
122
+ ServerRedirectedEmbedUri | null
123
+ ServerRedirectedEmbedUrl |
124
+ ContentTypeId | 0x00693E2C487575B448BD420C12CEAE7EFE
125
+ Title | Some customizer
126
+ Modified | 2023-01-11T15:47:38Z
127
+ Created | 2023-01-11T15:47:38Z
128
+ AuthorId | 9
129
+ EditorId | 9
130
+ OData\_\_UIVersionString | 1.0
131
+ Attachments | false
132
+ GUID | 14125658-a9bc-4ddf-9c75-1b5767c9a337
133
+ ComplianceAssetId | null
134
+ TenantWideExtensionComponentId | 7096cded-b83d-4eab-96f0-df477ed7c0bc
135
+ TenantWideExtensionComponentProperties | {"testMessage":"Test message"}
136
+ TenantWideExtensionWebTemplate | null
137
+ TenantWideExtensionListTemplate | 0
138
+ TenantWideExtensionLocation | ClientSideExtension.ApplicationCustomizer
139
+ TenantWideExtensionSequence | 0
140
+ TenantWideExtensionHostProperties | null
141
+ TenantWideExtensionDisabled | false
142
+ ```
@@ -12,6 +12,8 @@ m365 spo tenant recyclebinitem list [options]
12
12
 
13
13
  --8<-- "docs/cmd/_global.md"
14
14
 
15
+ ## Remarks
16
+
15
17
  !!! important
16
18
  To use this command you have to have permissions to access the tenant admin site.
17
19
 
@@ -21,13 +21,13 @@ m365 spo tenant recyclebinitem remove [options]
21
21
 
22
22
  --8<-- "docs/cmd/_global.md"
23
23
 
24
- !!! important
25
- To use this command you have to have permissions to access the tenant admin site.
26
-
27
24
  ## Remarks
28
25
 
29
26
  Removing a site collection is by default asynchronous and depending on the current state of Microsoft 365, might take up to few minutes. If you're building a script with steps that require the site to be fully removed, you should use the `--wait` flag. When using this flag, the `m365 spo tenant recyclebinitem remove` command will keep running until it received confirmation from Microsoft 365 that the site has been fully removed.
30
27
 
28
+ !!! important
29
+ To use this command you have to have permissions to access the tenant admin site.
30
+
31
31
  ## Examples
32
32
 
33
33
  Removes the specified deleted site collection from tenant recycle bin
@@ -18,13 +18,13 @@ m365 spo tenant recyclebinitem restore [options]
18
18
 
19
19
  --8<-- "docs/cmd/_global.md"
20
20
 
21
- !!! important
22
- To use this command you have to have permissions to access the tenant admin site.
23
-
24
21
  ## Remarks
25
22
 
26
23
  Restoring deleted site collections is by default asynchronous and depending on the current state of Microsoft 365, might take up to few minutes. If you're building a script with steps that require the site to be fully restored, you should use the `--wait` flag. When using this flag, the `spo tenant recyclebinitem restore` command will keep running until it received confirmation from Microsoft 365 that the site has been fully restored.
27
24
 
25
+ !!! important
26
+ To use this command you have to have permissions to access the tenant admin site.
27
+
28
28
  ## Examples
29
29
 
30
30
  Restore a deleted site collection from tenant recycle bin
@@ -12,6 +12,8 @@ m365 spo tenant settings list [options]
12
12
 
13
13
  --8<-- "docs/cmd/_global.md"
14
14
 
15
+ ## Remarks
16
+
15
17
  !!! important
16
18
  To use this command you have to have permissions to access the tenant admin site.
17
19