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

package/dist/m365/teams/commands/chat/chat-member-remove.js

@@ -0,0 +1,137 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _TeamsChatMemberRemoveCommand_instances, _TeamsChatMemberRemoveCommand_initTelemetry, _TeamsChatMemberRemoveCommand_initOptions, _TeamsChatMemberRemoveCommand_initValidators, _TeamsChatMemberRemoveCommand_initOptionSets;
+Object.defineProperty(exports, "__esModule", { value: true });
+const odata_1 = require("../../../../utils/odata");
+const validation_1 = require("../../../../utils/validation");
+const GraphCommand_1 = require("../../../base/GraphCommand");
+const commands_1 = require("../../commands");
+const Cli_1 = require("../../../../cli/Cli");
+const request_1 = require("../../../../request");
+class TeamsChatMemberRemoveCommand extends GraphCommand_1.default {
+    get name() {
+        return commands_1.default.CHAT_MEMBER_REMOVE;
+    }
+    get description() {
+        return 'Removes a member from a Microsoft Teams chat conversation';
+    }
+    constructor() {
+        super();
+        _TeamsChatMemberRemoveCommand_instances.add(this);
+        __classPrivateFieldGet(this, _TeamsChatMemberRemoveCommand_instances, "m", _TeamsChatMemberRemoveCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _TeamsChatMemberRemoveCommand_instances, "m", _TeamsChatMemberRemoveCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _TeamsChatMemberRemoveCommand_instances, "m", _TeamsChatMemberRemoveCommand_initValidators).call(this);
+        __classPrivateFieldGet(this, _TeamsChatMemberRemoveCommand_instances, "m", _TeamsChatMemberRemoveCommand_initOptionSets).call(this);
+    }
+    commandAction(logger, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const removeUserFromChat = () => __awaiter(this, void 0, void 0, function* () {
+                try {
+                    if (this.verbose) {
+                        logger.logToStderr(`Removing member ${args.options.id || args.options.userId || args.options.userName} from chat with id ${args.options.chatId}...`);
+                    }
+                    const memberId = yield this.getMemberId(args);
+                    const chatMemberRemoveOptions = {
+                        url: `${this.resource}/v1.0/chats/${args.options.chatId}/members/${memberId}`,
+                        headers: {
+                            accept: 'application/json;odata.metadata=none'
+                        }
+                    };
+                    yield request_1.default.delete(chatMemberRemoveOptions);
+                }
+                catch (err) {
+                    this.handleRejectedODataJsonPromise(err);
+                }
+            });
+            if (args.options.confirm) {
+                yield removeUserFromChat();
+            }
+            else {
+                const result = yield Cli_1.Cli.prompt({
+                    type: 'confirm',
+                    name: 'continue',
+                    default: false,
+                    message: `Are you sure you want to remove member ${args.options.id || args.options.userId || args.options.userName} from chat with id ${args.options.chatId}?`
+                });
+                if (result.continue) {
+                    yield removeUserFromChat();
+                }
+            }
+        });
+    }
+    getMemberId(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (args.options.id) {
+                return args.options.id;
+            }
+            const memberRequestUrl = `${this.resource}/v1.0/chats/${args.options.chatId}/members`;
+            const members = yield odata_1.odata.getAllItems(memberRequestUrl);
+            if (args.options.userName) {
+                const matchingMember = members.find((memb) => memb.email.toLowerCase() === args.options.userName.toLowerCase());
+                if (!matchingMember) {
+                    throw `Member with userName '${args.options.userName}' could not be found in the chat.`;
+                }
+                return matchingMember.id;
+            }
+            else {
+                const matchingMember = members.find((memb) => memb.userId.toLowerCase() === args.options.userId.toLowerCase());
+                if (!matchingMember) {
+                    throw `Member with userId '${args.options.userId}' could not be found in the chat.`;
+                }
+                return matchingMember.id;
+            }
+        });
+    }
+}
+_TeamsChatMemberRemoveCommand_instances = new WeakSet(), _TeamsChatMemberRemoveCommand_initTelemetry = function _TeamsChatMemberRemoveCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            id: typeof args.options.id !== 'undefined',
+            userId: typeof args.options.userId !== 'undefined',
+            userName: typeof args.options.userName !== 'undefined',
+            confirm: !!args.options.confirm
+        });
+    });
+}, _TeamsChatMemberRemoveCommand_initOptions = function _TeamsChatMemberRemoveCommand_initOptions() {
+    this.options.unshift({
+        option: '-i, --chatId <chatId>'
+    }, {
+        option: '--id [id]'
+    }, {
+        option: '--userId [userId]'
+    }, {
+        option: '--userName [userName]'
+    }, {
+        option: '--confirm'
+    });
+}, _TeamsChatMemberRemoveCommand_initValidators = function _TeamsChatMemberRemoveCommand_initValidators() {
+    this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
+        if (!validation_1.validation.isValidTeamsChatId(args.options.chatId)) {
+            return `${args.options.chatId} is not a valid Teams chatId.`;
+        }
+        if (args.options.userId && !validation_1.validation.isValidGuid(args.options.userId)) {
+            return `${args.options.userId} is not a valid userId.`;
+        }
+        if (args.options.userName && !validation_1.validation.isValidUserPrincipalName(args.options.userName)) {
+            return `${args.options.userName} is not a valid user principal name.`;
+        }
+        return true;
+    }));
+}, _TeamsChatMemberRemoveCommand_initOptionSets = function _TeamsChatMemberRemoveCommand_initOptionSets() {
+    this.optionSets.push({ options: ['id', 'userId', 'userName'] });
+};
+module.exports = new TeamsChatMemberRemoveCommand();
+//# sourceMappingURL=chat-member-remove.js.map

package/dist/m365/teams/commands/meeting/meeting-transcript-list.js

@@ -0,0 +1,124 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _TeamsMeetingTranscriptListCommand_instances, _TeamsMeetingTranscriptListCommand_initTelemetry, _TeamsMeetingTranscriptListCommand_initOptions, _TeamsMeetingTranscriptListCommand_initValidators, _TeamsMeetingTranscriptListCommand_initOptionSets;
+Object.defineProperty(exports, "__esModule", { value: true });
+const Auth_1 = require("../../../../Auth");
+const GraphCommand_1 = require("../../../base/GraphCommand");
+const commands_1 = require("../../commands");
+const odata_1 = require("../../../../utils/odata");
+const validation_1 = require("../../../../utils/validation");
+const accessToken_1 = require("../../../../utils/accessToken");
+const aadUser_1 = require("../../../../utils/aadUser");
+class TeamsMeetingTranscriptListCommand extends GraphCommand_1.default {
+    get name() {
+        return commands_1.default.MEETING_TRANSCRIPT_LIST;
+    }
+    get description() {
+        return 'Lists all transcripts for a given meeting';
+    }
+    defaultProperties() {
+        return ['id', 'createdDateTime'];
+    }
+    constructor() {
+        super();
+        _TeamsMeetingTranscriptListCommand_instances.add(this);
+        __classPrivateFieldGet(this, _TeamsMeetingTranscriptListCommand_instances, "m", _TeamsMeetingTranscriptListCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _TeamsMeetingTranscriptListCommand_instances, "m", _TeamsMeetingTranscriptListCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _TeamsMeetingTranscriptListCommand_instances, "m", _TeamsMeetingTranscriptListCommand_initValidators).call(this);
+        __classPrivateFieldGet(this, _TeamsMeetingTranscriptListCommand_instances, "m", _TeamsMeetingTranscriptListCommand_initOptionSets).call(this);
+    }
+    commandAction(logger, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const isAppOnlyAccessToken = accessToken_1.accessToken.isAppOnlyAccessToken(Auth_1.default.service.accessTokens[this.resource].accessToken);
+                if (this.verbose) {
+                    logger.logToStderr(`Retrieving transcript list for the given meeting...`);
+                }
+                let requestUrl = `${this.resource}/beta/`;
+                if (isAppOnlyAccessToken) {
+                    if (!args.options.userId && !args.options.userName && !args.options.email) {
+                        throw `The option 'userId', 'userName' or 'email' is required when retrieving meeting transcripts list using app only permissions`;
+                    }
+                    requestUrl += 'users/';
+                    if (args.options.userId) {
+                        requestUrl += args.options.userId;
+                    }
+                    else if (args.options.userName) {
+                        requestUrl += args.options.userName;
+                    }
+                    else if (args.options.email) {
+                        if (this.verbose) {
+                            logger.logToStderr(`Getting user ID for user with email '${args.options.email}'.`);
+                        }
+                        const userId = yield aadUser_1.aadUser.getUserIdByEmail(args.options.email);
+                        requestUrl += userId;
+                    }
+                }
+                else {
+                    if (args.options.userId || args.options.userName || args.options.email) {
+                        throw `The options 'userId', 'userName' and 'email' cannot be used while retrieving meeting transcripts using delegated permissions`;
+                    }
+                    requestUrl += `me`;
+                }
+                requestUrl += `/onlineMeetings/${args.options.meetingId}/transcripts`;
+                const res = yield odata_1.odata.getAllItems(requestUrl);
+                logger.log(res);
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        });
+    }
+}
+_TeamsMeetingTranscriptListCommand_instances = new WeakSet(), _TeamsMeetingTranscriptListCommand_initTelemetry = function _TeamsMeetingTranscriptListCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            userId: typeof args.options.userId !== 'undefined',
+            userName: typeof args.options.userName !== 'undefined',
+            email: typeof args.options.email !== 'undefined'
+        });
+    });
+}, _TeamsMeetingTranscriptListCommand_initOptions = function _TeamsMeetingTranscriptListCommand_initOptions() {
+    this.options.unshift({
+        option: '-u, --userId [userId]'
+    }, {
+        option: '-n, --userName [userName]'
+    }, {
+        option: '--email [email]'
+    }, {
+        option: '-m, --meetingId <meetingId>'
+    });
+}, _TeamsMeetingTranscriptListCommand_initValidators = function _TeamsMeetingTranscriptListCommand_initValidators() {
+    this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
+        if (args.options.userId && !validation_1.validation.isValidGuid(args.options.userId)) {
+            return `${args.options.userId} is not a valid Guid`;
+        }
+        if (args.options.userName && !validation_1.validation.isValidUserPrincipalName(args.options.userName)) {
+            return `${args.options.userName} is not a valid user principal name (UPN)`;
+        }
+        if (args.options.email && !validation_1.validation.isValidUserPrincipalName(args.options.email)) {
+            return `${args.options.email} is not a valid email`;
+        }
+        return true;
+    }));
+}, _TeamsMeetingTranscriptListCommand_initOptionSets = function _TeamsMeetingTranscriptListCommand_initOptionSets() {
+    this.optionSets.push({
+        options: ['userId', 'userName', 'email'],
+        runsWhen: (args) => args.options.userId || args.options.userName || args.options.email
+    });
+};
+module.exports = new TeamsMeetingTranscriptListCommand();
+//# sourceMappingURL=meeting-transcript-list.js.map

package/dist/m365/teams/commands.js

@@ -21,6 +21,7 @@ exports.default = {
     CHAT_GET: `${prefix} chat get`,
     CHAT_LIST: `${prefix} chat list`,
     CHAT_MEMBER_LIST: `${prefix} chat member list`,
+    CHAT_MEMBER_REMOVE: `${prefix} chat member remove`,
     CHAT_MESSAGE_LIST: `${prefix} chat message list`,
     CHAT_MESSAGE_SEND: `${prefix} chat message send`,
     FUNSETTINGS_LIST: `${prefix} funsettings list`,
@@ -30,6 +31,7 @@ exports.default = {
     MEETING_ATTENDANCEREPORT_LIST: `${prefix} meeting attendancereport list`,
     MEETING_GET: `${prefix} meeting get`,
     MEETING_LIST: `${prefix} meeting list`,
+    MEETING_TRANSCRIPT_LIST: `${prefix} meeting transcript list`,
     MEMBERSETTINGS_LIST: `${prefix} membersettings list`,
     MEMBERSETTINGS_SET: `${prefix} membersettings set`,
     MESSAGE_GET: `${prefix} message get`,

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/dist/utils/spo.js

@@ -453,7 +453,7 @@ exports.spo = {
      * Retrieves the SiteId, VroomItemId and VroomDriveId from a specific file.
      * @param webUrl Web url
      * @param fileId GUID ID of the file
-     * @param fileUrl Decoded URL of the file
+     * @param fileUrl Decoded site-relative or server-relative URL of the file
      */
     getVroomFileDetails(webUrl, fileId, fileUrl) {
         return __awaiter(this, void 0, void 0, function* () {

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/
+    ```