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

package/docs/docs/cmd/flow/flow-list.mdx

@@ -21,6 +21,9 @@ m365 flow list [options]
 `--sharingStatus [sharingStatus]`
 : List a specific type of flows. Valid values: `ownedByMe`, `personal`, `sharedWithMe`, `all`. Defaults to `ownedByMe`. Don't specify this option when using asAdmin.
 
+`--includeSolutions`
+: Include flows from solutions.
+
 `--asAdmin`
 : Set, to list all Flows as admin. Otherwise will return only your own flows.
 ```
@@ -58,6 +61,18 @@ List all flows in the given environment
 m365 flow list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --asAdmin
 ```
 
+List all flows that are shared with the current user
+
+```sh
+m365 flow list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --sharingStatus sharedWithMe
+```
+
+List all personal flows and include flows from solutions
+
+```sh
+m365 flow list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --sharingStatus personal --includeSolutions
+```
+
 ## Response
 
 ### Standard response

package/docs/docs/cmd/login.mdx

@@ -177,6 +177,16 @@ m365 login --authType secret --secret topSeCr3t@007
   ```json
   To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code CQBMTLEFC to authenticate.
   ```
+  Upon successful login:
+  ```json
+  {
+    "connectedAs": "john.doe@contoso.onmicrosoft.com",
+    "authType": "DeviceCode",
+    "appId": "31359c7f-bd7e-475c-86db-fdb8c937548e",
+    "appTenant": "common",
+    "cloudType": "Public"
+  }
+  ```
 
   </TabItem>
   <TabItem value="Text">
@@ -184,6 +194,14 @@ m365 login --authType secret --secret topSeCr3t@007
   ```text
   To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code CQBMTLEFC to authenticate.
   ```
+  Upon successful login:
+  ```text
+  appId      : 31359c7f-bd7e-475c-86db-fdb8c937548e
+  appTenant  : common
+  authType   : DeviceCode
+  connectedAs: john.doe@contoso.onmicrosoft.com,
+  cloudType  : Public
+  ```
 
   </TabItem>
   <TabItem value="CSV">
@@ -191,6 +209,11 @@ m365 login --authType secret --secret topSeCr3t@007
   ```csv
   To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code CQBMTLEFC to authenticate.
   ```
+  Upon successful login:
+  ```csv
+  connectedAs,authType,appId,appTenant,cloudType
+  john.doe@contoso.onmicrosoft.com,DeviceCode,31359c7f-bd7e-475c-86db-fdb8c937548e,common,Public
+  ```
 
   </TabItem>
   <TabItem value="Markdown">
@@ -198,6 +221,22 @@ m365 login --authType secret --secret topSeCr3t@007
   ```md
   To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code CQBMTLEFC to authenticate.
   ```
+  Upon successful login:
+  ```md
+  # status
+
+  Date: 7/2/2023
+
+
+
+  Property | Value
+  ---------|-------
+  connectedAs | john.doe@contoso.onmicrosoft.com
+  authType | DeviceCode
+  appId | 31359c7f-bd7e-475c-86db-fdb8c937548e
+  appTenant | common
+  cloudType | Public
+  ```
 
   </TabItem>
 </Tabs>

package/docs/docs/cmd/pa/app/app-get.mdx

@@ -9,7 +9,7 @@ Gets information about the specified Microsoft Power App
 ## Usage
 
 ```sh
-pa app get [options]
+m365 pa app get [options]
 ```
 
 ## Options

package/docs/docs/cmd/pa/app/app-list.mdx

@@ -9,7 +9,7 @@ Lists all Power Apps apps
 ## Usage
 
 ```sh
-pa app list [options]
+m365 pa app list [options]
 ```
 
 ## Options

package/docs/docs/cmd/pp/aibuildermodel/aibuildermodel-get.mdx

@@ -9,7 +9,7 @@ Gets a specific AI builder models in the specified Power Platform environment
 ## Usage
 
 ```sh
-pp aibuildermodel get [options]
+m365 pp aibuildermodel get [options]
 ```
 
 ## Options

package/docs/docs/cmd/pp/aibuildermodel/aibuildermodel-list.mdx

@@ -9,7 +9,7 @@ List available AI builder models in the specified Power Platform environment
 ## Usage
 
 ```sh
-pp aibuildermodel list [options]
+m365 pp aibuildermodel list [options]
 ```
 
 ## Options

package/docs/docs/cmd/pp/card/card-clone.mdx

@@ -9,7 +9,7 @@ Clones a specific Microsoft Power Platform card in the specified Power Platform
 ## Usage
 
 ```sh
-pp card clone [options]
+m365 pp card clone [options]
 ```
 
 ## Options

package/docs/docs/cmd/pp/card/card-get.mdx

@@ -9,7 +9,7 @@ Gets a specific Microsoft Power Platform card in the specified Power Platform en
 ## Usage
 
 ```sh
-pp card get [options]
+m365 pp card get [options]
 ```
 
 ## Options

package/docs/docs/cmd/pp/card/card-list.mdx

@@ -9,7 +9,7 @@ Lists Microsoft Power Platform cards in the specified Power Platform environment
 ## Usage
 
 ```sh
-pp card list [options]
+m365 pp card list [options]
 ```
 
 ## Options

package/docs/docs/cmd/pp/chatbot/chatbot-get.mdx

@@ -9,7 +9,7 @@ Get information about the specified chatbot
 ## Usage
 
 ```sh
-pp chatbot get [options]
+m365 pp chatbot get [options]
 ```
 
 ## Options

package/docs/docs/cmd/pp/chatbot/chatbot-list.mdx

@@ -9,7 +9,7 @@ Lists Microsoft Power Platform chatbot in the specified Power Platform environme
 ## Usage
 
 ```sh
-pp chatbot list [options]
+m365 pp chatbot list [options]
 ```
 
 ## Options

package/docs/docs/cmd/pp/dataverse/dataverse-table-get.mdx

@@ -9,7 +9,7 @@ List a dataverse table in a given environment
 ## Usage
 
 ```sh
-pp dataverse table get [options]
+m365 pp dataverse table get [options]
 ```
 
 ## Options

package/docs/docs/cmd/pp/dataverse/dataverse-table-list.mdx

@@ -9,7 +9,7 @@ Lists dataverse tables in a given environment
 ## Usage
 
 ```sh
-pp dataverse table list [options]
+m365 pp dataverse table list [options]
 ```
 
 ## Options

package/docs/docs/cmd/pp/dataverse/dataverse-table-remove.mdx

@@ -7,7 +7,7 @@ Removes a dataverse table in a given environment
 ## Usage
 
 ```sh
-pp dataverse table remove [options]
+m365 pp dataverse table remove [options]
 ```
 
 ## Options

package/docs/docs/cmd/pp/dataverse/dataverse-table-row-list.mdx

@@ -9,7 +9,7 @@ Lists table rows for the given Dataverse table
 ## Usage
 
 ```sh
-pp dataverse table row list [options]
+m365 pp dataverse table row list [options]
 ```
 
 ## Options

package/docs/docs/cmd/pp/dataverse/dataverse-table-row-remove.mdx

@@ -7,7 +7,7 @@ Removes a row from a dataverse table in a given environment.
 ## Usage
 
 ```sh
-pp dataverse table row remove [options]
+m365 pp dataverse table row remove [options]
 ```
 
 ## Options

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

@@ -47,12 +47,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
 
 Create a retention event to start retention at the end of 2022 for all employee documents that have been labeled and have the Asset ID _EmployeeNr1234_

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

@@ -37,12 +37,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.
-
-:::
-
 ## Response
 
 <Tabs>

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