@pnp/cli-microsoft365 6.8.0-beta.f473be5 → 6.8.0

package/dist/utils/formatting.js

@@ -1,9 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatting = void 0;
+exports.formatting = exports.CheckStatus = void 0;
+const chalk = require("chalk");
 const stripJsonComments = require("strip-json-comments");
 const base_permissions_1 = require("../m365/spo/base-permissions");
 const RoleType_1 = require("../m365/spo/commands/roledefinition/RoleType");
+/**
+ * Has the particular check passed or failed
+ */
+var CheckStatus;
+(function (CheckStatus) {
+    CheckStatus[CheckStatus["Success"] = 0] = "Success";
+    CheckStatus[CheckStatus["Failure"] = 1] = "Failure";
+})(CheckStatus = exports.CheckStatus || (exports.CheckStatus = {}));
 exports.formatting = {
     escapeXml(s) {
         if (!s) {
@@ -54,16 +63,23 @@ exports.formatting = {
         const regex = new RegExp(`\\s*(${quoteChar})?(.*?)\\1\\s*(?:${delimiter}|$)`, 'gs');
         const lines = s.split('\n');
         const match = (line) => [...line.matchAll(regex)]
-            .map(m => m[2]) // we only want the second capture group
-            .slice(0, -1); // cut off blank match at the end
-        const heads = match(lines[0]);
-        return lines.slice(1).map(line => {
-            return match(line).reduce((acc, cur, i) => {
-                const val = cur;
-                const numValue = parseInt(val);
-                const key = heads[i];
-                return Object.assign(Object.assign({}, acc), { [key]: isNaN(numValue) || numValue.toString() !== val ? val : numValue });
-            }, {});
+            .map(m => m[2]); // we only want the second capture group
+        const heads = match(lines[0]).slice(0, -1);
+        return lines.slice(1)
+            .filter(text => text.trim() !== '')
+            .map(line => {
+            const lineMatch = match(line);
+            const obj = {};
+            heads.forEach((key, index) => {
+                const value = parseInt(lineMatch[index]);
+                if (isNaN(value) || value.toString() !== lineMatch[index]) {
+                    obj[key] = lineMatch[index];
+                }
+                else {
+                    obj[key] = parseInt(lineMatch[index]);
+                }
+            });
+            return obj;
         });
     },
     encodeQueryParameter(value) {
@@ -132,6 +148,14 @@ exports.formatting = {
         }
         xml = xml.replace(/<\/?[0-9]{1,}>/g, '');
         return xml;
+    },
+    getStatus(result, message) {
+        const primarySupported = process.platform !== 'win32' ||
+            process.env.CI === 'true' ||
+            process.env.TERM === 'xterm-256color';
+        const success = primarySupported ? '✔' : '√';
+        const failure = primarySupported ? '✖' : '×';
+        return `${result === CheckStatus.Success ? chalk.green(success) : chalk.red(failure)} ${message}`;
     }
 };
 //# sourceMappingURL=formatting.js.map

package/dist/utils/pid.js

@@ -68,6 +68,11 @@ exports.pid = {
             return processName;
         }
         return undefined;
+    },
+    isPowerShell() {
+        const processName = exports.pid.getProcessName(process.ppid) || '';
+        return processName.indexOf('powershell') > -1 ||
+            processName.indexOf('pwsh') > -1;
     }
 };
 //# sourceMappingURL=pid.js.map

package/docs/docs/cmd/aad/o365group/o365group-get.md

@@ -8,12 +8,6 @@ Gets information about the specified Microsoft 365 Group or Microsoft Teams team
 m365 aad o365group get [options]
 ```
 
-## Alias
-
-```sh
-m365 teams team get
-```
-
 ## Options
 
 `-i, --id <id>`
@@ -37,9 +31,3 @@ Get information about the Microsoft 365 Group with id _1caf7dcd-7e83-4c3a-94f7-9
 ```sh
 m365 aad o365group get --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --includeSiteUrl
 ```
-
-Get information about the Microsoft Teams team with id _2eaf7dcd-7e83-4c3a-94f7-932a1299c844_
-
-```sh
-m365 teams team get --id 2eaf7dcd-7e83-4c3a-94f7-932a1299c844
-```

package/docs/docs/cmd/aad/user/user-add.md

@@ -71,6 +71,10 @@ m365 aad user add [options]
 !!! note
     After running this command, it may take a minute before the user is effectively created in the tenant.
 
+This command allows using unknown options. For a comprehensive list of user properties, please refer to the [Graph documentation page](https://learn.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0#properties).
+
+If the specified option is not found, you will receive a `Resource 'xyz' does not exist or one of its queried reference-property objects are not present.` error.
+
 ## Examples
 
 Create a user and let him/her update the password at first login

package/docs/docs/cmd/aad/user/user-set.md

@@ -74,9 +74,9 @@ m365 aad user set [options]
 
 ## Remarks
 
-This command allows using unknown options.
+This command allows using unknown options. For a comprehensive list of user properties, please refer to the [Graph documentation page](https://learn.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0#properties).
 
-If the user with the specified id or user name doesn't exist, you will get a `Resource 'xyz' does not exist or one of its queried reference-property objects are not present.` error.
+If the user with the specified ID or username doesn't exist, or if the specified option is not found, you will receive a `Resource 'xyz' does not exist or one of its queried reference-property objects are not present.` error.
 
 ## Examples
 

package/docs/docs/cmd/adaptivecard/adaptivecard-send.md

@@ -17,7 +17,7 @@ m365 adaptivecard send [options]
 : Title of the card. Specify either `title` or `card` but not both.
 
 `-d, --description [description]`
-: Contents of the card
+: Contents of the card.
 
 `-i, --imageUrl [imageUrl]`
 : URL of the image to include on the card.
@@ -48,73 +48,73 @@ If your custom card is a card template (card with placeholders like `${title}`),
 
 ## Examples
 
-Send a predefined adaptive card with just title
+Send a predefined adaptive card with just title.
 
 ```sh
 m365 adaptivecard send --url https://contoso.webhook.office.com/webhookb2/892e8ed3-997c-4b6e-8f8a-7f32728a8a87@f7322380-f203-42ff-93e8-66e266f6d2e4/IncomingWebhook/fcc6565ec7a944928bd43d6fc193b258/4f0482d4-b147-4f67-8a61-11f0a5019547 --title "CLI for Microsoft 365 v3.4"
 ```
 
-Send a predefined adaptive card with just description
+Send a predefined adaptive card with just description.
 
 ```sh
 m365 adaptivecard send --url https://contoso.webhook.office.com/webhookb2/892e8ed3-997c-4b6e-8f8a-7f32728a8a87@f7322380-f203-42ff-93e8-66e266f6d2e4/IncomingWebhook/fcc6565ec7a944928bd43d6fc193b258/4f0482d4-b147-4f67-8a61-11f0a5019547 --description "New release of CLI for Microsoft 365"
 ```
 
-Send card with title and description
+Send card with title and description.
 
 ```sh
 m365 adaptivecard send --url https://contoso.webhook.office.com/webhookb2/892e8ed3-997c-4b6e-8f8a-7f32728a8a87@f7322380-f203-42ff-93e8-66e266f6d2e4/IncomingWebhook/fcc6565ec7a944928bd43d6fc193b258/4f0482d4-b147-4f67-8a61-11f0a5019547 --title "CLI for Microsoft 365 v3.4" --description "New release of CLI for Microsoft 365"
 ```
 
-Send card with title, description and image
+Send card with title, description, and image.
 
 ```sh
 m365 adaptivecard send --url https://contoso.webhook.office.com/webhookb2/892e8ed3-997c-4b6e-8f8a-7f32728a8a87@f7322380-f203-42ff-93e8-66e266f6d2e4/IncomingWebhook/fcc6565ec7a944928bd43d6fc193b258/4f0482d4-b147-4f67-8a61-11f0a5019547 --title "CLI for Microsoft 365 v3.4" --description "New release of CLI for Microsoft 365" --imageUrl "https://contoso.com/image.gif"
 ```
 
-Send card with title, description and action
+Send card with title, description, and action.
 
 ```sh
 m365 adaptivecard send --url https://contoso.webhook.office.com/webhookb2/892e8ed3-997c-4b6e-8f8a-7f32728a8a87@f7322380-f203-42ff-93e8-66e266f6d2e4/IncomingWebhook/fcc6565ec7a944928bd43d6fc193b258/4f0482d4-b147-4f67-8a61-11f0a5019547 --title "CLI for Microsoft 365 v3.4" --description "New release of CLI for Microsoft 365" --actionUrl "https://aka.ms/cli-m365"
 ```
 
-Send card with title, description, image and action
+Send card with title, description, image, and action.
 
 ```sh
 m365 adaptivecard send --url https://contoso.webhook.office.com/webhookb2/892e8ed3-997c-4b6e-8f8a-7f32728a8a87@f7322380-f203-42ff-93e8-66e266f6d2e4/IncomingWebhook/fcc6565ec7a944928bd43d6fc193b258/4f0482d4-b147-4f67-8a61-11f0a5019547 --title "CLI for Microsoft 365 v3.4" --description "New release of CLI for Microsoft 365" --imageUrl "https://contoso.com/image.gif" --actionUrl "https://aka.ms/cli-m365"
 ```
 
-Send card with title, description, action and unknown options
+Send card with title, description, action, and unknown options.
 
 ```sh
 m365 adaptivecard send --url https://contoso.webhook.office.com/webhookb2/892e8ed3-997c-4b6e-8f8a-7f32728a8a87@f7322380-f203-42ff-93e8-66e266f6d2e4/IncomingWebhook/fcc6565ec7a944928bd43d6fc193b258/4f0482d4-b147-4f67-8a61-11f0a5019547 --title "CLI for Microsoft 365 v3.4" --description "New release of CLI for Microsoft 365" --actionUrl "https://aka.ms/cli-m365" --Version "v3.4.0" --ReleaseNotes "https://pnp.github.io/cli-microsoft365/about/release-notes/#v340"
 ```
 
-Send custom card without any data
+Send custom card without any data.
 
 ```sh
 m365 adaptivecard send --url https://contoso.webhook.office.com/webhookb2/892e8ed3-997c-4b6e-8f8a-7f32728a8a87@f7322380-f203-42ff-93e8-66e266f6d2e4/IncomingWebhook/fcc6565ec7a944928bd43d6fc193b258/4f0482d4-b147-4f67-8a61-11f0a5019547 --card '{"type":"AdaptiveCard","body":[{"type":"TextBlock","size":"Medium","weight":"Bolder","text":"CLI for Microsoft 365 v3.4"},{"type":"TextBlock","text":"New release of CLI for Microsoft 365","wrap":true}],"actions":[{"type":"Action.OpenUrl","title":"View","url":"https://aka.ms/cli-m365"}],"$schema":"http://adaptivecards.io/schemas/adaptive-card.json","version":"1.2"}'
 ```
 
-Send custom card with just title merged
+Send custom card with just title merged.
 
 ```sh
 m365 adaptivecard send --url https://contoso.webhook.office.com/webhookb2/892e8ed3-997c-4b6e-8f8a-7f32728a8a87@f7322380-f203-42ff-93e8-66e266f6d2e4/IncomingWebhook/fcc6565ec7a944928bd43d6fc193b258/4f0482d4-b147-4f67-8a61-11f0a5019547 --card '{"type":"AdaptiveCard","body":[{"type":"TextBlock","size":"Medium","weight":"Bolder","text":"${title}"}],"$schema":"http://adaptivecards.io/schemas/adaptive-card.json","version":"1.2"}' --title "CLI for Microsoft 365 v3.4"
 ```
 
-Send custom card with all known options merged
+Send custom card with all known options merged.
 
 ```sh
 m365 adaptivecard send --url https://contoso.webhook.office.com/webhookb2/892e8ed3-997c-4b6e-8f8a-7f32728a8a87@f7322380-f203-42ff-93e8-66e266f6d2e4/IncomingWebhook/fcc6565ec7a944928bd43d6fc193b258/4f0482d4-b147-4f67-8a61-11f0a5019547 --card '{"type":"AdaptiveCard","body":[{"type":"TextBlock","size":"Medium","weight":"Bolder","text":"${title}"},{"type":"TextBlock","text":"${description}","wrap":true},{"type":"FactSet","facts":[{"$data":"${properties}","title":"${key}:","value":"${value}"}]}],"actions":[{"type":"Action.OpenUrl","title":"View","url":"${actionUrl}"}],"$schema":"http://adaptivecards.io/schemas/adaptive-card.json","version":"1.2"}' --title "CLI for Microsoft 365 v3.4" --description "New release of CLI for Microsoft 365" --imageUrl "https://contoso.com/image.gif" --actionUrl "https://aka.ms/cli-m365"
 ```
 
-Send custom card with unknown option merged
+Send custom card with unknown option merged.
 
 ```sh
 m365 adaptivecard send --url https://contoso.webhook.office.com/webhookb2/892e8ed3-997c-4b6e-8f8a-7f32728a8a87@f7322380-f203-42ff-93e8-66e266f6d2e4/IncomingWebhook/fcc6565ec7a944928bd43d6fc193b258/4f0482d4-b147-4f67-8a61-11f0a5019547 --card '{"type":"AdaptiveCard","body":[{"type":"TextBlock","size":"Medium","weight":"Bolder","text":"${Title}"}],"$schema":"http://adaptivecards.io/schemas/adaptive-card.json","version":"1.2"}' --Title "CLI for Microsoft 365 v3.4"
 ```
 
-Send custom card with card data
+Send custom card with card data.
 
 ```sh
 m365 adaptivecard send --url https://contoso.webhook.office.com/webhookb2/892e8ed3-997c-4b6e-8f8a-7f32728a8a87@f7322380-f203-42ff-93e8-66e266f6d2e4/IncomingWebhook/fcc6565ec7a944928bd43d6fc193b258/4f0482d4-b147-4f67-8a61-11f0a5019547 --card '{"type":"AdaptiveCard","body":[{"type":"TextBlock","size":"Medium","weight":"Bolder","text":"${title}"},{"type":"TextBlock","text":"${description}","wrap":true},{"type":"FactSet","facts":[{"$data":"${properties}","title":"${key}:","value":"${value}"}]}],"actions":[{"type":"Action.OpenUrl","title":"View","url":"${viewUrl}"}],"$schema":"http://adaptivecards.io/schemas/adaptive-card.json","version":"1.2"}' --cardData '{"title":"Publish Adaptive Card Schema","description":"Now that we have defined the main rules and features of the format, we need to produce a schema and publish it to GitHub. The schema will be the starting point of our reference documentation.","creator":{"name":"Matt Hidinger","profileImage":"https://pbs.twimg.com/profile_images/3647943215/d7f12830b3c17a5a9e4afcc370e3a37e_400x400.jpeg"},"createdUtc":"2017-02-14T06:08:39Z","viewUrl":"https://adaptivecards.io","properties":[{"key":"Board","value":"Adaptive Cards"},{"key":"List","value":"Backlog"},{"key":"Assigned to","value":"Matt Hidinger"},{"key":"Due date","value":"Not set"}]}'

package/docs/docs/cmd/app/app-get.md

@@ -11,7 +11,7 @@ m365 app get [options]
 ## Options
 
 `--appId [appId]`
-: Client ID of the Azure AD app registered in the .m365rc.json file to retrieve information for
+: Client ID of the Azure AD app registered in the .m365rc.json file to retrieve information for.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -23,13 +23,13 @@ If you have multiple apps registered in your .m365rc.json file, you can specify
 
 ## Examples
 
-Retrieve information about your current Azure AD app
+Retrieve information about your current Azure AD app.
 
 ```sh
 m365 app get
 ```
 
-Retrieve information about the Azure AD app with client ID _e23d235c-fcdf-45d1-ac5f-24ab2ee0695d_ specified in the _.m365rc.json_ file
+Retrieve information about the Azure AD app with client ID specified in the _.m365rc.json_ file.
 
 ```sh
 m365 app get --appId e23d235c-fcdf-45d1-ac5f-24ab2ee0695d
@@ -54,7 +54,7 @@ m365 app get --appId e23d235c-fcdf-45d1-ac5f-24ab2ee0695d
       "isDeviceOnlyAuthSupported": null,
       "isFallbackPublicClient": null,
       "notes": null,
-      "publisherDomain": "8b7jz1.onmicrosoft.com",
+      "publisherDomain": "contoso.onmicrosoft.com",
       "serviceManagementReference": null,
       "signInAudience": "AzureADMyOrg",
       "tags": [],
@@ -172,7 +172,7 @@ m365 app get --appId e23d235c-fcdf-45d1-ac5f-24ab2ee0695d
     parentalControlSettings   : {"countriesBlockedForMinors":[],"legalAgeGroupRule":"Allow"}
     passwordCredentials       : []
     publicClient              : {"redirectUris":[]}
-    publisherDomain           : 8b7jz1.onmicrosoft.com
+    publisherDomain           : contoso.onmicrosoft.com
     requiredResourceAccess    : [{"resourceAppId":"b55b276d-2b09-4ad2-8de5-f09cf24ffba9","resourceAccess":[{"id":"162b1576-a2b2-458d-b7b9-04481911b4ef","type":"Role"}]},{"resourceAppId":"00000005-0000-0ff1-ce00-000000000000","resourceAccess":[{"id":"8e5870bb-8808-44dc-8e10-c509ed919ddd","type":"Scope"},{"id":"5db81a03-0de0-432b-b31e-71d57c8d2e0b","type":"Scope"}]}]
     samlMetadataUrl           : null
     serviceManagementReference: null
@@ -188,5 +188,24 @@ m365 app get --appId e23d235c-fcdf-45d1-ac5f-24ab2ee0695d
 
     ```csv
     id,deletedDateTime,appId,applicationTemplateId,disabledByMicrosoftStatus,createdDateTime,displayName,description,groupMembershipClaims,identifierUris,isDeviceOnlyAuthSupported,isFallbackPublicClient,notes,publisherDomain,serviceManagementReference,signInAudience,tags,tokenEncryptionKeyId,samlMetadataUrl,defaultRedirectUri,certification,optionalClaims,addIns,api,appRoles,info,keyCredentials,parentalControlSettings,passwordCredentials,publicClient,requiredResourceAccess,verifiedPublisher,web,spa
-    b3241f2a-6551-43d4-a72f-0d02ccfeb77f,,02f9ff8c-b79e-4552-bdda-4facd74d6df1,,,2022-10-28T21:20:57Z,My AAD app,,,[],,,,8b7jz1.onmicrosoft.com,,AzureADMyOrg,[],,,,,,[],"{""acceptMappedClaims"":null,""knownClientApplications"":[],""requestedAccessTokenVersion"":null,""oauth2PermissionScopes"":[],""preAuthorizedApplications"":[]}","[{""allowedMemberTypes"":[""User""],""description"":""Managers"",""displayName"":""Managers"",""id"":""d7c46856-8a66-485a-9047-098eba08b9a3"",""isEnabled"":true,""origin"":""Application"",""value"":""managers""}]","{""logoUrl"":null,""marketingUrl"":null,""privacyStatementUrl"":null,""supportUrl"":null,""termsOfServiceUrl"":null}",[],"{""countriesBlockedForMinors"":[],""legalAgeGroupRule"":""Allow""}",[],"{""redirectUris"":[]}","[{""resourceAppId"":""b55b276d-2b09-4ad2-8de5-f09cf24ffba9"",""resourceAccess"":[{""id"":""162b1576-a2b2-458d-b7b9-04481911b4ef"",""type"":""Role""}]},{""resourceAppId"":""00000005-0000-0ff1-ce00-000000000000"",""resourceAccess"":[{""id"":""8e5870bb-8808-44dc-8e10-c509ed919ddd"",""type"":""Scope""},{""id"":""5db81a03-0de0-432b-b31e-71d57c8d2e0b"",""type"":""Scope""}]}]","{""displayName"":null,""verifiedPublisherId"":null,""addedDateTime"":null}","{""homePageUrl"":null,""logoutUrl"":null,""redirectUris"":[],""implicitGrantSettings"":{""enableAccessTokenIssuance"":false,""enableIdTokenIssuance"":false},""redirectUriSettings"":[]}","{""redirectUris"":[]}"
+    b3241f2a-6551-43d4-a72f-0d02ccfeb77f,,02f9ff8c-b79e-4552-bdda-4facd74d6df1,,,2022-10-28T21:20:57Z,My AAD app,,,[],,,,contoso.onmicrosoft.com,,AzureADMyOrg,[],,,,,,[],"{""acceptMappedClaims"":null,""knownClientApplications"":[],""requestedAccessTokenVersion"":null,""oauth2PermissionScopes"":[],""preAuthorizedApplications"":[]}","[{""allowedMemberTypes"":[""User""],""description"":""Managers"",""displayName"":""Managers"",""id"":""d7c46856-8a66-485a-9047-098eba08b9a3"",""isEnabled"":true,""origin"":""Application"",""value"":""managers""}]","{""logoUrl"":null,""marketingUrl"":null,""privacyStatementUrl"":null,""supportUrl"":null,""termsOfServiceUrl"":null}",[],"{""countriesBlockedForMinors"":[],""legalAgeGroupRule"":""Allow""}",[],"{""redirectUris"":[]}","[{""resourceAppId"":""b55b276d-2b09-4ad2-8de5-f09cf24ffba9"",""resourceAccess"":[{""id"":""162b1576-a2b2-458d-b7b9-04481911b4ef"",""type"":""Role""}]},{""resourceAppId"":""00000005-0000-0ff1-ce00-000000000000"",""resourceAccess"":[{""id"":""8e5870bb-8808-44dc-8e10-c509ed919ddd"",""type"":""Scope""},{""id"":""5db81a03-0de0-432b-b31e-71d57c8d2e0b"",""type"":""Scope""}]}]","{""displayName"":null,""verifiedPublisherId"":null,""addedDateTime"":null}","{""homePageUrl"":null,""logoutUrl"":null,""redirectUris"":[],""implicitGrantSettings"":{""enableAccessTokenIssuance"":false,""enableIdTokenIssuance"":false},""redirectUriSettings"":[]}","{""redirectUris"":[]}"
+    ```
+
+=== "Markdown"
+
+    ```md
+    # app get --appId "02f9ff8c-b79e-4552-bdda-4facd74d6df1"
+
+    Date: 5/29/2023
+
+    ## My AAD app (b3241f2a-6551-43d4-a72f-0d02ccfeb77f)
+
+    Property | Value
+    ---------|-------
+    id | b3241f2a-6551-43d4-a72f-0d02ccfeb77f
+    appId | 02f9ff8c-b79e-4552-bdda-4facd74d6df1
+    createdDateTime | 2022-10-28T21:20:57Z
+    displayName | My AAD app
+    publisherDomain | contoso.onmicrosoft.com
+    signInAudience | AzureADMyOrg
     ```

package/docs/docs/cmd/app/app-open.md

@@ -1,6 +1,6 @@
 # app open
 
-Returns deep link of the current AD app to open the Azure portal on the Azure AD app registration management page.
+Returns deep link of the current AD app to open the Azure portal on the Azure AD app registration management page
 
 ## Usage
 
@@ -38,7 +38,7 @@ Prints the url of the Azure AD application registration management page on the p
 m365 app open --preview
 ```
 
-Prints the URL to the Azure AD application registration management page on the Azure Portal, evading a possible choice prompt in the case of multiple saved apps in the `.m365rc.json` file. 
+Prints the URL to the Azure AD application registration management page on the Azure Portal, evading a possible choice prompt in the case of multiple saved apps in the _.m365rc.json_ file. 
 
 ```sh
 m365 app open --appId d75be2e1-0204-4f95-857d-51a37cf40be8 
@@ -63,3 +63,9 @@ m365 app open --appId d75be2e1-0204-4f95-857d-51a37cf40be8
     ```csv
     Use a web browser to open the page https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationMenuBlade/Overview/appId/02f9ff8c-b79e-4552-bdda-4facd74d6df2/isMSAApp/
     ```
+
+=== "Markdown"
+
+    ```md
+    Use a web browser to open the page https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationMenuBlade/Overview/appId/02f9ff8c-b79e-4552-bdda-4facd74d6df2/isMSAApp/
+    ```

package/docs/docs/cmd/app/permission/permission-add.md

@@ -0,0 +1,53 @@
+# app permission add
+
+Adds the specified application and/or delegated permissions to the current AAD app API permissions
+
+## Usage
+
+```sh
+m365 app permission add [options]
+```
+
+## Options
+
+`--appId [appId]`
+: Client ID of the Azure AD app registered in the .m365rc.json file to retrieve API permissions for.
+
+`--applicationPermission [applicationPermission]`
+: Space-separated list of application permissions to add.
+
+`--delegatedPermission [delegatedPermission]`
+: Space-separated list of delegated permissions to add.
+
+`--grantAdminConsent`
+: If specified, admin consent to the newly added permissions will be granted.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+If you have multiple apps registered in your .m365rc.json file, you can specify the app for which you'd like to retrieve permissions using the `--appId` option. If you don't specify the app using the `--appId` option, you'll be prompted to select one of the applications from your .m365rc.json file.
+
+## Examples
+
+Adds the specified application permissions to the default app registered in the _.m365rc.json_ file while granting admin consent.
+
+```sh
+m365 app permission add --applicationPermission 'https://graph.microsoft.com/User.ReadWrite.All https://graph.microsoft.com/User.Read.All' --grantAdminConsent
+```
+
+Adds the specified delegated permissions to the default app registered in the _.m365rc.json_ file without granting admin consent.
+
+```sh
+m365 app permission add --delegatedPermission 'https://graph.microsoft.com/offline_access'
+```
+
+Adds the specified application and delegated permissions to a specific app registered in the _.m365rc.json_ file while granting admin consent.
+
+```sh
+m365 app permission add --appId '1663767b-4172-4519-bfd1-28e6ff19055b' --applicationPermission 'https://graph.microsoft.com/User.ReadWrite.All https://graph.microsoft.com/User.Read.All' --delegatedPermission 'https://graph.microsoft.com/offline_access' --grantAdminConsent
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/app/permission/permission-list.md

@@ -11,25 +11,25 @@ m365 app permission list [options]
 ## Options
 
 `--appId [appId]`
-: Client ID of the Azure AD app registered in the .m365rc.json file to retrieve API permissions for
+: Client ID of the Azure AD app registered in the .m365rc.json file to retrieve API permissions for.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
 
-Use this command to quickly look up API permissions for the Azure AD application registration registered in the .m365rc.json file in your current project (folder).
+Use this command to quickly look up API permissions for the Azure AD application registration registered in the _.m365rc.json_ file in your current project (folder).
 
-If you have multiple apps registered in your .m365rc.json file, you can specify the app for which you'd like to retrieve permissions using the `--appId` option. If you don't specify the app using the `--appId` option, you'll be prompted to select one of the applications from your .m365rc.json file.
+If you have multiple apps registered in your .m365rc.json file, you can specify the app for which you'd like to retrieve permissions using the `--appId` option. If you don't specify the app using the `--appId` option, you'll be prompted to select one of the applications from your _.m365rc.json_ file.
 
 ## Examples
 
-Retrieve API permissions for your current Azure AD app
+Retrieve API permissions for your current Azure AD app.
 
 ```sh
 m365 app permission list
 ```
 
-Retrieve API permissions for the Azure AD app with client ID _e23d235c-fcdf-45d1-ac5f-24ab2ee0695d_ specified in the _.m365rc.json_ file
+Retrieve API permissions for the Azure AD app with the client ID specified in the _.m365rc.json_ file.
 
 ```sh
 m365 app permission list --appId e23d235c-fcdf-45d1-ac5f-24ab2ee0695d
@@ -45,16 +45,6 @@ m365 app permission list --appId e23d235c-fcdf-45d1-ac5f-24ab2ee0695d
         "resource": "Microsoft Teams - Teams And Channels Service",
         "permission": "channels.readwrite",
         "type": "Application"
-      },
-      {
-        "resource": "Yammer",
-        "permission": "access_as_user",
-        "type": "Delegated"
-      },
-      {
-        "resource": "Yammer",
-        "permission": "user_impersonation",
-        "type": "Delegated"
       }
     ]
     ```
@@ -65,8 +55,6 @@ m365 app permission list --appId e23d235c-fcdf-45d1-ac5f-24ab2ee0695d
     resource                                      permission          type
     --------------------------------------------  ------------------  -----------
     Microsoft Teams - Teams And Channels Service  channels.readwrite  Application
-    Yammer                                        access_as_user      Delegated
-    Yammer                                        user_impersonation  Delegated
     ```
 
 === "CSV"
@@ -74,6 +62,18 @@ m365 app permission list --appId e23d235c-fcdf-45d1-ac5f-24ab2ee0695d
     ```csv
     resource,permission,type
     Microsoft Teams - Teams And Channels Service,channels.readwrite,Application
-    Yammer,access_as_user,Delegated
-    Yammer,user_impersonation,Delegated
+    ```
+
+=== "Markdown"
+
+    ```md
+    # app permission list
+
+    Date: 5/29/2023
+
+    Property | Value
+    ---------|-------
+    resource | Microsoft Teams - Teams And Channels Service
+    permission | channels.readwrite
+    type | Application
     ```

package/docs/docs/cmd/booking/business/business-get.md

@@ -20,13 +20,13 @@ m365 booking business get [options]
 
 ## Examples
 
-Retrieve the specified Microsoft Bookings business with id _business@contoso.onmicrosoft.com_.
+Retrieve the specified Microsoft Bookings business with the specified id.
 
 ```sh
 m365 booking business get --id 'business@contoso.onmicrosoft.com'
 ```
 
-Retrieve the specified Microsoft Bookings business with name _business name_.
+Retrieve the specified Microsoft Bookings business with the specified name.
 
 ```sh
 m365 booking business get --name 'business name'
@@ -38,15 +38,15 @@ m365 booking business get --name 'business name'
 
     ```json
     {
-      "id": "Accounting@8b7jz1.onmicrosoft.com",
+      "id": "Accounting@contoso.onmicrosoft.com",
       "displayName": "Accounting",
       "businessType": "Financial services",
       "phone": "",
-      "email": "runningdevadmin@8b7jz1.onmicrosoft.com",
+      "email": "runningdevadmin@contoso.onmicrosoft.com",
       "webSiteUrl": "",
       "defaultCurrencyIso": "USD",
       "isPublished": true,
-      "publicUrl": "https://outlook.office365.com/owa/calendar/Accounting@8b7jz1.onmicrosoft.com/bookings/",
+      "publicUrl": "https://outlook.office365.com/owa/calendar/Accounting@contoso.onmicrosoft.com/bookings/",
       "languageTag": "",
       "address": {
         "street": "",
@@ -126,8 +126,8 @@ m365 booking business get --name 'business name'
     businessType      : Financial services
     defaultCurrencyIso: USD
     displayName       : Accounting
-    email             : runningdevadmin@8b7jz1.onmicrosoft.com
-    id                : Accounting@8b7jz1.onmicrosoft.com
+    email             : runningdevadmin@contoso.onmicrosoft.com
+    id                : Accounting@contoso.onmicrosoft.com
     phone             :
     ```
 
@@ -135,6 +135,28 @@ m365 booking business get --name 'business name'
 
     ```csv
     id,displayName,businessType,phone,email,defaultCurrencyIso
-    Accounting@8b7jz1.onmicrosoft.com,Accounting,Financial services,,runningdevadmin@8b7jz1.onmicrosoft.com,USD
+    Accounting@contoso.onmicrosoft.com,Accounting,Financial services,,runningdevadmin@contoso.onmicrosoft.com,USD
+    ```
+
+=== "Markdown"
+
+    ```md
+    # booking business get --name "Accounting"
+
+    Date: 5/29/2023
+
+    ## Accounting (Accounting@contoso.onmicrosoft.com)
 
+    Property | Value
+    ---------|-------
+    id | Accounting@contoso.onmicrosoft.com
+    displayName | Accounting
+    businessType | Financial services
+    phone |
+    email | runningdevadmin@contoso.onmicrosoft.com
+    webSiteUrl |
+    defaultCurrencyIso | USD
+    isPublished | true
+    publicUrl | https://outlook.office365.com/owa/calendar/Accounting@contoso.onmicrosoft.com/bookings/
+    languageTag |
     ```

package/docs/docs/cmd/booking/business/business-list.md

@@ -29,10 +29,6 @@ m365 booking business list
       {
         "id": "Accounting@8b7jz1.onmicrosoft.com",
         "displayName": "Accounting"
-      },
-      {
-        "id": "BestShop@8b7jz1.onmicrosoft.com",
-        "displayName": "Best Shop"
       }
     ]
     ```
@@ -42,14 +38,27 @@ m365 booking business list
     ```text
     id                                 displayName
     ---------------------------------  -----------
-    Accounting@8b7jz7.onmicrosoft.com  Accounting
-    BestShop@8b7jz7.onmicrosoft.com    Best Shop
+    Accounting@contoso.onmicrosoft.com  Accounting
     ```
 
 === "CSV"
 
     ```csv
     id,displayName
-    Accounting@8b7jz7.onmicrosoft.com,Accounting
-    BestShop@8b7jz7.onmicrosoft.com,Best Shop
+    Accounting@contoso.onmicrosoft.com,Accounting
+    ```
+
+=== "Markdown"
+
+    ```md
+    # booking business list
+
+    Date: 5/29/2023
+
+    ## Accounting (Accounting@contoso.onmicrosoft.com)
+
+    Property | Value
+    ---------|-------
+    id | Accounting@contoso.onmicrosoft.com
+    displayName | Accounting
     ```

package/docs/docs/cmd/cli/cli-consent.md

@@ -50,3 +50,9 @@ m365 cli consent --service yammer
     ```csv
     To consent permissions for executing yammer commands, navigate in your web browser to https://login.microsoftonline.com/common/oauth2/v2.0/authorize?client_id=31359c7f-bd7e-475c-86db-fdb8c937548e&response_type=code&scope=https%3A%2F%2Fapi.yammer.com%2Fuser_impersonation
     ```
+
+=== "Markdown"
+
+    ```md
+    To consent permissions for executing yammer commands, navigate in your web browser to https://login.microsoftonline.com/common/oauth2/v2.0/authorize?client_id=31359c7f-bd7e-475c-86db-fdb8c937548e&response_type=code&scope=https%3A%2F%2Fapi.yammer.com%2Fuser_impersonation
+    ```

package/docs/docs/cmd/cli/cli-doctor.md

@@ -73,3 +73,20 @@ m365 cli doctor
     os,cliVersion,nodeVersion,cliAadAppId,cliAadAppTenant,authMode,cliEnvironment,cliConfig,roles,scopes
     "{""platform"":""win32"",""version"":""Windows 10 Pro"",""release"":""10.0.19045""}",6.1.0,v16.13.0,31359c7f-bd7e-475c-86db-fdb8c937548e,common,DeviceCode,,"{""output"":""json"",""showHelpOnFailure"":false}",[],"[""AllSites.FullControl""]"
     ```
+
+=== "Markdown"
+
+    ```md
+    # cli doctor
+
+    Date: 2022-09-05
+
+    Property | Value
+    ---------|-------
+    cliVersion | 6.1.0
+    nodeVersion | v16.13.0
+    cliAadAppId | 31359c7f-bd7e-475c-86db-fdb8c937548e
+    cliAadAppTenant | common
+    authMode | DeviceCode
+    cliEnvironment |
+    ```

package/docs/docs/cmd/cli/cli-issue.md

@@ -52,3 +52,9 @@ m365 cli issue --type command
     ```csv
     https://aka.ms/cli-m365/new-command
     ```
+
+=== "Markdown"
+
+    ```md
+    https://aka.ms/cli-m365/new-command
+    ```

package/docs/docs/cmd/cli/cli-reconsent.md

@@ -40,6 +40,12 @@ m365 cli reconsent
     To re-consent the PnP Microsoft 365 Management Shell Azure AD application navigate in your web browser to https://login.microsoftonline.com/common/oauth2/authorize?client_id=31359c7f-bd7e-475c-86db-fdb8c937548e&response_type=code&prompt=admin_consent
     ```
 
+=== "Markdown"
+
+    ```md
+    To re-consent the PnP Microsoft 365 Management Shell Azure AD application navigate in your web browser to https://login.microsoftonline.com/common/oauth2/authorize?client_id=31359c7f-bd7e-475c-86db-fdb8c937548e&response_type=code&prompt=admin_consent
+    ```
+
 ## More information
 
 - Re-consent the PnP Microsoft 365 Management Shell Azure AD application: [https://pnp.github.io/cli-microsoft365/user-guide/connecting-office-365/#re-consent-the-pnp-office-365-management-shell-azure-ad-application](https://pnp.github.io/cli-microsoft365/user-guide/connecting-office-365/#re-consent-the-pnp-office-365-management-shell-azure-ad-application)