@pnp/cli-microsoft365 6.0.0-beta.f782445 → 6.0.0-beta.fcd2cc9

package/docs/docs/cmd/pp/gateway/gateway-get.md

@@ -0,0 +1,56 @@
+# pp gateway get
+
+Get information about the specified gateway
+
+## Usage
+
+```sh
+m365 pp gateway get [options]
+```
+
+## Options
+
+`-i, --id <id>`
+: ID of the Gateway.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Get information about the specified gateway.
+
+```sh
+m365 pp gateway get --id 1f69e798-5852-4fdd-ab01-33bb14b6e934
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "id":"22660b34-31b3-4744-a99c-5e154458a784",
+      "gatewayId":0,
+      "name":"Contoso Gateway",
+      "type":"Resource",
+      "publicKey":{
+        "exponent":"AQAB",
+        "modulus":"okJBN8MJyaVkjfkN75B6OgP7RYiC3KFMFaky9KqqudqiTOcZPRXlsG+emrbnnBpFzw7ywe4gWtUGnPCqy01RKeDZrFA3QfkVPJpH28OWfrmgkMQNsI4Op2uxwEyjnJAyfYxIsHlpevOZoDKpWJgV+sH6MRf/+LK4hN3vNJuWKKpf90rNwjipnYMumHyKVkd4Vssc9Ftsu4Samu0/TkXzUkyje5DxMF2ZK1Nt2TgItBcpKi4wLCP4bPDYYaa9vfOmBlji7U+gwuE5bjnmjazFljQ5sOP0VdA0fRoId3+nI7n1rSgRq265jNHX84HZbm2D/Pk8C0dElTmYEswGPDWEJQ=="
+      },
+      "gatewayAnnotation":"{\"gatewayContactInformation\":[\"admin@contoso.onmicrosoft.com\"],\"gatewayVersion\":\"3000.122.8\",\"gatewayWitnessString\":\"{\\\"EncryptedResult\\\":\\\"UyfEqNSy0e9S4D0m9oacPyYhgiXLWusCiKepoLudnTEe68iw9qEaV6qNqTbSKlVUwUkD9KjbnbV0O3vU97Q/KTJXpw9/1SiyhpO+JN1rcaL51mPjyQo0WwMHMo2PU3rdEyxsLjkJxJZHTh4+XGB/lQ==\\\",\\\"IV\\\":\\\"QxCYjHEl8Ab9i78ZBYpnDw==\\\",\\\"Signature\\\":\\\"upVXK3DvWdj5scw8iUDDilzQz1ovuNgeuXRpmf0N828=\\\"}\",\"gatewayMachine\":\"SPFxDevelop\",\"gatewaySalt\":\"rA1M34AdgdCbOYQMvo/izA==\",\"gatewayWitnessStringLegacy\":null,\"gatewaySaltLegacy\":null,\"gatewayDepartment\":null,\"gatewayVirtualNetworkSubnetId\":null}"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    id  : 22660b34-31b3-4744-a99c-5e154458a784    
+    name: Contoso Gateway 
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,name
+    22660b34-31b3-4744-a99c-5e154458a784,Contoso Gateway
+    ```

package/docs/docs/cmd/pp/gateway/gateway-list.md

@@ -19,3 +19,38 @@ List gateways for which the user is an admin
 ```sh
 m365 pp gateway list
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "id":"22660b34-31b3-4744-a99c-5e154458a784",
+        "gatewayId":0,
+        "name":"Contoso Gateway",
+        "type":"Resource",
+        "publicKey":{
+          "exponent":"AQAB",
+          "modulus":"okJBN8MJyaVkjfkN75B6OgP7RYiC3KFMFaky9KqqudqiTOcZPRXlsG+emrbnnBpFzw7ywe4gWtUGnPCqy01RKeDZrFA3QfkVPJpH28OWfrmgkMQNsI4Op2uxwEyjnJAyfYxIsHlpevOZoDKpWJgV+sH6MRf/+LK4hN3vNJuWKKpf90rNwjipnYMumHyKVkd4Vssc9Ftsu4Samu0/TkXzUkyje5DxMF2ZK1Nt2TgItBcpKi4wLCP4bPDYYaa9vfOmBlji7U+gwuE5bjnmjazFljQ5sOP0VdA0fRoId3+nI7n1rSgRq265jNHX84HZbm2D/Pk8C0dElTmYEswGPDWEJQ=="
+        },
+        "gatewayAnnotation":"{\"gatewayContactInformation\":[\"admin@contoso.onmicrosoft.com\"],\"gatewayVersion\":\"3000.122.8\",\"gatewayWitnessString\":\"{\\\"EncryptedResult\\\":\\\"UyfEqNSy0e9S4D0m9oacPyYhgiXLWusCiKepoLudnTEe68iw9qEaV6qNqTbSKlVUwUkD9KjbnbV0O3vU97Q/KTJXpw9/1SiyhpO+JN1rcaL51mPjyQo0WwMHMo2PU3rdEyxsLjkJxJZHTh4+XGB/lQ==\\\",\\\"IV\\\":\\\"QxCYjHEl8Ab9i78ZBYpnDw==\\\",\\\"Signature\\\":\\\"upVXK3DvWdj5scw8iUDDilzQz1ovuNgeuXRpmf0N828=\\\"}\",\"gatewayMachine\":\"SPFxDevelop\",\"gatewaySalt\":\"rA1M34AdgdCbOYQMvo/izA==\",\"gatewayWitnessStringLegacy\":null,\"gatewaySaltLegacy\":null,\"gatewayDepartment\":null,\"gatewayVirtualNetworkSubnetId\":null}"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    id                                   name
+    ------------------------------------ ---------------
+    22660b34-31b3-4744-a99c-5e154458a784 Contoso Gateway
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,name
+    22660b34-31b3-4744-a99c-5e154458a784,Contoso Gateway
+    ```

package/docs/docs/cmd/pp/managementapp/managementapp-add.md

@@ -48,3 +48,26 @@ Register Azure AD application named _My app_ as a management application for the
 ```sh
 m365 pp managementapp add --name "My app"
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "applicationId":"31359c7f-bd7e-475c-86db-fdb8c937548e"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    applicationId: 31359c7f-bd7e-475c-86db-fdb8c937548e
+    ```
+
+=== "CSV"
+
+    ```csv
+    applicationId
+    31359c7f-bd7e-475c-86db-fdb8c937548e
+    ```

package/docs/docs/cmd/pp/managementapp/managementapp-list.md

@@ -19,3 +19,30 @@ Lists management applications for Power Platform
 ```sh
 m365 pp managementapp list
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "applicationId":"31359c7f-bd7e-475c-86db-fdb8c937548e"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    applicationId
+    ------------------------------------
+    31359c7f-bd7e-475c-86db-fdb8c937548e
+    ```
+
+=== "CSV"
+
+    ```csv
+    applicationId
+    31359c7f-bd7e-475c-86db-fdb8c937548e
+    ```

package/docs/docs/cmd/pp/solution/solution-get.md

@@ -0,0 +1,86 @@
+# pp solution get
+
+Gets a specific solution in a given environment.
+
+## Usage
+
+```sh
+m365 pp solution get [options]
+```
+
+## Options
+
+`-e, --environment <environment>`
+: The name of the environment.
+
+`-i --id [id]`
+: The ID of the solution. Specify either `id` or `name` but not both.
+
+`-n, --name [name]`
+: The unique name (not the display name) of the solution. Specify either `id` or `name` but not both.
+
+`-a, --asAdmin`
+: Run the command as admin for environments you do not have explicitly assigned permissions to.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Gets a specific solution in a specific environment based on name
+
+```sh
+m365 pp solution get --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --name "Default"
+```
+
+Gets a specific solution in a specific environment based on name as Admin
+
+```sh
+m365 pp solution get --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --name "Default" --asAdmin
+```
+
+Gets a specific solution in a specific environment based on id
+
+```sh
+m365 pp solution get --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --id "ee62fd63-e49e-4c09-80de-8fae1b9a427e"
+```
+
+Gets a specific solution in a specific environment based on id as Admin
+
+```sh
+m365 pp solution get --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --id "ee62fd63-e49e-4c09-80de-8fae1b9a427e" --asAdmin
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "solutionid": "fd140aaf-4df4-11dd-bd17-0019b9312238",
+      "uniquename": "Default",
+      "version": "1.0",
+      "installedon": "2021-10-01T21:29:10Z",
+      "solutionpackageversion": null,
+      "friendlyname": "Default Solution",
+      "versionnumber": 860055,
+      "publisherid": {
+        "friendlyname": "Default Publisher for org6633049a",
+        "publisherid": "d21aab71-79e7-11dd-8874-00188b01e34f"
+      }
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    publisher : Default Publisher for org6633049a
+    uniquename: Default
+    version   : 1.0
+    ```
+
+=== "CSV"
+
+    ```csv
+    uniquename,version,publisher
+    Default,1.0,Default Publisher for org6633049a
+    ```

package/docs/docs/cmd/pp/solution/solution-list.md

@@ -0,0 +1,70 @@
+# pp solution list
+
+Lists solutions in a given environment.
+
+## Usage
+
+```sh
+m365 pp solution list [options]
+```
+
+## Options
+
+`-e, --environment <environment>`
+: The name of the environment
+
+`-a, --asAdmin`
+: Run the command as admin for environments you do not have explicitly assigned permissions to.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+List all solutions in a specific environment
+
+```sh
+m365 pp solution list --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339"
+```
+
+List all solutions in a specific environment as Admin
+
+```sh
+m365 pp solution list --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --asAdmin
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "solutionid": "00000001-0000-0000-0001-00000000009b",
+        "uniquename": "Crc00f1",
+        "version": "1.0.0.0",
+        "installedon": "2021-10-01T21:54:14Z",
+        "solutionpackageversion": null,
+        "friendlyname": "Common Data Services Default Solution",
+        "versionnumber": 860052,
+        "publisherid": {
+          "friendlyname": "CDS Default Publisher",
+          "publisherid": "00000001-0000-0000-0000-00000000005a"
+        }
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    uniquename  version    publisher
+    ----------  ---------  ---------------------
+    Crc00f1     1.0.0.0    CDS Default Publisher
+    ```
+
+=== "CSV"
+
+    ```csv
+    uniquename,version,publisher
+    Crc00f1,1.0.0.0,CDS Default Publisher
+    ```

package/docs/docs/cmd/pp/tenant/tenant-settings-list.md

@@ -0,0 +1,88 @@
+# pp tenant settings list
+
+Lists the global Power Platform tenant settings
+
+## Usage
+
+```sh
+m365 pp tenant settings list [options]
+```
+
+## Options
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! attention
+    This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
+
+## Examples
+
+Lists the global Power Platform settings of the tenant
+
+```sh
+m365 pp tenant settings list
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "walkMeOptOut": false,
+      "disableNPSCommentsReachout": false,
+      "disableNewsletterSendout": false,
+      "disableEnvironmentCreationByNonAdminUsers": false,
+      "disablePortalsCreationByNonAdminUsers": false,
+      "disableSurveyFeedback": false,
+      "disableTrialEnvironmentCreationByNonAdminUsers": false,
+      "disableCapacityAllocationByEnvironmentAdmins": false,
+      "disableSupportTicketsVisibleByAllUsers": false,
+      "powerPlatform": {
+        "search": {
+          "disableDocsSearch": false,
+          "disableCommunitySearch": false,
+          "disableBingVideoSearch": false
+        },
+        "teamsIntegration": {
+          "shareWithColleaguesUserLimit": 10000
+        },
+        "powerApps": {
+          "disableShareWithEveryone": false,
+          "enableGuestsToMake": false,
+          "disableMembersIndicator": false
+        },
+        "environments": {},
+        "governance": {
+          "disableAdminDigest": false,
+          "allowDeveloperEnvironmentProvisioning": false
+        },
+        "licensing": {
+          "disableBillingPolicyCreationByNonAdminUsers": false
+        },
+        "powerPages": {}
+      }
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    disableCapacityAllocationByEnvironmentAdmins  : false
+    disableEnvironmentCreationByNonAdminUsers     : false
+    disableNPSCommentsReachout                    : false
+    disablePortalsCreationByNonAdminUsers         : false
+    disableSupportTicketsVisibleByAllUsers        : false
+    disableSurveyFeedback                         : false
+    disableTrialEnvironmentCreationByNonAdminUsers: false
+    walkMeOptOut                                  : false
+    ```
+
+=== "CSV"
+
+    ```csv
+    disableCapacityAllocationByEnvironmentAdmins,disableEnvironmentCreationByNonAdminUsers,disableNPSCommentsReachout,disablePortalsCreationByNonAdminUsers,disableSupportTicketsVisibleByAllUsers,disableSurveyFeedback,disableTrialEnvironmentCreationByNonAdminUsers,walkMeOptOut
+    false,false,false,false,false,false,false,false
+    ```

package/docs/docs/cmd/search/externalconnection/externalconnection-remove.md

@@ -37,4 +37,4 @@ Removes external connection with name _Test_. Will NOT prompt for confirmation b
 
 ```sh
 m365 search externalconnection remove --name "Test" --confirm
-```
+```

package/docs/docs/cmd/spfx/project/project-rename.md

@@ -16,20 +16,7 @@ m365 spfx project rename [options]
 `--generateNewId`
 : Generate a new solution ID for the project
 
-`-h, --help`
-: output usage information
-
-`--query [query]`
-: JMESPath query string. See [http://jmespath.org/](http://jmespath.org/) for more information and examples
-
-`-o, --output [output]`
-: Output type. `json,text,csv,md`. Default `json`
-
-`--verbose`
-: Runs command with verbose logging
-
-`--debug`
-: Runs command with debug logging
+--8<-- "docs/cmd/_global.md"
 
 !!! important
     Run this command in the folder where the project that you want to rename is located.

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

@@ -32,7 +32,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.16.0-beta.1).
+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.16.0-beta.2).
 
 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/spfx/spfx-doctor.md

@@ -13,6 +13,9 @@ m365 spfx doctor [options]
 `-e, --env [env]`
 : Version of SharePoint for which to check compatibility: `sp2016|sp2019|spo`
 
+`-v, --spfxVersion [spfxVersion]`
+: Version of the SharePoint Framework Yeoman generator to check compatibility for without `v`, eg. `1.11.0`
+
 `-h, --help`
 : output usage information
 
@@ -48,7 +51,7 @@ Next to verifying the readiness of your environment to use a particular version
 
 ## Examples
 
-Verify if your environment meets the requirements to work with the SharePoint Framework
+Verify if your environment meets the requirements to work with SharePoint Framework based on the globally installed version of the SharePoint Framework Yeoman generator or the current project
 
 ```sh
 m365 spfx doctor --output text
@@ -59,3 +62,9 @@ Verify if your environment meets the requirements to work with the SharePoint Fr
 ```sh
 m365 spfx doctor --env sp2019 --output text
 ```
+
+Verify if your environment meets the requirements to work with SharePoint Framework v1.11.0
+
+```sh
+m365 spfx doctor --spfxVersion 1.11.0 --output text
+```

package/docs/docs/cmd/spo/contenttype/contenttype-add.md

@@ -14,7 +14,13 @@ m365 spo contenttype add [options]
 : Absolute URL of the site where the content type should be created
 
 `-l, --listTitle [listTitle]`
-: Title of the list where the content type should be created (if it should be created as a list content type)
+: Title of the list (if it is a list content type). Specify either `listTitle`, `listId` or `listUrl`.
+
+`--listId [listId]`
+: ID of the list (if it is a list content type). Specify either `listTitle`, `listId` or `listUrl`.
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list (if it is a list content type). Specify either `listTitle`, `listId` or `listUrl`.
 
 `-i, --id <id>`
 : The ID of the content type. Determines the parent content type
@@ -44,12 +50,24 @@ Create a site content type that inherits from the List item content type
 m365 spo contenttype add --webUrl https://contoso.sharepoint.com/sites/contoso-sales --name 'PnP Alert' --id 0x01007926A45D687BA842B947286090B8F67D --group 'PnP Content Types'
 ```
 
-Create a list content type that inherits from the List item content type
+Create a list (retrieved by Title) content type that inherits from the List item content type
 
 ```sh
 m365 spo contenttype add --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listTitle Alerts --name 'PnP Alert' --id 0x01007926A45D687BA842B947286090B8F67D
 ```
 
+Create a list (retrieved by ID) content type that inherits from the List item content type
+
+```sh
+m365 spo contenttype add --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listId '8c7a0fcd-9d64-4634-85ea-ce2b37b2ec0c' --name 'PnP Alert' --id 0x01007926A45D687BA842B947286090B8F67D
+```
+
+Create a list (retrieved by URL) content type that inherits from the List item content type
+
+```sh
+m365 spo contenttype add --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listUrl '/Shared Documents' --name 'PnP Alert' --id 0x01007926A45D687BA842B947286090B8F67D
+```
+
 ## More information
 
 - Content Type IDs: [https://docs.microsoft.com/en-us/previous-versions/office/developer/sharepoint-2010/aa543822(v%3Doffice.14)](https://docs.microsoft.com/en-us/previous-versions/office/developer/sharepoint-2010/aa543822(v%3Doffice.14))

package/docs/docs/cmd/spo/contenttype/contenttype-field-remove.md

@@ -14,7 +14,13 @@ m365 spo contenttype field remove [options]
 : Absolute URL of the site where the content type is located
 
 `-l, --listTitle [listTitle]`
-: Title of the list where the content type is located (if it is a list content type)
+: Title of the list (if it is a list content type). Specify either `listTitle`, `listId` or `listUrl`.
+
+`--listId [listId]`
+: ID of the list (if it is a list content type). Specify either `listTitle`, `listId` or `listUrl`.
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list (if it is a list content type). Specify either `listTitle`, `listId` or `listUrl`.
 
 `-i, --contentTypeId <contentTypeId>`
 : The ID of the content type to remove the column from
@@ -32,20 +38,32 @@ m365 spo contenttype field remove [options]
 
 ## Examples
 
-Remove column with ID _2c1ba4c4-cd9b-4417-832f-92a34bc34b2a_ from content type with ID _0x0100CA0FA0F5DAEF784494B9C6020C3020A6_ from web with URL _https://contoso.sharepoint.com_
+Remove column with a specific ID from a content type with a specific ID from a specific site.
 
 ```sh
 m365 spo contenttype field remove  --contentTypeId "0x0100CA0FA0F5DAEF784494B9C6020C3020A6" --fieldLinkId "880d2f46-fccb-43ca-9def-f88e722cef80" --webUrl https://contoso.sharepoint.com --confirm
 ```
 
-Remove column with ID _2c1ba4c4-cd9b-4417-832f-92a34bc34b2a_ from content type with ID _0x0100CA0FA0F5DAEF784494B9C6020C3020A6_ from web with URL _https://contoso.sharepoint.com_ updating child content types
+Remove column with a specific ID from a content type with a specific ID from a specific site and updating the child content types
 
 ```sh
 m365 spo contenttype field remove  --contentTypeId "0x0100CA0FA0F5DAEF784494B9C6020C3020A6" --fieldLinkId "880d2f46-fccb-43ca-9def-f88e722cef80" --webUrl https://contoso.sharepoint.com --updateChildContentTypes
 ```
 
-Remove fieldLink with ID _2c1ba4c4-cd9b-4417-832f-92a34bc34b2a_ from list content type with ID _0x0100CA0FA0F5DAEF784494B9C6020C3020A6_ from web with URL _https://contoso.sharepoint.com_
+Remove fieldLink with a specific ID from a list (obtained by Title) content type with a specific ID on a spefici site.
 
 ```sh
 m365 spo contenttype field remove  --contentTypeId "0x0100CA0FA0F5DAEF784494B9C6020C3020A60062F089A38C867747942DB2C3FC50FF6A" --fieldLinkId "880d2f46-fccb-43ca-9def-f88e722cef80" --webUrl https://contoso.sharepoint.com --listTitle "Documents"
 ```
+
+Remove fieldLink with a specific ID from a list (obtained by ID) content type with a specific ID on a spefici site.
+
+```sh
+m365 spo contenttype field remove  --contentTypeId "0x0100CA0FA0F5DAEF784494B9C6020C3020A60062F089A38C867747942DB2C3FC50FF6A" --fieldLinkId "880d2f46-fccb-43ca-9def-f88e722cef80" --webUrl https://contoso.sharepoint.com --listId "8c7a0fcd-9d64-4634-85ea-ce2b37b2ec0c"
+```
+
+Remove fieldLink with a specific ID from a list (obtained by URL) content type with a specific ID on a spefici site.
+
+```sh
+m365 spo contenttype field remove  --contentTypeId "0x0100CA0FA0F5DAEF784494B9C6020C3020A60062F089A38C867747942DB2C3FC50FF6A" --fieldLinkId "880d2f46-fccb-43ca-9def-f88e722cef80" --webUrl https://contoso.sharepoint.com --listUrl "/shared documents"
+```

package/docs/docs/cmd/spo/contenttype/contenttype-get.md

@@ -14,7 +14,13 @@ m365 spo contenttype get [options]
 : Absolute URL of the site where the content type is located
 
 `-l, --listTitle [listTitle]`
-: Title of the list where the content type is located (if it is a list content type)
+: Title of the list (if it is a list content type). Specify either `listTitle`, `listId` or `listUrl`.
+
+`--listId [listId]`
+: ID of the list (if it is a list content type). Specify either `listTitle`, `listId` or `listUrl`.
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list (if it is a list content type). Specify either `listTitle`, `listId` or `listUrl`.
 
 `-i, --id [id]`
 : The ID of the content type to retrieve. Specify either id or name but not both
@@ -39,11 +45,23 @@ m365 spo contenttype get --webUrl https://contoso.sharepoint.com/sites/contoso-s
 Retrieve site content type by name
 
 ```sh
-m365 spo contenttype get --webUrl https://contoso.sharepoint.com/sites/contoso-sales --name "Document"
+m365 spo contenttype get --webUrl https://contoso.sharepoint.com/sites/contoso-sales --name 'Document'
 ```
 
-Retrieve list content type
+Retrieve list (retrieved by Title) content type 
 
 ```sh
 m365 spo contenttype get --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listTitle Events --id 0x0100558D85B7216F6A489A499DB361E1AE2F
 ```
+
+Retrieve list (retrieved by ID) content type 
+
+```sh
+m365 spo contenttype get --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listId '8c7a0fcd-9d64-4634-85ea-ce2b37b2ec0c' --id 0x0100558D85B7216F6A489A499DB361E1AE2F
+```
+
+Retrieve list (retrieved by URL) content type 
+
+```sh
+m365 spo contenttype get --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listUrl '/Shared Documents' --id 0x0100558D85B7216F6A489A499DB361E1AE2F
+```

package/docs/docs/cmd/spo/contenttype/contenttype-set.md

@@ -0,0 +1,45 @@
+# spo contenttype set
+
+Update existing content type
+
+## Usage
+
+```sh
+m365 spo contenttype set [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: URL of the site where the content type to update is defined.
+
+`-i, --id [id]`
+: ID of the content type to update. Specify `id` or `name` but not both, one is required.
+
+`-n, name [name]`
+: Name of the content type to update. Specify the `id` or the `name` but not both, one is required.
+
+`--listTitle [listTitle]`
+: Title of the list if you want to update a list content type. Specify either `listTitle`, `listId` or `listUrl`.
+
+`--listId [listId]`
+: ID of the list if you want to update a list content type. Specify either `listTitle`, `listId` or `listUrl`.
+
+`--listUrl [listUrl]`
+: URL of the list if you want to update a list content type. Specify either `listTitle`, `listId` or `listUrl`.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Move site content type to a different group
+
+```sh
+m365 spo contenttype set --id 0x001001 --webUrl https://contoso.sharepoint.com --Group "My group"
+```
+
+Rename list content type
+
+```sh
+m365 spo contenttype set --name "My old item" --webUrl https://contoso.sharepoint.com --listTitle "My list" --Name "My item"
+```

package/docs/docs/cmd/spo/customaction/customaction-add.md

@@ -78,6 +78,9 @@ Note, how the clientSideComponentProperties option (-p) has escaped double quote
 
 The `--rights` option accepts **case sensitive** values.
 
+!!! warning "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.md#escaping-double-quotes-in-powershell) apply due to an issue. Remember that you can also use [file tokens](./../../../user-guide/using-cli.md#passing-complex-content-into-cli-options) instead.
+
 ## Examples
 
 Adds tenant-wide SharePoint Framework Application Customizer extension in site _https://contoso.sharepoint.com/sites/test_

package/docs/docs/cmd/spo/customaction/customaction-set.md

@@ -77,12 +77,13 @@ Running this command from the Windows Command Shell (cmd.exe) or PowerShell for
 m365 spo customaction set --webUrl https://contoso.sharepoint.com/sites/test --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --clientSideComponentProperties '{\"testMessage\":\"Test message\"}'
 ```
 
-Note, how the `clientSideComponentProperties` option (-p) has escaped double quotes `'{\"testMessage\":\"Test message\"}'` compared to execution from bash `'{"testMessage":"Test message"}'`.
-
 The `--rights` option accepts **case-sensitive** values.
 
 Note, specifying the scope option might speed up the execution of the command, but would not update the scope. If the scope has to be changed, then the existing custom action should be removed and new should be added with different scope.
 
+!!! warning "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.md#escaping-double-quotes-in-powershell) apply due to an issue. Remember that you can also use [file tokens](./../../../user-guide/using-cli.md#passing-complex-content-into-cli-options) instead.
+
 ## Examples
 
 Updates tenant-wide SharePoint Framework Application Customizer extension properties in site _https://contoso.sharepoint.com/sites/test_