@pnp/cli-microsoft365 6.9.0-beta.91abae4 → 6.9.0-beta.d8f8efb

package/docs/docs/cmd/aad/user/user-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 list
 
@@ -62,6 +64,56 @@ Show all account managers whose display name starts with _Patt_
 m365 aad user list --displayName Patt --jobTitle 'Account manager'
 ```
 
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "userPrincipalName": "John@contoso.onmicrosoft.com",
+      "displayName": "John Doe"
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  userPrincipalName                         displayName
+  ----------------------------------------  -------------------------
+  John@contoso.onmicrosoft.com              John Doe
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  userPrincipalName,displayName
+  John@contoso.onmicrosoft.com,John Doe
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # aad user list
+
+  Date: 2023-06-02
+
+  ## John Doe
+
+  Property | Value
+  ---------|-------
+  userPrincipalName | John@contoso.onmicrosoft.com
+  displayName | John Doe
+  ```
+
+  </TabItem>
+</Tabs>
+
 ## More information
 
 - Microsoft Graph User properties: [https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties](https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties)

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