@pnp/cli-microsoft365 6.0.0-beta.a9609a1 → 6.0.0-beta.aa5918d

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

@@ -49,3 +49,38 @@ 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

@@ -31,3 +31,40 @@ 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/solution/solution-publisher-get.md

@@ -0,0 +1,83 @@
+# pp solution publisher get
+
+Get information about the specified publisher in a given environment.
+
+## Usage
+
+```sh
+m365 pp solution publisher 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 publisher in a specific environment based on name
+
+```sh
+m365 pp solution publisher get --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --name "MicrosoftCorporation"
+```
+
+Gets a specific publisher in a specific environment based on name as Admin
+
+```sh
+m365 pp solution publisher get --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --name "MicrosoftCorporation" --asAdmin
+```
+
+Gets a specific publisher in a specific environment based on id
+
+```sh
+m365 pp solution publisher get --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --id "ee62fd63-e49e-4c09-80de-8fae1b9a427e"
+```
+
+Gets a specific publisher in a specific environment based on id as Admin
+
+```sh
+m365 pp solution publisher get --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --id "ee62fd63-e49e-4c09-80de-8fae1b9a427e" --asAdmin
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "publisherid": "d21aab70-79e7-11dd-8874-00188b01e34f",
+      "uniquename": "MicrosoftCorporation",
+      "friendlyname": "MicrosoftCorporation",
+      "versionnumber": 1226559,
+      "isreadonly": false,
+      "description": "Uitgever van Microsoft-oplossingen",
+      "customizationprefix": "",
+      "customizationoptionvalueprefix": 0
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    friendlyname: MicrosoftCorporation
+    publisherid : d21aab70-79e7-11dd-8874-00188b01e34f
+    uniquename  : MicrosoftCorporation
+    ```
+
+=== "CSV"
+
+    ```csv
+    publisherid,uniquename,friendlyname
+    d21aab70-79e7-11dd-8874-00188b01e34f,MicrosoftCorporation,MicrosoftCorporation
+    ```

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

@@ -0,0 +1,71 @@
+# pp solution publisher list
+
+Lists publishers in a given environment.
+
+## Usage
+
+```sh
+m365 pp solution publisher list [options]
+```
+
+## Options
+
+`-e, --environment <environment>`
+: The name of the environment
+
+`--includeMicrosoftPublishers`
+: Include the Microsoft Publishers
+
+`-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 publishers in a specific environment
+
+```sh
+m365 pp solution publisher list --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339"
+```
+
+List all publishers in a specific environment as Admin
+
+```sh
+m365 pp solution publisher list --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --asAdmin
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "publisherid": "00000001-0000-0000-0000-00000000005a",
+        "uniquename": "Cree38e",
+        "friendlyname": "CDS Default Publisher",
+        "versionnumber": 1074060,
+        "isreadonly": false,
+        "description": null,
+        "customizationprefix": "cr6c3",
+        "customizationoptionvalueprefix": 43186
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    publisherid                           uniquename                     friendlyname
+    ------------------------------------  -----------------------------  ----------------------------------
+    00000001-0000-0000-0000-00000000005a  Cree38e                        CDS Default Publisher
+    ```
+
+=== "CSV"
+
+    ```csv
+    publisherid,uniquename,friendlyname
+    00000001-0000-0000-0000-00000000005a,Cree38e,CDS Default Publisher
+    ```
+

package/docs/docs/cmd/pp/solution/solution-publisher-remove.md

@@ -0,0 +1,58 @@
+# solution remove
+
+Removes the specified publisher in the specified Power Platform environment
+
+## Usage
+
+```sh
+m365 pp solution publisher remove [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 name of the solution. Specify either `id` or `name` but not both.
+
+`--asAdmin`
+: Run the command as admin for environments you do not have explicitly assigned permissions to.
+
+`--confirm`
+: Don't prompt for confirmation
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Removes the specified publisher based on the name parameter
+
+```sh
+m365 pp solution publisher remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name "Publisher Name"
+```
+
+Removes the specified publisher based on the name parameter without confirmation
+
+```sh
+m365 pp solution publisher remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name "Publisher Name" --confirm
+```
+
+Removes the specified publisher based on the name parameter as admin
+
+```sh
+m365 pp solution publisher remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name "Publisher Name" --asAdmin
+```
+
+Removes the specified publisher owned by the currently signed-in user based on the id parameter
+
+```sh
+m365 pp solution publisher remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 00000001-0000-0000-0001-00000000009b
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -0,0 +1,82 @@
+# pp solution remove
+
+Removes the specified solution in the specified Power Platform environment
+
+## Usage
+
+```sh
+m365 pp solution remove [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.
+
+`--asAdmin`
+: Run the command as admin for environments you do not have explicitly assigned permissions to.
+
+`--confirm`
+: Don't prompt for confirmation
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Removes the specified solution with a specific name, owned by the currently signed-in user
+
+```sh
+m365 pp solution remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name "Solution Name"
+```
+
+Removes the specified solution owned by the currently signed-in user based on the name parameter without confirmation
+
+```sh
+m365 pp solution remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name "Solution Name" --confirm
+```
+
+Removes the specified solution owned by another user based on the name parameter
+
+```sh
+m365 pp solution remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name "Solution Name" --asAdmin
+```
+
+Removes the specified solution owned by another user based on the name parameter without confirmation
+
+```sh
+m365 pp solution remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name "solution Name" --asAdmin --confirm
+```
+
+Removes the specified solution owned by the currently signed-in user based on the id parameter
+
+```sh
+m365 pp solution remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 00000001-0000-0000-0001-00000000009b
+```
+
+Removes the specified solution owned by the currently signed-in user based on the id parameter without confirmation
+
+```sh
+m365 pp solution remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 00000001-0000-0000-0001-00000000009b --confirm
+```
+
+Removes the specified solution owned by another user based on the id parameter
+
+```sh
+m365 pp solution remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 00000001-0000-0000-0001-00000000009b --asAdmin
+```
+
+Removes the specified solution owned by another user based on the id parameter without confirmation
+
+```sh
+m365 pp solution remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 00000001-0000-0000-0001-00000000009b --asAdmin --confirm
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -24,3 +24,65 @@ 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/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.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.16.0-rc.0).
 
 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/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_

package/docs/docs/cmd/spo/eventreceiver/eventreceiver-remove.md

@@ -32,7 +32,7 @@ m365 spo eventreceiver remove [options]
 : The scope. Can be either "site" or "web". Defaults to "web". Only applicable when not specifying any of the list properties.
 
 `--confirm`
-: Don't prompt for confirming removing the event receiver
+: Don't prompt for confirmation.
 
 --8<-- "docs/cmd/_global.md"
 

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

@@ -37,6 +37,9 @@ m365 spo field set [options]
 
 Specify properties to update using their names, eg. `--Title 'New Title' --JSLink jslink.js`.
 
+!!! warning "Escaping JSON in PowerShell"
+    When updating column formatting for a field with the `--CustomFormatter` 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
 
 Update the title of the site column specified by its internal name and push changes to existing lists
@@ -60,5 +63,5 @@ m365 spo field set --webUrl https://contoso.sharepoint.com/sites/project-x --lis
 Update column formatting of the specified list column
 
 ```sh
-m365 spo field set --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'My List' --title 'MyColumn' --CustomFormatter '`{"schema":"https://developer.microsoft.com/json-schemas/sp/column-formatting.schema.json", "elmType": "div", "txtContent": "@currentField"}`'
+m365 spo field set --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'My List' --title 'MyColumn' --CustomFormatter '{"schema":"https://developer.microsoft.com/json-schemas/sp/column-formatting.schema.json", "elmType": "div", "txtContent": "@currentField"}'
 ```

package/docs/docs/cmd/spo/file/file-roleassignment-add.md

@@ -11,28 +11,28 @@ m365 spo file roleassignment add [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site where the file is located
+: URL of the site where the file is located.
 
 `--fileUrl [fileUrl]`
-: The server-relative URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both
+: The server-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
+: The UniqueId (GUID) of the file to retrieve. Specify either `fileUrl` or `fileId` but not both.
 
 `--principalId [principalId]`
-: The SharePoint Id of the principal. It may be either a user id or group id to add a role assignment for. Specify either upn, groupName or principalId.
+: The SharePoint Id of the principal. It may be either a user id or group id to add a role assignment for. Specify either `upn`, `groupName`, or `principalId` but not multiple.
 
 `--upn [upn]`
-: upn/email of user to assign role to. Specify either upn, groupName or principalId.
+: upn/email of user to assign role to. Specify either `upn`, `groupName`, or `principalId` but not multiple.
 
 `--groupName [groupName]`
-: The group name of Azure AD or SharePoint group. Specify either upn, groupName or principalId.
+: The group name of Azure AD or SharePoint group. Specify either `upn`, `groupName`, or `principalId` but not multiple.
 
 `--roleDefinitionId [roleDefinitionId]`
-: ID of role definition. Specify either roleDefinitionId or roleDefinitionName but not both
+: ID of role definition. Specify either `roleDefinitionId` or `roleDefinitionName` but not both.
 
 `--roleDefinitionName [roleDefinitionName]`
-: Enter the name of a role definition, like 'Contribute', 'Read', etc. Specify either roleDefinitionId or roleDefinitionName but not both
+: Enter the name of a role definition, like 'Contribute', 'Read', etc. Specify either `roleDefinitionId` or `roleDefinitionName` but not both.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -54,4 +54,4 @@ Adds a role assignment to a file with a specified server-relative URL the for a
 
 ```sh
 m365 spo file roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --fileUrl "/sites/project-x/documents/Test1.docx" --upn "testuser@tenant.onmicrosoft.com" --roleDefinitionName "Read"
-```
+```

package/docs/docs/cmd/spo/file/file-roleassignment-remove.md

@@ -20,13 +20,13 @@ m365 spo file roleassignment remove [options]
 : The UniqueId (GUID) of the file. Specify either `fileUrl` or `fileId` but not both.
 
 `--principalId [principalId]`
-: The SharePoint Id of the principal. It may be either a user id or group id. Specify either `upn`, `groupName`, or `principalId`.
+: The SharePoint Id of the principal. It may be either a user id or group id. Specify either `upn`, `groupName`, or `principalId` but not multiple.
 
 `--upn [upn]`
-: Upn/email of the user. Specify either `upn`, `groupName`, or `principalId`.
+: Upn/email of the user. Specify either `upn`, `groupName`, or `principalId` but not multiple.
 
 `--groupName [groupName]`
-: The group name of an Azure AD or SharePoint group. Specify either `upn`, `groupName`, or `principalId`.
+: The group name of an Azure AD or SharePoint group. Specify either `upn`, `groupName`, or `principalId` but not multiple.
 
 `--confirm [confirm]`
 : Don't prompt for confirmation.