@pnp/cli-microsoft365 6.9.0-beta.1cd2525 → 6.9.0-beta.3158148

package/docs/docs/cmd/spo/file/file-checkout-undo.mdx

@@ -0,0 +1,55 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spo file checkout undo
+
+Discards a checked out file
+
+## Usage
+
+```sh
+m365 spo file checkout undo [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: The URL of the site where the file is located.
+
+`-f, --fileUrl [fileUrl]`
+: The server- or site-relative URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both.
+
+`-i, --fileId [fileId]`
+: The UniqueId (GUID) of the file to retrieve. Specify either `fileUrl` or `fileId` but not both.
+
+`--confirm`
+: Don't prompt for confirmation.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+When specifying option `fileUrl`, make sure that the URL is decoded. If not, you will get a `File Not Found` error.
+
+:::
+
+## Examples
+
+Discards a checked-out file with a specific ID.
+
+```sh
+m365 spo file checkout undo --webUrl https://contoso.sharepoint.com/sites/project-x --fileId 'b2307a39-e878-458b-bc90-03bc578531d6'
+```
+
+Discards a checked-out file with a specific URL without prompting for confirmation.
+
+```sh
+m365 spo file checkout undo --webUrl https://contoso.sharepoint.com/sites/project-x --fileUrl '/sites/project-x/documents/Test1.docx' --confirm
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/file/file-retentionlabel-ensure.mdx

@@ -33,7 +33,7 @@ m365 spo file retentionlabel ensure [options]
 
 ## Remarks
 
-You can also use [spo listitem retentionlabel remove](./../../../cmd/spo//listitem/listitem-retentionlabel-remove.mdx) for removing the retention label from a listitem.
+You can also use [spo listitem retentionlabel remove](./../../../cmd/spo/listitem/listitem-retentionlabel-remove.mdx) for removing the retention label from a listitem.
 
 The `--assetId` option has to do with event-based retention. Event-based retention is about starting a retention period when a specific event occurs, instead of the moment a document was labeled or created.
 

package/docs/docs/cmd/spo/folder/folder-retentionlabel-ensure.mdx

@@ -30,7 +30,7 @@ m365 spo folder retentionlabel ensure [options]
 
 ## Remarks
 
-You can also use [spo listitem retentionlabel remove](./../../../cmd/spo//listitem/listitem-retentionlabel-remove.mdx) for removing the retention label from a listitem.
+You can also use [spo listitem retentionlabel remove](./../../../cmd/spo/listitem/listitem-retentionlabel-remove.mdx) for removing the retention label from a listitem.
 
 ## Examples
 

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

@@ -16,8 +16,11 @@ m365 spo list sensitivitylabel ensure [options]
 `-u, --webUrl <webUrl>`
 : The URL of the site where the library is located.
 
-`-n, --name <name>`
-: The name of the label.
+`-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.
@@ -41,19 +44,25 @@ This command is based on an API that is currently in preview and is subject to c
 
 ## Examples
 
-Applies a sensitivity label to a document library based on the list title.
+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 to a document library based on the list url.
+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 to a document library based on the list id.
+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'

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-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/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