@pnp/cli-microsoft365 6.9.0-beta.6a23aba → 6.9.0-beta.8393174

package/docs/docs/cmd/aad/user/user-password-validate.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # aad user password validate
 
@@ -34,3 +36,68 @@ Validate password _cli365P@ssW0rd_ against the organization's password validatio
 ```sh
 m365 aad user password validate --password "cli365P@ssW0rd"
 ```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "isValid": true,
+    "validationResults": [
+      {
+        "ruleName": "PasswordMinLength",
+        "validationPassed": true,
+        "message": "The new password must have a minimum of 8 characters."
+      },
+      {
+        "ruleName": "PasswordMaxLength",
+        "validationPassed": true,
+        "message": "The new password cannot contain more than 256 characters."
+      },
+      {
+        "ruleName": "PasswordComplexity",
+        "validationPassed": true,
+        "message": "The new password must contain characters from at least 3 out of: Lowercase characters, Uppercase characters, Numbers, Symbols."
+      },
+      {
+        "ruleName": "PasswordNotBanned",
+        "validationPassed": true,
+        "message": "The new password must not be weak or commonly used."
+      }
+    ]
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  isValid          : true
+  validationResults: [{"ruleName":"PasswordMinLength","validationPassed":true,"message":"The new password must have a minimum of 8 characters."},{"ruleName":"PasswordMaxLength","validationPassed":true,"message":"The new password cannot contain more than 256 characters."},{"ruleName":"PasswordComplexity","validationPassed":true,"message":"The new password must contain characters from at least 3 out of: Lowercase characters, Uppercase characters, Numbers, Symbols."},{"ruleName":"PasswordNotBanned","validationPassed":true,"message":"The new password must not be weak or commonly used."}]
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  isValid
+  1
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # aad user password validate --password "cli365P@ssW0rd"
+
+  Date: 2023-06-02
+
+  Property | Value
+  ---------|-------
+  isValid | true
+  ```
+
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/aad/user/user-signin-list.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # aad user signin list
 
@@ -83,3 +85,132 @@ Get all user's sign-ins filter by given user's Id and application identifier in
 ```sh
 m365 aad user signin list --userId '11111111-1111-1111-1111-111111111111' --appId '00000000-0000-0000-0000-000000000000'
 ```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "id": "66ea54eb-6301-4ee5-be62-ff5a759b0100",
+      "createdDateTime": "2020-03-13T19:15:41.6195833Z",
+      "userDisplayName": "Test Contoso",
+      "userPrincipalName": "john@contoso.com",
+      "userId": "26be570a-ae82-4189-b4e2-a37c6808512d",
+      "appId": "de8bc8b5-d9f9-48b1-a8ad-b748da725064",
+      "appDisplayName": "Graph explorer",
+      "ipAddress": "131.107.159.37",
+      "clientAppUsed": "Browser",
+      "correlationId": "d79f5bee-5860-4832-928f-3133e22ae912",
+      "conditionalAccessStatus": "notApplied",
+      "isInteractive": true,
+      "riskDetail": "none",
+      "riskLevelAggregated": "none",
+      "riskLevelDuringSignIn": "none",
+      "riskState": "none",
+      "riskEventTypes": [],
+      "resourceDisplayName": "Microsoft Graph",
+      "resourceId": "00000003-0000-0000-c000-000000000000",
+      "status": {
+        "errorCode": 0,
+        "failureReason": null,
+        "additionalDetails": null
+      },
+      "deviceDetail": {
+        "deviceId": "",
+        "displayName": null,
+        "operatingSystem": "Windows 10",
+        "browser": "Edge 80.0.361",
+        "isCompliant": null,
+        "isManaged": null,
+        "trustType": null
+      },
+      "location": {
+        "city": "Redmond",
+        "state": "Washington",
+        "countryOrRegion": "US",
+        "geoCoordinates": {
+          "altitude": null,
+          "latitude": 47.68050003051758,
+          "longitude": -122.12094116210938
+        }
+      },
+      "appliedConditionalAccessPolicies": [
+        {
+          "id": "de7e60eb-ed89-4d73-8205-2227def6b7c9",
+          "displayName": "SharePoint limited access for guest workers",
+          "enforcedGrantControls": [],
+          "enforcedSessionControls": [],
+          "result": "notEnabled"
+        },
+        {
+          "id": "6701123a-b4c6-48af-8565-565c8bf7cabc",
+          "displayName": "Medium signin risk block",
+          "enforcedGrantControls": [],
+          "enforcedSessionControls": [],
+          "result": "notEnabled"
+        }
+      ]
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  id                                    userPrincipalName         appId                                 appDisplayName  createdDateTime
+  ------------------------------------  ------------------------  ------------------------------------  --------------  ----------------------------
+  66ea54eb-6301-4ee5-be62-ff5a759b0100  testaccount1@contoso.com  de8bc8b5-d9f9-48b1-a8ad-b748da725064  Graph explorer  2020-03-13T19:15:41.6195833Z
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,userPrincipalName,appId,appDisplayName,createdDateTime
+  66ea54eb-6301-4ee5-be62-ff5a759b0100,john@contoso.com,de8bc8b5-d9f9-48b1-a8ad-b748da725064,Graph explorer,2020-03-13T19:15:41.6195833Z
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # aad user signin list
+
+  Date: 2023-06-02
+
+  Property | Value
+  ---------|-------
+  # aad user signin list
+
+  Date: 2023-06-02
+
+  ## 66ea54eb-6301-4ee5-be62-ff5a759b0100
+
+  Property | Value
+  ---------|-------
+  id | 66ea54eb-6301-4ee5-be62-ff5a759b0100
+  createdDateTime | 2020-03-13T19:15:41.6195833Z
+  userDisplayName | Test Contoso
+  userPrincipalName | john@contoso.com
+  userId | 26be570a-ae82-4189-b4e2-a37c6808512d
+  appId | de8bc8b5-d9f9-48b1-a8ad-b748da725064
+  appDisplayName | Graph explorer
+  ipAddress | 131.107.159.37
+  clientAppUsed | Browser
+  correlationId | d79f5bee-5860-4832-928f-3133e22ae912
+  conditionalAccessStatus | notApplied
+  isInteractive | true
+  riskDetail | none
+  riskLevelAggregated | none
+  riskLevelDuringSignIn | none
+  riskState | none
+  resourceDisplayName | Microsoft Graph
+  resourceId | 00000003-0000-0000-c000-000000000000
+  ```
+
+  </TabItem>
+</Tabs>

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

@@ -16,10 +16,13 @@ m365 flow list [options]
 
 ```md definition-list
 `-e, --environmentName <environmentName>`
-: The name of the environment for which to retrieve available flows
+: The name of the environment for which to retrieve available flows.
+
+`--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.
 
 `--asAdmin`
-: Set, to list all Flows as admin. Otherwise will return only your own flows
+: Set, to list all Flows as admin. Otherwise will return only your own flows.
 ```
 
 <Global />
@@ -34,7 +37,12 @@ This command is based on an API that is currently in preview and is subject to c
 
 If the environment with the name you specified doesn't exist, you will get the `Access to the environment 'xyz' is denied.` error.
 
-By default, the `flow list` command returns only your flows. To list all flows, use the `asAdmin` option.
+When you specify a value for `sharingStatus`, consider the following:
+
+- `ownedByMe` returns all flows created by you regardless of whether they are shared or not.
+- `personal` returns all flows created by you which are not shared.
+- `sharedWithMe` returns flows that are shared with you, or created by you and shared with someone.
+- `all` combines `personal` and `sharedWithMe`.
 
 ## Examples
 

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

@@ -30,9 +30,6 @@ m365 flow run list [options]
 `--triggerEndTime [triggerEndTime]`
 : Time indicating the exclusive end of a time range of flow runs to return. This should be defined as a valid ISO 8601 string (2021-12-16T18:28:48.6964197Z).
 
-`--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.
-
 `--asAdmin`
 : Run the command as admin. Use this flag when targeting flows you don't own.
 ```

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