@pnp/cli-microsoft365 6.9.0-beta.f6054b4 → 6.10.0-beta.6bf4ff9

package/docs/docs/cmd/spo/list/list-sensitivitylabel-ensure.mdx

@@ -0,0 +1,73 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spo list sensitivitylabel ensure
+
+Applies a default sensitivity label to the specified document library
+
+## Usage
+
+```sh
+m365 spo list sensitivitylabel ensure [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: The URL of the site where the library is located.
+
+`-n, --name [name]`
+: The label name to apply to the list. Specify either `name` or `id`, but not both.
+
+`-i, --id [id]`
+: The Id of the label to apply to the list. Specify either `name` or `id`, but not both.
+
+`-t, --listTitle [listTitle]`
+: The title of the library on which to apply the label. Specify either `listTitle`, `listId`, or `listUrl` but not multiple.
+
+`-l, --listId [listId]`
+: The ID of the library on which to apply the label. Specify either `listTitle`, `listId`, or `listUrl` but not multiple.
+
+`--listUrl [listUrl]`
+: Server- or web-relative URL of the library on which to apply the label. Specify either `listTitle`, `listId`, or `listUrl` but not multiple.
+```
+
+<Global />
+
+## Remarks
+
+:::caution
+
+This command is based on an API that is currently in preview and is subject to change once the API reaches general availability.
+
+:::
+
+## Examples
+
+Applies a sensitivity label by id to a document library based on the list title.
+
+```sh
+m365 spo list sensitivitylabel ensure --webUrl 'https://contoso.sharepoint.com' --listTitle 'Shared Documents' --id '0d39dc11-75ff-4309-8b32-ff94f0e41607'
+```
+
+Applies a sensitivity label by name to a document library based on the list title.
+
+```sh
+m365 spo list sensitivitylabel ensure --webUrl 'https://contoso.sharepoint.com' --listTitle 'Shared Documents' --name 'Confidential'
+```
+
+Applies a sensitivity label by name to a document library based on the list url.
+
+```sh
+m365 spo list sensitivitylabel ensure --webUrl 'https://contoso.sharepoint.com' --listUrl '/Shared Documents' --name 'Confidential'
+```
+
+Applies a sensitivity label by name to a document library based on the list id.
+
+```sh
+m365 spo list sensitivitylabel ensure --webUrl 'https://contoso.sharepoint.com' --listId 'b4cfa0d9-b3d7-49ae-a0f0-f14ffdd005f7' --name 'Confidential'
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -9,7 +9,7 @@ Get an application customizer that is installed tenant wide
 ## Usage
 
 ```sh
-spo tenant applicationcustomizer get [options]
+m365 spo tenant applicationcustomizer get [options]
 ```
 
 ## Options

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

@@ -9,7 +9,7 @@ Retrieves a list of application customizers that are installed tenant-wide.
 ## Usage
 
 ```sh
-spo tenant applicationcustomizer list [options]
+m365 spo tenant applicationcustomizer list [options]
 ```
 
 ## Options

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

@@ -7,7 +7,7 @@ Removes an application customizer that is installed tenant wide.
 ## Usage
 
 ```sh
-spo tenant applicationcustomizer remove [options]
+m365 spo tenant applicationcustomizer remove [options]
 ```
 
 ## Options

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

@@ -14,7 +14,7 @@ m365 spo tenant commandset add [options]
 
 ## Options
 
-```md defintion-list
+```md definition-list
 `-t, --title <title>`
 : The title of the ListView Command Set.
 

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

@@ -9,12 +9,12 @@ Get a ListView Command Set that is installed tenant wide
 ## Usage
 
 ```sh
-spo tenant commandset get [options]
+m365 spo tenant commandset get [options]
 ```
 
 ## Options
 
-```md defintion-list
+```md definition-list
 `-t, --title [title]`
 : The title of the ListView Command Set. Specify either `title`, `id`, or `clientSideComponentId`.
 

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

@@ -0,0 +1,114 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spo tenant commandset list
+
+Retrieves a list of ListView Command Sets that are installed tenant-wide
+
+## Usage
+
+```sh
+m365 spo tenant commandset list [options]
+```
+
+## Options
+
+<Global />
+
+## Examples
+
+Retrieves a list of ListView Command Sets.
+
+```sh
+m365 spo tenant commandset list
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "FileSystemObjectType": 0,
+      "Id": 9,
+      "ServerRedirectedEmbedUri": null,
+      "ServerRedirectedEmbedUrl": "",
+      "ID": 9,
+      "ContentTypeId": "0x00693E2C487575B448BD420C12CEAE7EFE",
+      "Title": "HelloWorld",
+      "Modified": "2023-05-25T12:11:21Z",
+      "Created": "2023-05-25T12:11:21Z",
+      "AuthorId": 9,
+      "EditorId": 9,
+      "OData__UIVersionString": "1.0",
+      "Attachments": false,
+      "GUID": "6c47dd94-f5d5-4ea8-8b39-920385a56c37",
+      "OData__ColorTag": null,
+      "ComplianceAssetId": null,
+      "TenantWideExtensionComponentId": "f61d4ae8-3480-4541-930b-d641233c4fea",
+      "TenantWideExtensionComponentProperties": "{\"sampleTextOne\":\"One item is selected in the list.\", \"sampleTextTwo\":\"This command is always visible.\"}",
+      "TenantWideExtensionWebTemplate": null,
+      "TenantWideExtensionListTemplate": 100,
+      "TenantWideExtensionLocation": "ClientSideExtension.ListViewCommandSet.CommandBar",
+      "TenantWideExtensionSequence": 0,
+      "TenantWideExtensionHostProperties": null,
+      "TenantWideExtensionDisabled": false
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  TenantWideExtensionComponentId : f61d4ae8-3480-4541-930b-d641233c4fea
+  TenantWideExtensionListTemplate: 100
+  Title                          : HelloWorld
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  FileSystemObjectType,Id,ServerRedirectedEmbedUrl,ID,ContentTypeId,Title,Modified,Created,AuthorId,EditorId,OData__UIVersionString,Attachments,GUID,TenantWideExtensionComponentId,TenantWideExtensionComponentProperties,TenantWideExtensionListTemplate,TenantWideExtensionLocation,TenantWideExtensionSequence,TenantWideExtensionDisabled
+  0,9,,9,0x00693E2C487575B448BD420C12CEAE7EFE,HelloWorld,2023-05-25T12:11:21Z,2023-05-25T12:11:21Z,9,9,1.0,,6c47dd94-f5d5-4ea8-8b39-920385a56c37,f61d4ae8-3480-4541-930b-d641233c4fea,"{""sampleTextOne"":""One item is selected in the list."", ""sampleTextTwo"":""This command is always visible.""}",100,ClientSideExtension.ListViewCommandSet.CommandBar,0,
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spo tenant commandset list
+
+  Date: 5/25/2023
+
+  ## HelloWorld (9)
+
+  Property | Value
+  ---------|-------
+  FileSystemObjectType | 0
+  Id | 9
+  ServerRedirectedEmbedUrl |
+  ID | 9
+  ContentTypeId | 0x00693E2C487575B448BD420C12CEAE7EFE
+  Title | HelloWorld
+  Modified | 2023-05-25T12:11:21Z
+  Created | 2023-05-25T12:11:21Z
+  AuthorId | 9
+  EditorId | 9
+  OData\_\_UIVersionString | 1.0
+  Attachments | false
+  GUID | 6c47dd94-f5d5-4ea8-8b39-920385a56c37
+  TenantWideExtensionComponentId | f61d4ae8-3480-4541-930b-d641233c4fea
+  TenantWideExtensionComponentProperties | {"sampleTextOne":"One item is selected in the list.", "sampleTextTwo":"This command is always visible."}
+  TenantWideExtensionListTemplate | 100
+  TenantWideExtensionLocation | ClientSideExtension.ListViewCommandSet.CommandBar
+  TenantWideExtensionSequence | 0
+  TenantWideExtensionDisabled | false
+  ```
+    
+  </TabItem>
+</Tabs>

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

@@ -7,7 +7,7 @@ Removes a ListView Command Set that is installed tenant wide.
 ## Usage
 
 ```sh
-spo tenant commandset remove [options]
+m365 spo tenant commandset remove [options]
 ```
 
 ## Options

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

@@ -7,7 +7,7 @@ Updates a ListView Command Set that is installed tenant wide.
 ## Usage
 
 ```sh
-spo tenant commandset set [options]
+m365 spo tenant commandset set [options]
 ```
 
 ## Options
@@ -22,7 +22,7 @@ spo tenant commandset set [options]
 `-l, --listType [listType]`
 : The list or library type to register the ListView Command Set on. Allowed values `List` or `Library`.
 
-`-i, --clientSideComponentId  [clientSideComponentId]`
+`-c, --clientSideComponentId  [clientSideComponentId]`
 : The Client Side Component Id (GUID) of the ListView Command Set.
 
 `-p, --clientSideComponentProperties  [clientSideComponentProperties]`

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

@@ -305,3 +305,9 @@ Disable Azure AD B2B integration for SharePoint and OneDrive
 ```sh
 m365 spo tenant settings set --EnableAzureADB2BIntegration false
 ```
+
+Disable comments on list items for SharePoint and Microsoft Lists
+
+```sh
+m365 spo tenant settings set --CommentsOnListItemsDisabled true
+```

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

@@ -9,7 +9,7 @@ Get SharePoint user profile properties for the specified user
 ## Usage
 
 ```sh
-spo userprofile get [options]
+m365 spo userprofile get [options]
 ```
 
 ## Options

package/docs/docs/cmd/status.mdx

@@ -38,7 +38,8 @@ m365 status
     "connectedAs": "john.doe@contoso.onmicrosoft.com",
     "authType": "DeviceCode",
     "appId": "31359c7f-bd7e-475c-86db-fdb8c937548e",
-    "appTenant": "common"
+    "appTenant": "common",
+    "cloudType": "Public"
   }
   ```
 
@@ -50,14 +51,15 @@ m365 status
   appTenant  : common
   authType   : DeviceCode
   connectedAs: john.doe@contoso.onmicrosoft.com
+  cloudType  : Public
   ```
 
   </TabItem>
   <TabItem value="CSV">
 
   ```csv
-  connectedAs,authType,appId,appTenant
-  john.doe@contoso.onmicrosoft.com,DeviceCode,31359c7f-bd7e-475c-86db-fdb8c937548e,common
+  connectedAs,authType,appId,appTenant,cloudType
+  john.doe@contoso.onmicrosoft.com,DeviceCode,31359c7f-bd7e-475c-86db-fdb8c937548e,common,Public
   ```
 
   </TabItem>
@@ -76,6 +78,7 @@ m365 status
   authType | DeviceCode
   appId | 31359c7f-bd7e-475c-86db-fdb8c937548e
   appTenant | common
+  cloudType | Public
   ```
 
   </TabItem>

package/docs/docs/cmd/util/accesstoken/accesstoken-get.mdx

@@ -26,9 +26,13 @@ m365 util accesstoken get [options]
 
 ## Remarks
 
-The `util accesstoken get` command returns an access token for the specified resource. If an access token has been previously retrieved and is still valid, the command will return the cached token. If you want to ensure that the returned access token is valid for as long as possible, you can force the command to retrieve a new access token by using the `--new` option.
+:::tip
+
+Instead of specifying the full URL of the resource, you can use one of the following shorthand identifiers: `sharepoint`, `graph`.
 
-If the URL of your SharePoint tenant has been previously retrieved, you can use `sharepoint` as the resource to retrieve access token for SharePoint. To verify if the URL of your SharePoint tenant has been previously retrieved, use the [`spo get`](../../spo/spo-get.mdx) command. To explicitly set the URL of your SharePoint tenant use the [`spo set`](../../spo/spo-set.mdx) command.
+:::
+
+The `util accesstoken get` command returns an access token for the specified resource. If an access token has been previously retrieved and is still valid, the command will return the cached token. If you want to ensure that the returned access token is valid for as long as possible, you can force the command to retrieve a new access token by using the `--new` option.
 
 ## Examples
 
@@ -44,6 +48,12 @@ Get access token for SharePoint Online using the shorthand identifier
 m365 util accesstoken get --resource sharepoint
 ```
 
+Get access token for Microsoft Graph using the shorthand identifier
+
+```sh
+m365 util accesstoken get --resource graph
+```
+
 Get a new access token for SharePoint Online
 
 ```sh