@pnp/cli-microsoft365 6.9.0-beta.f6054b4 → 6.10.0-beta.05cab2f

package/docs/docs/cmd/purview/retentionevent/retentionevent-list.mdx

@@ -32,15 +32,8 @@ This command is based on a Microsoft Graph API that is currently in preview and
 
 :::
 
-:::caution
-
-This command currently only supports delegated permissions.
-
-:::
-
 ## Response
 
-
 <Tabs>
   <TabItem value="JSON">
 

package/docs/docs/cmd/purview/retentionevent/retentionevent-remove.mdx

@@ -38,12 +38,6 @@ This command is based on a Microsoft Graph API that is currently in preview and
 
 :::
 
-:::caution
-
-This command currently only supports delegated permissions.
-
-:::
-
 ## Response
 
 The command won't return a response on success.

package/docs/docs/cmd/purview/retentioneventtype/retentioneventtype-add.mdx

@@ -32,12 +32,6 @@ This command is based on a Microsoft Graph API that is currently in preview and
 
 :::
 
-:::caution
-
-This command currently only supports delegated permissions.
-
-:::
-
 ## Examples
 
 Create a retention event type *Contract Expiry*.

package/docs/docs/cmd/purview/retentioneventtype/retentioneventtype-get.mdx

@@ -29,12 +29,6 @@ This command is based on an API that is currently in preview and is subject to c
 
 :::
 
-:::caution
-
-This command currently only supports delegated permissions.
-
-:::
-
 ## Examples
 
 Get a retention event type by id

package/docs/docs/cmd/purview/retentioneventtype/retentioneventtype-list.mdx

@@ -24,12 +24,6 @@ This command is based on a Microsoft Graph API that is currently in preview and
 
 :::
 
-:::caution
-
-This command currently only supports delegated permissions.
-
-:::
-
 ## Examples
 
 Get a list of retention event types

package/docs/docs/cmd/purview/retentioneventtype/retentioneventtype-remove.mdx

@@ -30,12 +30,6 @@ This command is based on a Microsoft Graph API that is currently in preview and
 
 :::
 
-:::caution
-
-This command currently only supports delegated permissions.
-
-:::
-
 ## Examples
 
 Delete a retention event type by id

package/docs/docs/cmd/purview/retentioneventtype/retentioneventtype-set.mdx

@@ -30,12 +30,6 @@ This command is based on a Microsoft Graph API that is currently in preview and
 
 :::
 
-:::caution
-
-This command currently only supports delegated permissions.
-
-:::
-
 ## Examples
 
 Update the description of a retention event type

package/docs/docs/cmd/purview/retentionlabel/retentionlabel-add.mdx

@@ -59,12 +59,6 @@ This command is based on a Microsoft Graph API that is currently in preview and
 
 :::
 
-:::caution
-
-This command currently only supports delegated permissions.
-
-:::
-
 ## Examples
 
 Create a retention label that retains documents and deletes them after one year.

package/docs/docs/cmd/purview/retentionlabel/retentionlabel-get.mdx

@@ -29,12 +29,6 @@ This command is based on a Microsoft Graph API that is currently in preview and
 
 :::
 
-:::caution
-
-This command currently only supports delegated permissions.
-
-:::
-
 ## Examples
 
 Get a retention label

package/docs/docs/cmd/purview/retentionlabel/retentionlabel-list.mdx

@@ -24,12 +24,6 @@ This command is based on a Microsoft Graph API that is currently in preview and
 
 :::
 
-:::caution
-
-This command currently only supports delegated permissions.
-
-:::
-
 ## Examples
 
 Get a list of retention labels

package/docs/docs/cmd/purview/retentionlabel/retentionlabel-remove.mdx

@@ -30,12 +30,6 @@ This command is based on a Microsoft Graph API that is currently in preview and
 
 :::
 
-:::caution
-
-This command currently only supports delegated permissions.
-
-:::
-
 ## Examples
 
 Delete a retention label

package/docs/docs/cmd/purview/retentionlabel/retentionlabel-set.mdx

@@ -51,12 +51,6 @@ This command is based on a Microsoft Graph API that is currently in preview and
 
 :::
 
-:::caution
-
-This command currently only supports delegated permissions.
-
-:::
-
 ## Examples
 
 Update a retention label so that it retains documents as records and deletes them after one year.

package/docs/docs/cmd/setup.mdx

@@ -49,6 +49,7 @@ The `m365 setup` command uses the following presets:
 - interactive use:
   - autoOpenLinksInBrowser: true,
   - copyDeviceCodeToClipboard: true,
+  - interactive: true,
   - output: 'text',
   - printErrorsAsPlainText: true,
   - prompt: true,
@@ -57,6 +58,7 @@ The `m365 setup` command uses the following presets:
 - scripting use:
   - autoOpenLinksInBrowser: false,
   - copyDeviceCodeToClipboard: false,
+  - interactive: false,
   - output: 'json',
   - printErrorsAsPlainText: false,
   - prompt: false,

package/docs/docs/cmd/spfx/project/project-upgrade.mdx

@@ -35,7 +35,7 @@ m365 spfx project upgrade [options]
 
 ## Remarks
 
-The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.17.2).
+The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.17.4).
 
 This command doesn't change your project files. Instead, it gives you a report with all steps necessary to upgrade your project to the specified version of the SharePoint Framework. Changing project files is error-prone, especially when it comes to updating your solution's code. This is why at this moment, this command produces a report that you can use yourself to perform the necessary updates and verify that everything is working as expected.
 

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

@@ -0,0 +1,72 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spo applicationcustomizer set
+
+Updates an existing Application Customizer on a site
+
+## Usage
+
+```sh
+m365 spo applicationcustomizer set [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: The site to update the Application Customizer on.
+
+`-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 new title of the Application Customizer.
+
+`-p, --clientSideComponentProperties  [clientSideComponentProperties]`
+: The Client Side Component properties of the Application Customizer.
+
+`-s, --scope [scope]`
+: The scope where to lookup the Application Customizer. Allowed values: `Site`, `Web`, and `All`. Defaults to `All`.
+```
+
+<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 applicationcustomizer set --webUrl https://contoso.sharepoint.com/sites/sales --id b41916e7-e69d-467f-b37f-ff8ecf8f99f2 --newTitle "Some customizer" --clientSideComponentProperties '{\"testMessage\":\"Test message\"}'
+```
+
+Note, how the clientSideComponentProperties option (--clientSideComponentProperties) 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.
+
+:::
+
+## Examples
+
+Updates the title of an application customizer on the sales site
+
+```sh
+m365 spo applicationcustomizer set --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --newTitle "Some customizer" --webUrl https://contoso.sharepoint.com/sites/sales
+```
+
+Updates the properties of an application customizer on the sales site
+
+```sh
+m365 spo applicationcustomizer set --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --clientSideComponentProperties '{ "testMessage": "Test message" }' --webUrl https://contoso.sharepoint.com/sites/sales
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -22,16 +22,19 @@ m365 spo commandset set [options]
 `-i, --id [id]`
 : The id of the ListView Command Set to update. Specify either `title`, `id`or `clientSideComponentId`.
 
-`-c, --clientSideComponentId  [clientSideComponentId]`
+`-c, --clientSideComponentId [clientSideComponentId]`
 : The Client Side Component Id (GUID) of the ListView Command Set to update. Specify either `title`, `id`or `clientSideComponentId`.
 
+`--newClientSideComponentId [newClientSideComponentId]`
+: The new Client Side Component Id (GUID) of the ListView Command Set.
+
 `--newTitle [newTitle]`
 : The new title of the ListView Command Set.
 
 `-l, --listType [listType]`
 : The list or library type to register the Command Set on. Allowed values `List`, `Library` or `SitePages`.
 
-`--clientSideComponentProperties  [clientSideComponentProperties]`
+`--clientSideComponentProperties [clientSideComponentProperties]`
 : The Client Side Component properties of the ListView Command Set.
 
 `-s, --scope [scope]`
@@ -64,7 +67,7 @@ When using the `--clientSideComponentProperties` option it's possible to enter a
 Updates the title and location of a ListView Command Set on the sales site.
 
 ```sh
-m365 spo commandset  set --clientSideComponentId  799883f5-7962-4384-a10a-105adaec6ffc --newTitle "Some new title" --location Both --webUrl https://contoso.sharepoint.com/sites/sales --scope Site
+m365 spo commandset set --clientSideComponentId 799883f5-7962-4384-a10a-105adaec6ffc --newTitle "Some new title" --location Both --webUrl https://contoso.sharepoint.com/sites/sales --scope Site
 ```
 
 Updates a ListView Command Set on the sales site with some properties.
@@ -73,6 +76,12 @@ Updates a ListView Command Set on the sales site with some properties.
 m365 spo commandset set --title "Some customizer" --clientSideComponentProperties '{ "someProperty": "Some value" }' --webUrl https://contoso.sharepoint.com/sites/sales --scope Site
 ```
 
+Updates the Client Side Component Id of a ListView Command Set.
+
+```sh
+m365 spo commandset set --title "Some customizer" --newClientSideComponentId b2c5faf3-638f-44ae-bfde-1730d94283bf --webUrl https://contoso.sharepoint.com/sites/sales
+```
+
 ## Response
 
 The command won't return a response on success.

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

@@ -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/site/site-add.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo site add
 
@@ -178,6 +180,39 @@ Create new classic site collection using the Team site template. Set time zone t
 m365 spo site add --type ClassicSite --url https://contoso.sharepoint.com/sites/team --title Team --owners admin@contoso.onmicrosoft.com --timeZone 4 --webTemplate STS#0 --removeDeletedSite --wait
 ```
 
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  "https://contoso.sharepoint.com/sites/marketing"
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  https://contoso.sharepoint.com/sites/marketing
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  https://contoso.sharepoint.com/sites/marketing
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  https://contoso.sharepoint.com/sites/marketing
+  ```
+
+  </TabItem>
+</Tabs>
+
 ## More information
 
 - Creating SharePoint Communication Site using REST: [https://docs.microsoft.com/en-us/sharepoint/dev/apis/communication-site-creation-rest](https://docs.microsoft.com/en-us/sharepoint/dev/apis/communication-site-creation-rest)

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

@@ -32,9 +32,13 @@ To use this command you have to have permissions to access the tenant admin site
 Add a site collection app catalog to the specified site
 
 ```sh
-m365 spo site appcatalog add --siteUrl https://contoso.sharepoint/sites/site
+m365 spo site appcatalog add --siteUrl https://contoso.sharepoint.com/sites/site
 ```
 
+## Response
+
+The command won't return a response on success.
+
 ## More information
 
 - Use the site collection app catalog: [https://docs.microsoft.com/en-us/sharepoint/dev/general-development/site-collection-app-catalog](https://docs.microsoft.com/en-us/sharepoint/dev/general-development/site-collection-app-catalog)

package/docs/docs/cmd/spo/site/site-appcatalog-list.mdx

@@ -64,6 +64,20 @@ m365 spo site appcatalog list
   https://contoso.sharepoint.com/sites/site1,9798e615-b586-455e-8486-84913f492c49
   ```
 
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spo site appcatalog list
+
+  Date: 2023-06-21
+
+  Property | Value
+  ---------|-------
+  AbsoluteUrl | https://contoso.sharepoint.com/sites/site1
+  SiteID | 9798e615-b586-455e-8486-84913f492c49
+  ```
+
   </TabItem>
 </Tabs>
 

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

@@ -37,6 +37,10 @@ Remove the site collection app catalog from specified site
 m365 spo site appcatalog remove --siteUrl https://contoso.sharepoint/sites/site
 ```
 
+## Response
+
+The command won't return a response on success.
+
 ## More information
 
 - Use the site collection app catalog: [https://docs.microsoft.com/en-us/sharepoint/dev/general-development/site-collection-app-catalog](https://docs.microsoft.com/en-us/sharepoint/dev/general-development/site-collection-app-catalog)

package/docs/docs/cmd/spo/site/site-apppermission-add.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo site apppermission add
 
@@ -39,3 +41,69 @@ Grants the specified app the _read_ permission to site _https://contoso.sharepoi
 ```sh
 m365 spo site apppermission add --siteUrl https://contoso.sharepoint.com/sites/project-x --permission read --appDisplayName Foo
 ```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+  "id": "aTowaS50fG1zLnNwLmV4dHw1Yzg5ZmJiZi02NzBlLTQ4ZTctYTBiYy1mYTg5NDJjODk1YTJAMWU4NTJiNDktYmY0Yi00YmE1LWJjZDQtYThjNDcwNmM4ZWQ0",
+  "roles": [
+    "read"
+  ],
+  "grantedToIdentitiesV2": [
+    {
+      "application": {
+        "displayName": "Foo",
+        "id": "5c89fbbf-670e-48e7-a0bc-fa8942c895a2"
+      }
+    }
+  ],
+  "grantedToIdentities": [
+    {
+      "application": {
+        "displayName": "Foo",
+        "id": "5c89fbbf-670e-48e7-a0bc-fa8942c895a2"
+      }
+    }
+  ]
+}
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  grantedToIdentities  : [{"application":{"displayName":"Foo","id":"5c89fbbf-670e-48e7-a0bc-fa8942c895a2"}}]
+  grantedToIdentitiesV2: [{"application":{"displayName":"Foo","id":"5c89fbbf-670e-48e7-a0bc-fa8942c895a2"}}]
+  id                   : aTowaS50fG1zLnNwLmV4dHw1Yzg5ZmJiZi02NzBlLTQ4ZTctYTBiYy1mYTg5NDJjODk1YTJAMWU4NTJiNDktYmY0Yi00YmE1LWJjZDQtYThjNDcwNmM4ZWQ0
+  roles                : ["read"]
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id
+  aTowaS50fG1zLnNwLmV4dHw1Yzg5ZmJiZi02NzBlLTQ4ZTctYTBiYy1mYTg5NDJjODk1YTJAMWU4NTJiNDktYmY0Yi00YmE1LWJjZDQtYThjNDcwNmM4ZWQ0
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spo site apppermission add --siteUrl "https://contoso.sharepoint.com/sites/team1" --permission "read" --appDisplayName "Foo"
+
+  Date: 2023-06-21
+
+  ## aTowaS50fG1zLnNwLmV4dHw1Yzg5ZmJiZi02NzBlLTQ4ZTctYTBiYy1mYTg5NDJjODk1YTJAMWU4NTJiNDktYmY0Yi00YmE1LWJjZDQtYThjNDcwNmM4ZWQ0
+
+  Property | Value
+  ---------|-------
+  id | aTowaS50fG1zLnNwLmV4dHw1Yzg5ZmJiZi02NzBlLTQ4ZTctYTBiYy1mYTg5NDJjODk1YTJAMWU4NTJiNDktYmY0Yi00YmE1LWJjZDQtYThjNDcwNmM4ZWQ0
+  ```
+
+  </TabItem>
+</Tabs>