@pnp/cli-microsoft365 6.1.0-beta.fd67be0 → 6.2.0-beta.329fd79

package/docs/docs/cmd/spo/report/report-siteusagedetail.md

@@ -11,13 +11,13 @@ m365 spo report siteusagedetail [options]
 ## Options
 
 `-d, --date [date]`
-: The date for which you would like to view the users who performed any activity. Supported date format is `YYYY-MM-DD`. Specify the date or period, but not both.
+: The date for which you would like to view the users who performed any activity. Supported date format is `YYYY-MM-DD`. Specify either `date` or `period`, but not both.
 
 `-p, --period [period]`
-: The length of time over which the report is aggregated. Supported values `D7,D30,D90,D180`
+: The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`. Specify either `date` or `period`, but not both.
 
 `-f, --outputFile [outputFile]`
-: Path to the file where the report should be stored in
+: Path to the file where the report should be stored in.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -50,3 +50,43 @@ Gets details about SharePoint site usage for the last week and exports the repor
 ```sh
 m365 spo report siteusagedetail --period D7 --output json > "siteusagedetail.json"
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "Report Refresh Date": "2022-11-26",
+        "Site Id": "002caf24-2672-4bc4-bc41-2811d5dba62c",
+        "Site URL": "https://contoso.sharepoint.com/sites/ElMontePythons",
+        "Owner Display Name": "El Monte Pythons Owners",
+        "Is Deleted": "False",
+        "Last Activity Date": "",
+        "File Count": "2",
+        "Active File Count": "0",
+        "Page View Count": "0",
+        "Visited Page Count": "0",
+        "Storage Used (Byte)": "1475974",
+        "Storage Allocated (Byte)": "27487790694400",
+        "Root Web Template": "Group",
+        "Owner Principal Name": "ElMontePythons@contoso.onmicrosoft.com",
+        "Report Period": "7"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    Report Refresh Date,Site Id,Site URL,Owner Display Name,Is Deleted,Last Activity Date,File Count,Active File Count,Page View Count,Visited Page Count,Storage Used (Byte),Storage Allocated (Byte),Root Web Template,Owner Principal Name,Report Period
+    2022-11-26,002caf24-2672-4bc4-bc41-2811d5dba62c,https://contoso.sharepoint.com/sites/ElMontePythons,El Monte Pythons Owners,False,,2,0,0,0,1475974,27487790694400,Group,ElMontePythons@contoso.onmicrosoft.com,7
+    ```
+
+=== "CSV"
+
+    ```csv
+    Report Refresh Date,Site Id,Site URL,Owner Display Name,Is Deleted,Last Activity Date,File Count,Active File Count,Page View Count,Visited Page Count,Storage Used (Byte),Storage Allocated (Byte),Root Web Template,Owner Principal Name,Report Period
+    2022-11-26,002caf24-2672-4bc4-bc41-2811d5dba62c,https://contoso.sharepoint.com/sites/ElMontePythons,El Monte Pythons Owners,False,,2,0,0,0,1475974,27487790694400,Group,ElMontePythons@contoso.onmicrosoft.com,7
+    ```

package/docs/docs/cmd/spo/report/report-siteusagefilecounts.md

@@ -11,10 +11,10 @@ m365 spo report siteusagefilecounts [options]
 ## Options
 
 `-p, --period <period>`
-: The length of time over which the report is aggregated. Supported values `D7,D30,D90,D180`
+: The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
 
 `-f, --outputFile [outputFile]`
-: Path to the file where the report should be stored in
+: Path to the file where the report should be stored in.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -41,3 +41,34 @@ Get the total number of files across all sites and the number of active files fo
 ```sh
 m365 spo report siteusagefilecounts --period D7 --output json > "siteusagefilecounts.json"
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "Report Refresh Date": "2022-11-26",
+        "Site Type": "All",
+        "Total": "1320",
+        "Active": "3",
+        "Report Date": "2022-11-26",
+        "Report Period": "7"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    Report Refresh Date,Site Type,Total,Active,Report Date,Report Period
+    2022-11-26,All,1320,3,2022-11-26,7
+    ```
+
+=== "CSV"
+
+    ```csv
+    Report Refresh Date,Site Type,Total,Active,Report Date,Report Period
+    2022-11-26,All,1320,3,2022-11-26,7
+    ```

package/docs/docs/cmd/spo/report/report-siteusagepages.md

@@ -11,10 +11,10 @@ m365 spo report siteusagepages [options]
 ## Options
 
 `-p, --period <period>`
-: The length of time over which the report is aggregated. Supported values `D7,D30,D90,D180`
+: The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
 
 `-f, --outputFile [outputFile]`
-: Path to the file where the report should be stored in
+: Path to the file where the report should be stored in.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -37,3 +37,33 @@ Gets the number of pages viewed across all sites for the last week and exports t
 ```sh
 m365 spo report siteusagepages --period D7 --output json > "siteusagepages.json"
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "Report Refresh Date": "2022-11-26",
+        "Site Type": "All",
+        "Page View Count": "14",
+        "Report Date": "2022-11-26",
+        "Report Period": "7"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    Report Refresh Date,Site Type,Page View Count,Report Date,Report Period
+    2022-11-26,All,14,2022-11-26,7
+    ```
+
+=== "CSV"
+
+    ```csv
+    Report Refresh Date,Site Type,Page View Count,Report Date,Report Period
+    2022-11-26,All,14,2022-11-26,7
+    ```

package/docs/docs/cmd/spo/report/report-siteusagesitecounts.md

@@ -11,10 +11,10 @@ m365 spo report siteusagesitecounts [options]
 ## Options
 
 `-p, --period <period>`
-: The length of time over which the report is aggregated. Supported values `D7,D30,D90,D180`
+: The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
 
 `-f, --outputFile [outputFile]`
-: Path to the file where the report should be stored in
+: Path to the file where the report should be stored in.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -41,3 +41,34 @@ Gets the total number of files across all sites and the number of active files f
 ```sh
 m365 spo report siteusagesitecounts --period D7 --output json > "siteusagesitecounts.json"
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "Report Refresh Date": "2022-11-26",
+        "Site Type": "All",
+        "Total": "159",
+        "Active": "2",
+        "Report Date": "2022-11-26",
+        "Report Period": "7"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    Report Refresh Date,Site Type,Total,Active,Report Date,Report Period
+    2022-11-26,All,159,2,2022-11-26,7
+    ```
+
+=== "CSV"
+
+    ```csv
+    Report Refresh Date,Site Type,Total,Active,Report Date,Report Period
+    2022-11-26,All,159,2,2022-11-26,7
+    ```

package/docs/docs/cmd/spo/report/report-siteusagestorage.md

@@ -11,10 +11,10 @@ m365 spo report siteusagestorage [options]
 ## Options
 
 `-p, --period <period>`
-: The length of time over which the report is aggregated. Supported values `D7,D30,D90,D180`
+: The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
 
 `-f, --outputFile [outputFile]`
-: Path to the file where the report should be stored in
+: Path to the file where the report should be stored in.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -37,3 +37,33 @@ Gets the trend of storage allocated and consumed during the last week and export
 ```sh
 m365 spo report siteusagestorage --period D7 --output json > "siteusagestorage.json"
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "Report Refresh Date": "2022-11-26",
+        "Site Type": "All",
+        "Storage Used (Byte)": "2348104595",
+        "Report Date": "2022-11-26",
+        "Report Period": "7"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    Report Refresh Date,Site Type,Storage Used (Byte),Report Date,Report Period
+    2022-11-26,All,2348104595,2022-11-26,7
+    ```
+
+=== "CSV"
+
+    ```csv
+    Report Refresh Date,Site Type,Storage Used (Byte),Report Date,Report Period
+    2022-11-26,All,2348104595,2022-11-26,7
+    ```

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

@@ -11,16 +11,16 @@ m365 spo roledefinition add [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site to which role should be added
+: URL of the site to which role should be added.
 
 `-n, --name <name>`
-: role definition name
+: role definition name.
 
 `-d, --description [description]`
-: role definition description
+: role definition description.
 
 `--rights [rights]`
-: A case-sensitive string array that contain the permissions needed for the custom action. Allowed values `EmptyMask,ViewListItems,AddListItems,EditListItems,DeleteListItems,ApproveItems,OpenItems,ViewVersions,DeleteVersions,CancelCheckout,ManagePersonalViews,ManageLists,ViewFormPages,AnonymousSearchAccessList,Open,ViewPages,AddAndCustomizePages,ApplyThemeAndBorder,ApplyStyleSheets,ViewUsageData,CreateSSCSite,ManageSubwebs,CreateGroups,ManagePermissions,BrowseDirectories,BrowseUserInfo,AddDelPrivateWebParts,UpdatePersonalWebParts,ManageWeb,AnonymousSearchAccessWebLists,UseClientIntegration,UseRemoteAPIs,ManageAlerts,CreateAlerts,EditMyUserInfo,EnumeratePermissions,FullMask`. Default `EmptyMask`
+: A case-sensitive string array that contain the permissions needed for the custom action. Allowed values `EmptyMask`, `ViewListItems`, `AddListItems`, `EditListItems`, `DeleteListItems`, `ApproveItems`, `OpenItems`, `ViewVersions`, `DeleteVersions`, `CancelCheckout`, `ManagePersonalViews`, `ManageLists`, `ViewFormPages`, `AnonymousSearchAccessList`, `Open`, `ViewPages`, `AddAndCustomizePages`, `ApplyThemeAndBorder`, `ApplyStyleSheets`, `ViewUsageData`, `CreateSSCSite`, `ManageSubwebs`, `CreateGroups`, `ManagePermissions`, `BrowseDirectories`, `BrowseUserInfo`, `AddDelPrivateWebParts`,`UpdatePersonalWebParts`, `ManageWeb`, `AnonymousSearchAccessWebLists`, `UseClientIntegration`, `UseRemoteAPIs`, `ManageAlerts`, `CreateAlerts`, `EditMyUserInfo`, `EnumeratePermissions`, `FullMask`. Default `EmptyMask`.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -30,14 +30,18 @@ The `--rights` option accepts **case-sensitive** values.
 
 ## Examples
 
-Adds the role definition for site _https://contoso.sharepoint.com/sites/project-x_ with name _test_
+Adds the role definition for the given site
 
 ```sh
 m365 spo roledefinition add --webUrl https://contoso.sharepoint.com/sites/project-x --name test
 ```
 
-Adds the role definition for site _https://contoso.sharepoint.com/sites/project-x_ with name _test_ and description _test description_ and rights _ViewListItems,AddListItems,EditListItems,DeleteListItems_
+Adds the role definition for the given site with description and rights
 
 ```sh
 m365 spo roledefinition add --webUrl https://contoso.sharepoint.com/sites/project-x --name test --description "test description" --rights "ViewListItems,AddListItems,EditListItems,DeleteListItems"
 ```
+
+## Response
+
+The command won't return a response on success.

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

@@ -11,7 +11,7 @@ m365 spo roledefinition get [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site for which to retrieve the role definition
+: URL of the site for which to retrieve the role definition.
 
 `-i, --id <id>`
 : The Id of the role definition to retrieve.
@@ -20,8 +20,86 @@ m365 spo roledefinition get [options]
 
 ## Examples
 
-Retrieve the role definition for site _https://contoso.sharepoint.com/sites/project-x_ with id _1_
+Retrieve the role definition for the given site
 
 ```sh
 m365 spo roledefinition get --webUrl https://contoso.sharepoint.com/sites/project-x --id 1
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "BasePermissions": {
+        "High": "2147483647",
+        "Low": "4294967295"
+      },
+      "Description": "Has full control.",
+      "Hidden": false,
+      "Id": 1073741829,
+      "Name": "Full Control",
+      "Order": 1,
+      "RoleTypeKind": 5,
+      "BasePermissionsValue": [
+        "ViewListItems",
+        "AddListItems",
+        "EditListItems",
+        "DeleteListItems",
+        "ApproveItems",
+        "OpenItems",
+        "ViewVersions",
+        "DeleteVersions",
+        "CancelCheckout",
+        "ManagePersonalViews",
+        "ManageLists",
+        "ViewFormPages",
+        "AnonymousSearchAccessList",
+        "Open",
+        "ViewPages",
+        "AddAndCustomizePages",
+        "ApplyThemeAndBorder",
+        "ApplyStyleSheets",
+        "ViewUsageData",
+        "CreateSSCSite",
+        "ManageSubwebs",
+        "CreateGroups",
+        "ManagePermissions",
+        "BrowseDirectories",
+        "BrowseUserInfo",
+        "AddDelPrivateWebParts",
+        "UpdatePersonalWebParts",
+        "ManageWeb",
+        "AnonymousSearchAccessWebLists",
+        "UseClientIntegration",
+        "UseRemoteAPIs",
+        "ManageAlerts",
+        "CreateAlerts",
+        "EditMyUserInfo",
+        "EnumeratePermissions"
+      ],
+      "RoleTypeKindValue": "Administrator"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    BasePermissions     : {"High":"2147483647","Low":"4294967295"}
+    BasePermissionsValue: ["ViewListItems","AddListItems","EditListItems","DeleteListItems","ApproveItems","OpenItems","ViewVersions","DeleteVersions","CancelCheckout","ManagePersonalViews","ManageLists","ViewFormPages","AnonymousSearchAccessList","Open","ViewPages","AddAndCustomizePages","ApplyThemeAndBorder","ApplyStyleSheets","ViewUsageData","CreateSSCSite","ManageSubwebs","CreateGroups","ManagePermissions","BrowseDirectories","BrowseUserInfo","AddDelPrivateWebParts","UpdatePersonalWebParts","ManageWeb","AnonymousSearchAccessWebLists","UseClientIntegration","UseRemoteAPIs","ManageAlerts","CreateAlerts","EditMyUserInfo","EnumeratePermissions"]
+    Description         : Has full control.
+    Hidden              : false
+    Id                  : 1073741829
+    Name                : Full Control
+    Order               : 1
+    RoleTypeKind        : 5
+    RoleTypeKindValue   : Administrator
+    ```
+
+=== "CSV"
+
+    ```csv
+    BasePermissions,Description,Hidden,Id,Name,Order,RoleTypeKind,BasePermissionsValue,RoleTypeKindValue
+    "{""High"":""2147483647"",""Low"":""4294967295""}",Has full control.,,1073741829,Full Control,1,5,"[""ViewListItems"",""AddListItems"",""EditListItems"",""DeleteListItems"",""ApproveItems"",""OpenItems"",""ViewVersions"",""DeleteVersions"",""CancelCheckout"",""ManagePersonalViews"",""ManageLists"",""ViewFormPages"",""AnonymousSearchAccessList"",""Open"",""ViewPages"",""AddAndCustomizePages"",""ApplyThemeAndBorder"",""ApplyStyleSheets"",""ViewUsageData"",""CreateSSCSite"",""ManageSubwebs"",""CreateGroups"",""ManagePermissions"",""BrowseDirectories"",""BrowseUserInfo"",""AddDelPrivateWebParts"",""UpdatePersonalWebParts"",""ManageWeb"",""AnonymousSearchAccessWebLists"",""UseClientIntegration"",""UseRemoteAPIs"",""ManageAlerts"",""CreateAlerts"",""EditMyUserInfo"",""EnumeratePermissions""]",Administrator
+    ```

package/docs/docs/cmd/spo/roledefinition/roledefinition-list.md

@@ -11,14 +11,88 @@ m365 spo roledefinition list [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site for which to retrieve role definitions
+: URL of the site for which to retrieve role definitions.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
 
-Return list of role definitions for site _https://contoso.sharepoint.com/sites/project-x_
+Return list of role definitions for the given site
 
 ```sh
 m365 spo roledefinition list --webUrl https://contoso.sharepoint.com/sites/project-x
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "BasePermissions": {
+          "High": 2147483647,
+          "Low": 4294967295
+        },
+        "Description": "Has full control.",
+        "Hidden": false,
+        "Id": 1073741829,
+        "Name": "Full Control",
+        "Order": 1,
+        "RoleTypeKind": 5,
+        "BasePermissionsValue": [
+          "ViewListItems",
+          "AddListItems",
+          "EditListItems",
+          "DeleteListItems",
+          "ApproveItems",
+          "OpenItems",
+          "ViewVersions",
+          "DeleteVersions",
+          "CancelCheckout",
+          "ManagePersonalViews",
+          "ManageLists",
+          "ViewFormPages",
+          "AnonymousSearchAccessList",
+          "Open",
+          "ViewPages",
+          "AddAndCustomizePages",
+          "ApplyThemeAndBorder",
+          "ApplyStyleSheets",
+          "ViewUsageData",
+          "CreateSSCSite",
+          "ManageSubwebs",
+          "CreateGroups",
+          "ManagePermissions",
+          "BrowseDirectories",
+          "BrowseUserInfo",
+          "AddDelPrivateWebParts",
+          "UpdatePersonalWebParts",
+          "ManageWeb",
+          "AnonymousSearchAccessWebLists",
+          "UseClientIntegration",
+          "UseRemoteAPIs",
+          "ManageAlerts",
+          "CreateAlerts",
+          "EditMyUserInfo",
+          "EnumeratePermissions"
+        ],
+        "RoleTypeKindValue": "Administrator"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    Id          Name
+    ----------  -----------------------
+    1073741829  Full Control
+    ```
+
+=== "CSV"
+
+    ```csv
+    Id,Name
+    1073741829,Full Control
+    ```

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

@@ -11,26 +11,30 @@ m365 spo roledefinition remove [options]
 ## Options
 
 `-u, --webUrl <webUrl>`
-: URL of the site from which role should be removed
+: URL of the site from which role should be removed.
 
 `-i, --id <id>`
-: ID of the role definition to remove
+: ID of the role definition to remove.
 
 `--confirm`
-: Don't prompt for confirming removing the role definition
+: Don't prompt for confirming removing the role definition.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
 
-Remove the role definition from site  _https://contoso.sharepoint.com/sites/project-x_ with id _1_
+Remove the role definition from the given site
 
 ```sh
 m365 spo roledefinition remove --webUrl https://contoso.sharepoint.com/sites/project-x --id 1
 ```
 
-Remove the role definition from site  _https://contoso.sharepoint.com/sites/project-x_ with id _1_ and don't prompt for confirmation
+Remove the role definition from the given site and don't prompt for confirmation
 
 ```sh
 m365 spo roledefinition remove --webUrl https://contoso.sharepoint.com/sites/project-x --id 1 --confirm
 ```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/serviceprincipal/serviceprincipal-grant-add.md

@@ -17,10 +17,10 @@ m365 spo sp grant add
 ## Options
 
 `-r, --resource <resource>`
-: The name of the resource for which permissions should be granted
+: The name of the resource for which permissions should be granted.
 
 `-s, --scope <scope>`
-: The name of the permission that should be granted
+: The name of the permission that should be granted.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -42,3 +42,40 @@ Grant the service principal permission to a custom API
 ```sh
 m365 spo serviceprincipal grant add --resource 'contoso-api' --scope 'user_impersonation'
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "ClientId": "6004a642-185c-479a-992a-15d1c23e2229",
+      "ConsentType": "AllPrincipals",
+      "IsDomainIsolated": false,
+      "ObjectId": "QqYEYFwYmkeZKhXRwj4iKRcAa6TiIbFNvGnKY1dqONY",
+      "PackageName": null,
+      "Resource": "Microsoft Graph",
+      "ResourceId": "a46b0017-21e2-4db1-bc69-ca63576a38d6",
+      "Scope": "Mail.Read"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    ClientId        : 6004a642-185c-479a-992a-15d1c23e2229
+    ConsentType     : AllPrincipals
+    IsDomainIsolated: false
+    ObjectId        : QqYEYFwYmkeZKhXRwj4iKRcAa6TiIbFNvGnKY1dqONY
+    PackageName     : null
+    Resource        : Microsoft Graph
+    ResourceId      : a46b0017-21e2-4db1-bc69-ca63576a38d6
+    Scope           : Mail.Read
+    ```
+
+=== "CSV"
+
+    ```csv
+    ClientId,ConsentType,IsDomainIsolated,ObjectId,PackageName,Resource,ResourceId,Scope
+    6004a642-185c-479a-992a-15d1c23e2229,AllPrincipals,,QqYEYFwYmkeZKhXRwj4iKRcAa6TiIbFNvGnKY1dqONY,,Microsoft Graph,a46b0017-21e2-4db1-bc69-ca63576a38d6,Mail.Read
+    ```

package/docs/docs/cmd/spo/serviceprincipal/serviceprincipal-grant-list.md

@@ -30,3 +30,35 @@ List all permissions granted to the service principal
 ```sh
 m365 spo serviceprincipal grant list
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "IsDomainIsolated": false,
+        "ObjectId": "QqYEYFwYmkeZKhXRwj4iKV5QwbD60RVCo6xeMUG407E",
+        "PackageName": null,
+        "Resource": "Windows Azure Active Directory",
+        "ResourceId": "b0c1505e-d1fa-4215-a3ac-5e3141b8d3b1",
+        "Scope": "User.Read"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    IsDomainIsolated  ObjectId                                     PackageName  Resource                        ResourceId                            Scope
+    ----------------  -------------------------------------------  -----------  ------------------------------  ------------------------------------  --------------------------
+    false             QqYEYFwYmkeZKhXRwj4iKV5QwbD60RVCo6xeMUG407E  null         Windows Azure Active Directory  b0c1505e-d1fa-4215-a3ac-5e3141b8d3b1  User.Read
+    ```
+
+=== "CSV"
+
+    ```csv
+    IsDomainIsolated,ObjectId,PackageName,Resource,ResourceId,Scope
+    ,QqYEYFwYmkeZKhXRwj4iKV5QwbD60RVCo6xeMUG407E,,Windows Azure Active Directory,b0c1505e-d1fa-4215-a3ac-5e3141b8d3b1,User.Read
+    ```

package/docs/docs/cmd/spo/serviceprincipal/serviceprincipal-grant-revoke.md

@@ -17,7 +17,7 @@ m365 spo sp grant revoke
 ## Options
 
 `-i, --id <id>`
-: `ObjectId` of the permission grant to revoke
+: `ObjectId` of the permission grant to revoke.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -30,8 +30,12 @@ The permission grant you want to revoke is denoted using its `ObjectId`. You can
 
 ## Examples
 
-Revoke permission grant with ObjectId _50NAzUm3C0K9B6p8ORLtIsQccg4rMERGvFGRtBsk2fA_
+Revoke permission grant
 
 ```sh
 m365 spo serviceprincipal grant revoke --id 50NAzUm3C0K9B6p8ORLtIsQccg4rMERGvFGRtBsk2fA
 ```
+
+## Response
+
+The command won't return a response on success.