@pnp/cli-microsoft365 6.9.0-beta.bb31388 → 6.9.0-beta.cdf4be7

package/docs/docs/cmd/spo/site/site-recyclebinitem-restore.mdx

@@ -12,7 +12,7 @@ m365 spo site recyclebinitem restore [options]
 
 ## Options
 
-```md defintion-list
+```md definition-list
 `-u, --siteUrl <siteUrl>`
 : URL of the site for which to restore the recycle bin items
 

package/docs/docs/cmd/spo/site/site-remove.mdx

@@ -12,7 +12,7 @@ m365 spo site remove [options]
 
 ## Options
 
-```md defintion-list
+```md definition-list
 `-u, --url <url>`
 : URL of the site to remove
 

package/docs/docs/cmd/spo/site/site-rename.mdx

@@ -12,7 +12,7 @@ m365 spo site rename [options]
 
 ## Options
 
-```md defintion-list
+```md definition-list
 `-u, --url <url>`
 : The URL of the site to rename
 

package/docs/docs/cmd/spo/site/site-set.mdx

@@ -12,7 +12,7 @@ m365 spo site set [options]
 
 ## Options
 
-```md defintion-list
+```md definition-list
 `-u, --url <url>`
 : The URL of the site collection to update
 

package/docs/docs/cmd/spo/sitedesign/sitedesign-add.mdx

@@ -12,7 +12,7 @@ m365 spo sitedesign add [options]
 
 ## Options
 
-```md defintion-list
+```md definition-list
 `-t, --title <title>`
 : The display name of the site design
 

package/docs/docs/cmd/spo/sitedesign/sitedesign-apply.mdx

@@ -12,7 +12,7 @@ m365 spo sitedesign apply [options]
 
 ## Options
 
-```md defintion-list
+```md definition-list
 `-i, --id <id>`
 : The ID of the site design to apply
 

package/docs/docs/cmd/spo/sitedesign/sitedesign-get.mdx

@@ -12,7 +12,7 @@ m365 spo sitedesign get [options]
 
 ## Options
 
-```md defintion-list
+```md definition-list
 `-i, --id [id]`
 : Site design ID. Specify either `id` or `title` but not both.
 

package/docs/docs/cmd/spo/sitedesign/sitedesign-remove.mdx

@@ -12,7 +12,7 @@ m365 spo sitedesign remove [options]
 
 ## Options
 
-```md defintion-list
+```md definition-list
 `-i, --id <id>`
 : Site design ID
 

package/docs/docs/cmd/spo/sitedesign/sitedesign-rights-grant.mdx

@@ -12,7 +12,7 @@ m365 spo sitedesign rights grant [options]
 
 ## Options
 
-```md defintion-list
+```md definition-list
 `-i, --siteDesignId <siteDesignId>`
 : The ID of the site design to grant rights on
 

package/docs/docs/cmd/spo/sitedesign/sitedesign-rights-list.mdx

@@ -12,7 +12,7 @@ m365 spo sitedesign rights list [options]
 
 ## Options
 
-```md defintion-list
+```md definition-list
 `-i, --siteDesignId <siteDesignId>`
 : The ID of the site design to get rights information from
 ```

package/docs/docs/cmd/spo/sitedesign/sitedesign-rights-revoke.mdx

@@ -12,7 +12,7 @@ m365 spo sitedesign rights revoke [options]
 
 ## Options
 
-```md defintion-list
+```md definition-list
 `-i, --siteDesignId <siteDesignId>`
 : The ID of the site design to revoke rights from
 

package/docs/docs/cmd/spo/sitedesign/sitedesign-run-list.mdx

@@ -12,7 +12,7 @@ m365 spo sitedesign run list [options]
 
 ## Options
 
-```md defintion-list
+```md definition-list
 `-u, --webUrl <webUrl>`
 : The URL of the site for which to list applied site designs
 

package/docs/docs/cmd/spo/sitedesign/sitedesign-run-status-get.mdx

@@ -12,7 +12,7 @@ m365 spo sitedesign run status get [options]
 
 ## Options
 
-```md defintion-list
+```md definition-list
 `-u, --webUrl <webUrl>`
 : The URL of the site for which to get the information
 

package/docs/docs/cmd/spo/sitedesign/sitedesign-set.mdx

@@ -12,7 +12,7 @@ m365 spo sitedesign set [options]
 
 ## Options
 
-```md defintion-list
+```md definition-list
 `-i, --id <id>`
 : The ID of the site design to update
 

package/docs/docs/cmd/spo/sitedesign/sitedesign-task-get.mdx

@@ -12,7 +12,7 @@ m365 spo sitedesign task get [options]
 
 ## Options
 
-```md defintion-list
+```md definition-list
 `-i, --id <id>`
 : The ID of the site design task to get information for
 ```

package/docs/docs/cmd/spo/sitedesign/sitedesign-task-list.mdx

@@ -12,7 +12,7 @@ m365 spo sitedesign task list [options]
 
 ## Options
 
-```md defintion-list
+```md definition-list
 `-u, --webUrl <webUrl>`
 : The URL of the site for which to list site designs scheduled for execution
 ```

package/docs/docs/cmd/spo/sitedesign/sitedesign-task-remove.mdx

@@ -12,7 +12,7 @@ m365 spo sitedesign task remove [options]
 
 ## Options
 
-```md defintion-list
+```md definition-list
 `-i, --id <id>`
 : The ID of the site design task to remove
 

package/docs/docs/cmd/spo/sitescript/sitescript-add.mdx

@@ -12,7 +12,7 @@ m365 spo sitescript add [options]
 
 ## Options
 
-```md defintion-list
+```md definition-list
 `-t, --title <title>`
 : Site script title
 

package/docs/docs/cmd/spo/sitescript/sitescript-get.mdx

@@ -12,7 +12,7 @@ m365 spo sitescript get [options]
 
 ## Options
 
-```md defintion-list
+```md definition-list
 `-i, --id <id>`
 : Site script ID
 ```

package/docs/docs/cmd/spo/sitescript/sitescript-remove.mdx

@@ -12,7 +12,7 @@ m365 spo sitescript remove [options]
 
 ## Options
 
-```md defintion-list
+```md definition-list
 `-i, --id <id>`
 : Site script ID
 

package/docs/docs/cmd/spo/sitescript/sitescript-set.mdx

@@ -12,7 +12,7 @@ m365 spo sitescript set [options]
 
 ## Options
 
-```md defintion-list
+```md definition-list
 `-i, --id <id>`
 : Site script ID
 

package/docs/docs/cmd/spo/spo-search.mdx

@@ -14,7 +14,7 @@ m365 spo search [options]
 
 ## Options
 
-```md defintion-list
+```md definition-list
 `-q, --queryText <queryText>`
 : Query to be executed in KQL format
 

package/docs/docs/cmd/spo/spo-set.mdx

@@ -12,7 +12,7 @@ m365 spo set [options]
 
 ## Options
 
-```md defintion-list
+```md definition-list
 `-u, --url <url>`
 : The URL of the root SharePoint site collection to use in SPO commands
 ```

package/docs/docs/cmd/spo/storageentity/storageentity-get.mdx

@@ -12,7 +12,7 @@ m365 spo storageentity get [options]
 
 ## Options
 
-```md defintion-list
+```md definition-list
 `-k, --key <key>`
 : Name of the tenant property to retrieve
 ```

package/docs/docs/cmd/spo/storageentity/storageentity-list.mdx

@@ -12,7 +12,7 @@ m365 spo storageentity list [options]
 
 ## Options
 
-```md defintion-list
+```md definition-list
 `-u, --appCatalogUrl <appCatalogUrl>`
 : URL of the app catalog site
 ```

package/docs/docs/cmd/spo/storageentity/storageentity-remove.mdx

@@ -12,7 +12,7 @@ m365 spo storageentity remove [options]
 
 ## Options
 
-```md defintion-list
+```md definition-list
 `-u, --appCatalogUrl <appCatalogUrl>`
 : URL of the app catalog site
 

package/docs/docs/cmd/spo/storageentity/storageentity-set.mdx

@@ -12,7 +12,7 @@ m365 spo storageentity set [options]
 
 ## Options
 
-```md defintion-list
+```md definition-list
 `-u, --appCatalogUrl <appCatalogUrl>`
 : URL of the app catalog site
 

package/docs/docs/cmd/spo/tenant/tenant-appcatalog-add.mdx

@@ -12,7 +12,7 @@ m365 spo tenant appcatalog add [options]
 
 ## Options
 
-```md defintion-list
+```md definition-list
 `-u, --url <url>`
 : The absolute site url
 

package/docs/docs/cmd/spo/tenant/tenant-applicationcustomizer-add.mdx

@@ -12,7 +12,7 @@ m365 spo tenant applicationcustomizer add [options]
 
 ## Options
 
-```md defintion-list
+```md definition-list
 `-t, --title <title>`
 : The title of the Application Customizer.
 

package/docs/docs/cmd/spo/tenant/tenant-applicationcustomizer-get.mdx

@@ -14,7 +14,7 @@ spo tenant applicationcustomizer get [options]
 
 ## Options
 
-```md defintion-list
+```md definition-list
 `-t, --title [title]`
 : The title of the application customizer. Specify either `title`, `id`, or `clientSideComponentId`.
 

package/docs/docs/cmd/spo/tenant/tenant-applicationcustomizer-remove.mdx

@@ -12,7 +12,7 @@ spo tenant applicationcustomizer remove [options]
 
 ## Options
 
-```md defintion-list
+```md definition-list
 `-t, --title [title]`
 : The title of the Application Customizer. Specify either `title`, `id`, or `clientSideComponentId`.
 

package/docs/docs/cmd/spo/tenant/tenant-applicationcustomizer-set.mdx

@@ -0,0 +1,81 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spo tenant applicationcustomizer set
+
+Updates an Application Customizer that is deployed as a tenant-wide extension
+
+## Usage
+
+```sh
+m365 spo tenant applicationcustomizer set [options]
+```
+
+## Options
+
+```md definition-list
+`-t, --title [title]`
+: The title of the Application Customizer to update. Specify either `title`, `id` or `clientSideComponentId`.
+
+`-i, --id [id]`
+: The id of the Application Customizer to update. Specify either `title`, `id` or `clientSideComponentId`.
+
+`-c, --clientSideComponentId  [clientSideComponentId]`
+: The Client Side Component Id (GUID) of the Application Customizer to update. Specify either `title`, `id` or `clientSideComponentId`.
+
+`--newTitle [newTitle]`
+: The updated title of the Application Customizer.
+
+`-p, --clientSideComponentProperties [clientSideComponentProperties]`
+: The Client Side Component properties of the Application Customizer.
+
+`-w, --webTemplate [webTemplate]`
+: Optionally add a web template (e.g. STS#3, SITEPAGEPUBLISHING#0, etc) as a filter for what kind of sites the application customizer is registered on.
+```
+
+<Global />
+
+## Remarks
+
+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 clientSideComponentProperties option that has JSON value because the command shell treats quotes differently. For example, this is how Application Customizer can be updated from the Windows cmd.exe:
+
+```sh
+m365 spo tenant applicationcustomizer set --id 3 --clientSideComponentProperties '{\"someProperty\":\"Some value\"}'
+```
+
+Note, how the clientSideComponentProperties option (--clientSideComponentProperties) has escaped double quotes `'{\"someProperty\":\"Some value\"}'` compared to execution from bash `'{"someProperty": "Some value"}'`.
+
+:::caution Escaping JSON in PowerShell
+    
+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.mdx#escaping-double-quotes-in-powershell) apply due to an issue. Remember that you can also use [file tokens](./../../../user-guide/using-cli.mdx#passing-complex-content-into-cli-options) instead.
+
+:::
+
+## Examples
+
+Updates the title of an Application Customizer that is deployed as a tenant-wide extension by its id
+
+```sh
+m365 spo tenant applicationcustomizer set --id 3 --newTitle  "Some customizer" 
+```
+
+Updates the properties of an Application Customizer that is deployed as a tenant-wide extension by its id
+
+```sh
+m365 spo tenant applicationcustomizer set --id 3 --clientSideComponentProperties '{ "someProperty": "Some value" }'
+```
+
+Updates the title of an Application Customizer that is deployed as a tenant-wide extension by its title
+
+```sh
+m365 spo tenant applicationcustomizer set --title "Some customizer" --newTitle  "Updated customizer" 
+```
+
+Updates the title of an Application Customizer that is deployed as a tenant-wide extension by its clientSideComponentId
+
+```sh
+m365 spo tenant applicationcustomizer set --clientSideComponentId "7f8fd1f2-9d26-4a4a-a607-bf4622d7ec11" --newTitle  "Some customizer" 
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/tenant/tenant-commandset-add.mdx

@@ -0,0 +1,183 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spo tenant commandset add
+
+Add a ListView Command Set as a tenant-wide extension.
+
+## Usage
+
+```sh
+m365 spo tenant commandset add [options]
+```
+
+## Options
+
+```md defintion-list
+`-t, --title <title>`
+: The title of the ListView Command Set.
+
+`-l, --listType <listType>`
+: The list or library type to register the ListView Command Set on. Allowed values `List` or `Library`.
+
+`-i, --clientSideComponentId <clientSideComponentId>`
+: The Client Side Component Id (GUID) of the ListView Command Set.
+
+`-p, --clientSideComponentProperties [clientSideComponentProperties]`
+: The Client Side Component properties of the ListView Command Set.
+
+`-w, --webTemplate [webTemplate]`
+: Optionally add a web template (e.g. STS#3, SITEPAGEPUBLISHING#0, etc) as a filter for what kind of sites the ListView Command Set is registered on.
+
+`--location [location]`
+: The location of the ListView Command Set. Allowed values `ContextMenu`, `CommandBar` or `Both`. Defaults to `CommandBar`.
+```
+
+<Global />
+
+## Remarks
+
+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 treats quotes differently. For example, this is how commandset user custom action can be created from the Windows cmd.exe:
+
+```sh
+m365 spo tenant commandset add --title "YourAppCustomizer" --clientSideComponentId b41916e7-e69d-467f-b37f-ff8ecf8f99f2 --clientSideComponentProperties '{\"testMessage\":\"Test message\"}'
+```
+
+Note, how the clientSideComponentProperties option has escaped double quotes `'{\"testMessage\":\"Test message\"}'` compared to execution from bash `'{"testMessage":"Test message"}'`.
+
+:::caution Escaping JSON in PowerShell
+
+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.mdx#escaping-double-quotes-in-powershell) apply due to an issue. Remember that you can also use [file tokens](./../../../user-guide/using-cli.mdx#passing-complex-content-into-cli-options) instead.
+
+:::
+
+:::info
+
+To use this command, you need to be a SharePoint Admin.
+
+:::
+
+## Examples
+
+Adds a ListView Command Set that's deployed tenant wide to CommandBars of Lists.
+
+```sh
+m365 spo tenant commandset add --title "Some customizer" --clientSideComponentId  799883f5-7962-4384-a10a-105adaec6ffc --listType List
+```
+
+Adds a ListView Command Set that is configured to the context menu of communication site libraries.
+
+```sh
+m365 spo tenant commandset  add --title "Some customizer" --clientSideComponentId  799883f5-7962-4384-a10a-105adaec6ffc --webTemplate "SITEPAGEPUBLISHING#0" --listType Library --location ContextMenu
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "FileSystemObjectType": 0,
+    "Id": 4,
+    "ServerRedirectedEmbedUri": null,
+    "ServerRedirectedEmbedUrl": "",
+    "ID": 4,
+    "ContentTypeId": "0x00693E2C487575B448BD420C12CEAE7EFE",
+    "Title": "Some ListView Command Set",
+    "Modified": "2023-01-11T15:47:38Z",
+    "Created": "2023-01-11T15:47:38Z",
+    "AuthorId": 9,
+    "EditorId": 9,
+    "OData__UIVersionString": "1.0",
+    "Attachments": false,
+    "GUID": "14125658-a9bc-4ddf-9c75-1b5767c9a337",
+    "ComplianceAssetId": null,
+    "TenantWideExtensionComponentId": "7096cded-b83d-4eab-96f0-df477ed7c0bc",
+    "TenantWideExtensionComponentProperties": "{\"testMessage\":\"Test message\"}",
+    "TenantWideExtensionWebTemplate": null,
+    "TenantWideExtensionListTemplate": 101,
+    "TenantWideExtensionLocation": "ClientSideExtension.ListViewCommandSet.ContextMenu",
+    "TenantWideExtensionSequence": 0,
+    "TenantWideExtensionHostProperties": null,
+    "TenantWideExtensionDisabled": false
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  Attachments                           : false
+  AuthorId                              : 9
+  ComplianceAssetId                     : null
+  ContentTypeId                         : 0x00693E2C487575B448BD420C12CEAE7EFE
+  Created                               : 2023-01-11T15:47:38Z
+  EditorId                              : 9
+  FileSystemObjectType                  : 0
+  GUID                                  : 14125658-a9bc-4ddf-9c75-1b5767c9a337
+  Id                                    : 4
+  ID                                    : 4
+  Modified                              : 2023-01-11T15:47:38Z
+  OData__UIVersionString                : 1.0
+  ServerRedirectedEmbedUri              : null
+  ServerRedirectedEmbedUrl              :
+  TenantWideExtensionComponentId        : 7096cded-b83d-4eab-96f0-df477ed7c0bc
+  TenantWideExtensionComponentProperties: {"testMessage":"Test message"}
+  TenantWideExtensionDisabled           : false
+  TenantWideExtensionHostProperties     : null
+  TenantWideExtensionListTemplate       : 101
+  TenantWideExtensionLocation           : ClientSideExtension.ListViewCommandSet.ContextMenu
+  TenantWideExtensionSequence           : 0
+  TenantWideExtensionWebTemplate        : null
+  Title                                 : Some ListView Command Set
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  FileSystemObjectType,Id,ServerRedirectedEmbedUri,ServerRedirectedEmbedUrl,ID,ContentTypeId,Title,Modified,Created,AuthorId,EditorId,OData__UIVersionString,Attachments,GUID,ComplianceAssetId,TenantWideExtensionComponentId,TenantWideExtensionComponentProperties,TenantWideExtensionWebTemplate,TenantWideExtensionListTemplate,TenantWideExtensionLocation,TenantWideExtensionSequence,TenantWideExtensionHostProperties,TenantWideExtensionDisabled
+  0,4,,,4,0x00693E2C487575B448BD420C12CEAE7EFE,Some ListView Command Set,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""}",,101,ClientSideExtension.ListViewCommandSet.ContextMenu,0,,
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spo listitem add --webUrl "https://contoso.sharepoint.com/sites/appcatalog" --listUrl "/sites/appcatalog/Lists/TenantWideExtensions" --Title "Some ListView Command Set" --TenantWideExtensionComponentId "7096cded-b83d-4eab-96f0-df477ed7c0bc" --TenantWideExtensionLocation "ClientSideExtension.ListViewCommandSet.ContextMenu" --TenantWideExtensionSequence "0" --TenantWideExtensionListTemplate "101" --TenantWideExtensionComponentProperties "{"testMessage":"Test message"}" --TenantWideExtensionWebTemplate "" --TenantWideExtensionDisabled "false" --verbose "false" --debug "false" --_ ""
+
+  Date: 1/13/2023
+
+  ## Some ListView Command Set (4)
+
+  Property | Value
+  ---------|-------
+  FileSystemObjectType | 0
+  Id | 4
+  ServerRedirectedEmbedUri | null
+  ServerRedirectedEmbedUrl |
+  ID | 4
+  ContentTypeId | 0x00693E2C487575B448BD420C12CEAE7EFE
+  Title | Some customizer
+  Modified | 2023-01-11T15:47:38Z
+  Created | 2023-01-11T15:47:38Z
+  AuthorId | 9
+  EditorId | 9
+  OData\_\_UIVersionString | 1.0
+  Attachments | false
+  GUID | 14125658-a9bc-4ddf-9c75-1b5767c9a337
+  ComplianceAssetId | null
+  TenantWideExtensionComponentId | 7096cded-b83d-4eab-96f0-df477ed7c0bc
+  TenantWideExtensionComponentProperties | {"testMessage":"Test message"}
+  TenantWideExtensionWebTemplate | null
+  TenantWideExtensionListTemplate | 101
+  TenantWideExtensionLocation | ClientSideExtension.ListViewCommandSet.ContextMenu
+  TenantWideExtensionSequence | 0
+  TenantWideExtensionHostProperties | null
+  TenantWideExtensionDisabled | false
+  ```
+
+  </TabItem>
+</Tabs>