@pnp/cli-microsoft365 6.9.0 → 6.10.0-beta.05cab2f

package/dist/m365/spo/commands/tenant/tenant-recyclebinitem-remove.js

@@ -39,54 +39,8 @@ class SpoTenantRecycleBinItemRemoveCommand extends SpoCommand_1.default {
     }
     commandAction(logger, args) {
         return __awaiter(this, void 0, void 0, function* () {
-            const removeDeletedSite = () => __awaiter(this, void 0, void 0, function* () {
-                try {
-                    this.spoAdminUrl = yield spo_1.spo.getSpoAdminUrl(logger, this.debug);
-                    const res = yield spo_1.spo.ensureFormDigest(this.spoAdminUrl, logger, this.context, this.debug);
-                    if (this.verbose) {
-                        logger.logToStderr(`Removing deleted site collection ${args.options.siteUrl}...`);
-                    }
-                    const requestOptions = {
-                        url: `${this.spoAdminUrl}/_vti_bin/client.svc/ProcessQuery`,
-                        headers: {
-                            'X-RequestDigest': res.FormDigestValue
-                        },
-                        data: `<Request AddExpandoFieldTypeSuffix="true" SchemaVersion="15.0.0.0" LibraryVersion="16.0.0.0" ApplicationName="${config_1.default.applicationName}" xmlns="http://schemas.microsoft.com/sharepoint/clientquery/2009"><Actions><ObjectPath Id="16" ObjectPathId="15" /><Query Id="17" ObjectPathId="15"><Query SelectAllProperties="false"><Properties><Property Name="PollingInterval" ScalarProperty="true" /><Property Name="IsComplete" ScalarProperty="true" /></Properties></Query></Query></Actions><ObjectPaths><Method Id="15" ParentId="1" Name="RemoveDeletedSite"><Parameters><Parameter Type="String">${formatting_1.formatting.escapeXml(args.options.siteUrl)}</Parameter></Parameters></Method><Constructor Id="1" TypeId="{268004ae-ef6b-4e9b-8425-127220d84719}" /></ObjectPaths></Request>`
-                    };
-                    const processQuery = yield request_1.default.post(requestOptions);
-                    const json = JSON.parse(processQuery);
-                    const response = json[0];
-                    if (response.ErrorInfo) {
-                        throw response.ErrorInfo.ErrorMessage;
-                    }
-                    else {
-                        const operation = json[json.length - 1];
-                        const isComplete = operation.IsComplete;
-                        if (!args.options.wait || isComplete) {
-                            return;
-                        }
-                        yield new Promise((resolve, reject) => {
-                            setTimeout(() => {
-                                spo_1.spo.waitUntilFinished({
-                                    operationId: JSON.stringify(operation._ObjectIdentity_),
-                                    siteUrl: this.spoAdminUrl,
-                                    resolve,
-                                    reject,
-                                    logger,
-                                    currentContext: this.context,
-                                    debug: this.debug,
-                                    verbose: this.verbose
-                                });
-                            }, operation.PollingInterval);
-                        });
-                    }
-                }
-                catch (err) {
-                    this.handleRejectedODataJsonPromise(err);
-                }
-            });
             if (args.options.confirm) {
-                yield removeDeletedSite();
+                yield this.removeDeletedSite(logger, args);
             }
             else {
                 const result = yield Cli_1.Cli.prompt({
@@ -96,11 +50,57 @@ class SpoTenantRecycleBinItemRemoveCommand extends SpoCommand_1.default {
                     message: `Are you sure you want to remove the deleted site collection ${args.options.siteUrl} from tenant recycle bin?`
                 });
                 if (result.continue) {
-                    yield removeDeletedSite();
+                    yield this.removeDeletedSite(logger, args);
                 }
             }
         });
     }
+    removeDeletedSite(logger, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const spoAdminUrl = yield spo_1.spo.getSpoAdminUrl(logger, this.debug);
+                const res = yield spo_1.spo.ensureFormDigest(spoAdminUrl, logger, this.context, this.debug);
+                if (this.verbose) {
+                    logger.logToStderr(`Removing deleted site collection ${args.options.siteUrl}...`);
+                }
+                const requestOptions = {
+                    url: `${spoAdminUrl}/_vti_bin/client.svc/ProcessQuery`,
+                    headers: {
+                        'X-RequestDigest': res.FormDigestValue
+                    },
+                    data: `<Request AddExpandoFieldTypeSuffix="true" SchemaVersion="15.0.0.0" LibraryVersion="16.0.0.0" ApplicationName="${config_1.default.applicationName}" xmlns="http://schemas.microsoft.com/sharepoint/clientquery/2009"><Actions><ObjectPath Id="16" ObjectPathId="15" /><Query Id="17" ObjectPathId="15"><Query SelectAllProperties="false"><Properties><Property Name="PollingInterval" ScalarProperty="true" /><Property Name="IsComplete" ScalarProperty="true" /></Properties></Query></Query></Actions><ObjectPaths><Method Id="15" ParentId="1" Name="RemoveDeletedSite"><Parameters><Parameter Type="String">${formatting_1.formatting.escapeXml(args.options.siteUrl)}</Parameter></Parameters></Method><Constructor Id="1" TypeId="{268004ae-ef6b-4e9b-8425-127220d84719}" /></ObjectPaths></Request>`
+                };
+                const processQuery = yield request_1.default.post(requestOptions);
+                const json = JSON.parse(processQuery);
+                const response = json[0];
+                if (response.ErrorInfo) {
+                    throw response.ErrorInfo.ErrorMessage;
+                }
+                const operation = json[json.length - 1];
+                const isComplete = operation.IsComplete;
+                if (!args.options.wait || isComplete) {
+                    return;
+                }
+                yield new Promise((resolve, reject) => {
+                    setTimeout(() => {
+                        spo_1.spo.waitUntilFinished({
+                            operationId: JSON.stringify(operation._ObjectIdentity_),
+                            siteUrl: spoAdminUrl,
+                            resolve,
+                            reject,
+                            logger,
+                            currentContext: this.context,
+                            debug: this.debug,
+                            verbose: this.verbose
+                        });
+                    }, operation.PollingInterval);
+                });
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        });
+    }
 }
 _SpoTenantRecycleBinItemRemoveCommand_instances = new WeakSet(), _SpoTenantRecycleBinItemRemoveCommand_initTelemetry = function _SpoTenantRecycleBinItemRemoveCommand_initTelemetry() {
     this.telemetry.push((args) => {

package/dist/m365/teams/commands/chat/chat-get.js

@@ -79,7 +79,7 @@ class TeamsChatGetCommand extends GraphCommand_1.default {
             const currentUserEmail = accessToken_1.accessToken.getUserNameFromAccessToken(Auth_1.default.service.accessTokens[this.resource].accessToken).toLowerCase();
             const existingChats = yield chatUtil_1.chatUtil.findExistingChatsByParticipants([currentUserEmail, ...participants]);
             if (!existingChats || existingChats.length === 0) {
-                throw new Error('No chat conversation was found with these participants.');
+                throw 'No chat conversation was found with these participants.';
             }
             if (existingChats.length === 1) {
                 return existingChats[0].id;
@@ -87,14 +87,14 @@ class TeamsChatGetCommand extends GraphCommand_1.default {
             const disambiguationText = existingChats.map(c => {
                 return `- ${c.id}${c.topic && ' - '}${c.topic} - ${c.createdDateTime && new Date(c.createdDateTime).toLocaleString()}`;
             }).join(os.EOL);
-            throw new Error(`Multiple chat conversations with these participants found. Please disambiguate:${os.EOL}${disambiguationText}`);
+            throw `Multiple chat conversations with these participants found. Please disambiguate:${os.EOL}${disambiguationText}`;
         });
     }
     getChatIdByName(name) {
         return __awaiter(this, void 0, void 0, function* () {
             const existingChats = yield chatUtil_1.chatUtil.findExistingGroupChatsByName(name);
             if (!existingChats || existingChats.length === 0) {
-                throw new Error('No chat conversation was found with this name.');
+                throw 'No chat conversation was found with this name.';
             }
             if (existingChats.length === 1) {
                 return existingChats[0].id;
@@ -103,7 +103,7 @@ class TeamsChatGetCommand extends GraphCommand_1.default {
                 const memberstring = c.members.map(m => m.email).join(', ');
                 return `- ${c.id} - ${c.createdDateTime && new Date(c.createdDateTime).toLocaleString()} - ${memberstring}`;
             }).join(os.EOL);
-            throw new Error(`Multiple chat conversations with this name found. Please disambiguate:${os.EOL}${disambiguationText}`);
+            throw `Multiple chat conversations with this name found. Please disambiguate:${os.EOL}${disambiguationText}`;
         });
     }
 }

package/dist/m365/teams/commands/chat/chat-message-send.js

@@ -74,14 +74,14 @@ class TeamsChatMessageSendCommand extends GraphCommand_1.default {
             const disambiguationText = existingChats.map(c => {
                 return `- ${c.id}${c.topic && ' - '}${c.topic} - ${c.createdDateTime && new Date(c.createdDateTime).toLocaleString()}`;
             }).join(os.EOL);
-            throw new Error(`Multiple chat conversations with this name found. Please disambiguate:${os.EOL}${disambiguationText}`);
+            throw `Multiple chat conversations with this name found. Please disambiguate:${os.EOL}${disambiguationText}`;
         });
     }
     getChatIdByName(chatName) {
         return __awaiter(this, void 0, void 0, function* () {
             const existingChats = yield chatUtil_1.chatUtil.findExistingGroupChatsByName(chatName);
             if (!existingChats || existingChats.length === 0) {
-                throw new Error('No chat conversation was found with this name.');
+                throw 'No chat conversation was found with this name.';
             }
             if (existingChats.length === 1) {
                 return existingChats[0].id;
@@ -90,7 +90,7 @@ class TeamsChatMessageSendCommand extends GraphCommand_1.default {
                 const memberstring = c.members.map(m => m.email).join(', ');
                 return `- ${c.id} - ${c.createdDateTime && new Date(c.createdDateTime).toLocaleString()} - ${memberstring}`;
             }).join(os.EOL);
-            throw new Error(`Multiple chat conversations with this name found. Please disambiguate:${os.EOL}${disambiguationText}`);
+            throw `Multiple chat conversations with this name found. Please disambiguate:${os.EOL}${disambiguationText}`;
         });
     }
     // This Microsoft Graph API request throws an intermittent 404 exception, saying that it cannot find the principal.
@@ -146,7 +146,7 @@ class TeamsChatMessageSendCommand extends GraphCommand_1.default {
                     }
                 }
             };
-            yield request_1.default.post(requestOptions);
+            return request_1.default.post(requestOptions);
         });
     }
 }

package/dist/utils/spo.js

@@ -19,6 +19,7 @@ const base_permissions_1 = require("../m365/spo/base-permissions");
 const request_1 = require("../request");
 const formatting_1 = require("./formatting");
 const odata_1 = require("./odata");
+const RoleType_1 = require("../m365/spo/commands/roledefinition/RoleType");
 exports.spo = {
     getRequestDigest(siteUrl) {
         const requestOptions = {
@@ -569,6 +570,30 @@ exports.spo = {
             return res.AadObjectId.NameId;
         });
     },
+    /**
+   * Retrieves the spo user by email.
+   * @param webUrl Web url
+   * @param email The email of the user
+   * @param logger the Logger object
+   * @param debug set if debug logging should be logged
+   */
+    getUserByEmail(webUrl, email, logger, debug) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (debug) {
+                logger.logToStderr(`Retrieving the spo user by email ${email}`);
+            }
+            const requestUrl = `${webUrl}/_api/web/siteusers/GetByEmail('${formatting_1.formatting.encodeQueryParameter(email)}')`;
+            const requestOptions = {
+                url: requestUrl,
+                headers: {
+                    'accept': 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            };
+            const userInstance = yield request_1.default.get(requestOptions);
+            return userInstance;
+        });
+    },
     /**
      * Retrieves the menu state for the quick launch.
      * @param webUrl Web url
@@ -628,6 +653,55 @@ exports.spo = {
             };
             return request_1.default.post(requestOptions);
         });
+    },
+    /**
+  * Retrieves the spo group by name.
+  * @param webUrl Web url
+  * @param name The name of the group
+  * @param logger the Logger object
+  * @param debug set if debug logging should be logged
+  */
+    getGroupByName(webUrl, name, logger, debug) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (debug) {
+                logger.logToStderr(`Retrieving the group by name ${name}`);
+            }
+            const requestUrl = `${webUrl}/_api/web/sitegroups/GetByName('${formatting_1.formatting.encodeQueryParameter(name)}')`;
+            const requestOptions = {
+                url: requestUrl,
+                headers: {
+                    'accept': 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            };
+            const groupInstance = yield request_1.default.get(requestOptions);
+            return groupInstance;
+        });
+    },
+    /**
+  * Retrieves the role definition by name.
+  * @param webUrl Web url
+  * @param name the name of the role definition
+  * @param logger the Logger object
+  * @param debug set if debug logging should be logged
+  */
+    getRoleDefinitionByName(webUrl, name, logger, debug) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (debug) {
+                logger.logToStderr(`Retrieving the role definitions for ${name}`);
+            }
+            const roledefinitions = yield odata_1.odata.getAllItems(`${webUrl}/_api/web/roledefinitions`);
+            const roledefinition = roledefinitions.find((role) => role.Name === name);
+            if (!roledefinition) {
+                throw `No roledefinition is found for ${name}`;
+            }
+            const permissions = new base_permissions_1.BasePermissions();
+            permissions.high = roledefinition.BasePermissions.High;
+            permissions.low = roledefinition.BasePermissions.Low;
+            roledefinition.BasePermissionsValue = permissions.parse();
+            roledefinition.RoleTypeKindValue = RoleType_1.RoleType[roledefinition.RoleTypeKind];
+            return roledefinition;
+        });
     }
 };
 //# sourceMappingURL=spo.js.map

package/docs/docs/_clisettings.mdx

@@ -0,0 +1,17 @@
+Setting name|Definition|Default value
+------------|----------|-------------
+`autoOpenLinksInBrowser`|Automatically open the browser for all commands which return a url and expect the user to copy paste this to the browser. For example when logging in, using `m365 login` in device code mode.|`false`
+`copyDeviceCodeToClipboard`|Automatically copy the device code to the clipboard when running `m365 login` command in device code mode|`false`
+`csvEscape`|Single character used for escaping; only apply to characters matching the quote and the escape options|`"`
+`csvHeader`|Display the column names on the first line|`true`
+`csvQuote`|The quote characters surrounding a field. An empty quote value will preserve the original field, whether it contains quotation marks or not.|` `
+`csvQuoted`|Quote all the non-empty fields even if not required|`false`
+`csvQuotedEmpty`|Quote empty strings and overrides quoted_string on empty strings when defined|`false`
+`disableTelemetry`|Disables sending of telemetry data|`false`
+`errorOutput`|Defines if errors should be written to `stdout` or `stderr`|`stderr`
+`helpMode`|Defines what part of command's help to display. Allowed values are `options`, `examples`, `remarks`, `response`, `full`|`full`
+`output`|Defines the default output when issuing a command. Allowed values are `json`, `text`, `csv`, `md`, `none`|`json`
+`printErrorsAsPlainText`|When output mode is set to `json`, print error messages as plain-text rather than JSON|`true`
+`prompt`|Prompts for missing values in required options and enables interactive selection when multiple values are available for a command that requires a specific value to be retrieved.|`false`
+`showHelpOnFailure`|Automatically display help when executing a command failed|`true`
+`showSpinner`|Display spinner when executing commands|`true`

package/docs/docs/cmd/_global.mdx

@@ -6,7 +6,7 @@
 : 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`.
+: Output type. `json`, `text`, `csv`, `md`, `none`. Default `json`.
 
 `--verbose`
 : Runs command with verbose logging.

package/docs/docs/cmd/pa/app/app-get.mdx

@@ -9,7 +9,7 @@ Gets information about the specified Microsoft Power App
 ## Usage
 
 ```sh
-pa app get [options]
+m365 pa app get [options]
 ```
 
 ## Options

package/docs/docs/cmd/pa/app/app-list.mdx

@@ -9,7 +9,7 @@ Lists all Power Apps apps
 ## Usage
 
 ```sh
-pa app list [options]
+m365 pa app list [options]
 ```
 
 ## Options

package/docs/docs/cmd/pp/aibuildermodel/aibuildermodel-get.mdx

@@ -9,7 +9,7 @@ Gets a specific AI builder models in the specified Power Platform environment
 ## Usage
 
 ```sh
-pp aibuildermodel get [options]
+m365 pp aibuildermodel get [options]
 ```
 
 ## Options

package/docs/docs/cmd/pp/aibuildermodel/aibuildermodel-list.mdx

@@ -9,7 +9,7 @@ List available AI builder models in the specified Power Platform environment
 ## Usage
 
 ```sh
-pp aibuildermodel list [options]
+m365 pp aibuildermodel list [options]
 ```
 
 ## Options

package/docs/docs/cmd/pp/card/card-clone.mdx

@@ -9,7 +9,7 @@ Clones a specific Microsoft Power Platform card in the specified Power Platform
 ## Usage
 
 ```sh
-pp card clone [options]
+m365 pp card clone [options]
 ```
 
 ## Options

package/docs/docs/cmd/pp/card/card-get.mdx

@@ -9,7 +9,7 @@ Gets a specific Microsoft Power Platform card in the specified Power Platform en
 ## Usage
 
 ```sh
-pp card get [options]
+m365 pp card get [options]
 ```
 
 ## Options

package/docs/docs/cmd/pp/card/card-list.mdx

@@ -9,7 +9,7 @@ Lists Microsoft Power Platform cards in the specified Power Platform environment
 ## Usage
 
 ```sh
-pp card list [options]
+m365 pp card list [options]
 ```
 
 ## Options

package/docs/docs/cmd/pp/chatbot/chatbot-get.mdx

@@ -9,7 +9,7 @@ Get information about the specified chatbot
 ## Usage
 
 ```sh
-pp chatbot get [options]
+m365 pp chatbot get [options]
 ```
 
 ## Options

package/docs/docs/cmd/pp/chatbot/chatbot-list.mdx

@@ -9,7 +9,7 @@ Lists Microsoft Power Platform chatbot in the specified Power Platform environme
 ## Usage
 
 ```sh
-pp chatbot list [options]
+m365 pp chatbot list [options]
 ```
 
 ## Options

package/docs/docs/cmd/pp/dataverse/dataverse-table-get.mdx

@@ -9,7 +9,7 @@ List a dataverse table in a given environment
 ## Usage
 
 ```sh
-pp dataverse table get [options]
+m365 pp dataverse table get [options]
 ```
 
 ## Options

package/docs/docs/cmd/pp/dataverse/dataverse-table-list.mdx

@@ -9,7 +9,7 @@ Lists dataverse tables in a given environment
 ## Usage
 
 ```sh
-pp dataverse table list [options]
+m365 pp dataverse table list [options]
 ```
 
 ## Options

package/docs/docs/cmd/pp/dataverse/dataverse-table-remove.mdx

@@ -7,7 +7,7 @@ Removes a dataverse table in a given environment
 ## Usage
 
 ```sh
-pp dataverse table remove [options]
+m365 pp dataverse table remove [options]
 ```
 
 ## Options

package/docs/docs/cmd/pp/dataverse/dataverse-table-row-list.mdx

@@ -9,7 +9,7 @@ Lists table rows for the given Dataverse table
 ## Usage
 
 ```sh
-pp dataverse table row list [options]
+m365 pp dataverse table row list [options]
 ```
 
 ## Options

package/docs/docs/cmd/pp/dataverse/dataverse-table-row-remove.mdx

@@ -7,7 +7,7 @@ Removes a row from a dataverse table in a given environment.
 ## Usage
 
 ```sh
-pp dataverse table row remove [options]
+m365 pp dataverse table row remove [options]
 ```
 
 ## Options

package/docs/docs/cmd/spo/site/site-add.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo site add
 
@@ -178,6 +180,39 @@ Create new classic site collection using the Team site template. Set time zone t
 m365 spo site add --type ClassicSite --url https://contoso.sharepoint.com/sites/team --title Team --owners admin@contoso.onmicrosoft.com --timeZone 4 --webTemplate STS#0 --removeDeletedSite --wait
 ```
 
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  "https://contoso.sharepoint.com/sites/marketing"
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  https://contoso.sharepoint.com/sites/marketing
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  https://contoso.sharepoint.com/sites/marketing
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  https://contoso.sharepoint.com/sites/marketing
+  ```
+
+  </TabItem>
+</Tabs>
+
 ## More information
 
 - Creating SharePoint Communication Site using REST: [https://docs.microsoft.com/en-us/sharepoint/dev/apis/communication-site-creation-rest](https://docs.microsoft.com/en-us/sharepoint/dev/apis/communication-site-creation-rest)

package/docs/docs/cmd/spo/site/site-appcatalog-add.mdx

@@ -32,9 +32,13 @@ To use this command you have to have permissions to access the tenant admin site
 Add a site collection app catalog to the specified site
 
 ```sh
-m365 spo site appcatalog add --siteUrl https://contoso.sharepoint/sites/site
+m365 spo site appcatalog add --siteUrl https://contoso.sharepoint.com/sites/site
 ```
 
+## Response
+
+The command won't return a response on success.
+
 ## More information
 
 - Use the site collection app catalog: [https://docs.microsoft.com/en-us/sharepoint/dev/general-development/site-collection-app-catalog](https://docs.microsoft.com/en-us/sharepoint/dev/general-development/site-collection-app-catalog)

package/docs/docs/cmd/spo/site/site-appcatalog-list.mdx

@@ -64,6 +64,20 @@ m365 spo site appcatalog list
   https://contoso.sharepoint.com/sites/site1,9798e615-b586-455e-8486-84913f492c49
   ```
 
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spo site appcatalog list
+
+  Date: 2023-06-21
+
+  Property | Value
+  ---------|-------
+  AbsoluteUrl | https://contoso.sharepoint.com/sites/site1
+  SiteID | 9798e615-b586-455e-8486-84913f492c49
+  ```
+
   </TabItem>
 </Tabs>
 

package/docs/docs/cmd/spo/site/site-appcatalog-remove.mdx

@@ -37,6 +37,10 @@ Remove the site collection app catalog from specified site
 m365 spo site appcatalog remove --siteUrl https://contoso.sharepoint/sites/site
 ```
 
+## Response
+
+The command won't return a response on success.
+
 ## More information
 
 - Use the site collection app catalog: [https://docs.microsoft.com/en-us/sharepoint/dev/general-development/site-collection-app-catalog](https://docs.microsoft.com/en-us/sharepoint/dev/general-development/site-collection-app-catalog)

package/docs/docs/cmd/spo/site/site-apppermission-add.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo site apppermission add
 
@@ -39,3 +41,69 @@ Grants the specified app the _read_ permission to site _https://contoso.sharepoi
 ```sh
 m365 spo site apppermission add --siteUrl https://contoso.sharepoint.com/sites/project-x --permission read --appDisplayName Foo
 ```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+  "id": "aTowaS50fG1zLnNwLmV4dHw1Yzg5ZmJiZi02NzBlLTQ4ZTctYTBiYy1mYTg5NDJjODk1YTJAMWU4NTJiNDktYmY0Yi00YmE1LWJjZDQtYThjNDcwNmM4ZWQ0",
+  "roles": [
+    "read"
+  ],
+  "grantedToIdentitiesV2": [
+    {
+      "application": {
+        "displayName": "Foo",
+        "id": "5c89fbbf-670e-48e7-a0bc-fa8942c895a2"
+      }
+    }
+  ],
+  "grantedToIdentities": [
+    {
+      "application": {
+        "displayName": "Foo",
+        "id": "5c89fbbf-670e-48e7-a0bc-fa8942c895a2"
+      }
+    }
+  ]
+}
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  grantedToIdentities  : [{"application":{"displayName":"Foo","id":"5c89fbbf-670e-48e7-a0bc-fa8942c895a2"}}]
+  grantedToIdentitiesV2: [{"application":{"displayName":"Foo","id":"5c89fbbf-670e-48e7-a0bc-fa8942c895a2"}}]
+  id                   : aTowaS50fG1zLnNwLmV4dHw1Yzg5ZmJiZi02NzBlLTQ4ZTctYTBiYy1mYTg5NDJjODk1YTJAMWU4NTJiNDktYmY0Yi00YmE1LWJjZDQtYThjNDcwNmM4ZWQ0
+  roles                : ["read"]
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id
+  aTowaS50fG1zLnNwLmV4dHw1Yzg5ZmJiZi02NzBlLTQ4ZTctYTBiYy1mYTg5NDJjODk1YTJAMWU4NTJiNDktYmY0Yi00YmE1LWJjZDQtYThjNDcwNmM4ZWQ0
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spo site apppermission add --siteUrl "https://contoso.sharepoint.com/sites/team1" --permission "read" --appDisplayName "Foo"
+
+  Date: 2023-06-21
+
+  ## aTowaS50fG1zLnNwLmV4dHw1Yzg5ZmJiZi02NzBlLTQ4ZTctYTBiYy1mYTg5NDJjODk1YTJAMWU4NTJiNDktYmY0Yi00YmE1LWJjZDQtYThjNDcwNmM4ZWQ0
+
+  Property | Value
+  ---------|-------
+  id | aTowaS50fG1zLnNwLmV4dHw1Yzg5ZmJiZi02NzBlLTQ4ZTctYTBiYy1mYTg5NDJjODk1YTJAMWU4NTJiNDktYmY0Yi00YmE1LWJjZDQtYThjNDcwNmM4ZWQ0
+  ```
+
+  </TabItem>
+</Tabs>