@pnp/cli-microsoft365 5.0.0-beta.d025005 → 5.0.0-beta.d107c7a

package/dist/m365/planner/commands/task/task-list.js

@@ -25,25 +25,40 @@ class PlannerTaskListCommand extends GraphItemsListCommand_1.GraphItemsListComma
         return ['id', 'title', 'startDateTime', 'dueDateTime', 'completedDateTime'];
     }
     commandAction(logger, args, cb) {
-        const bucketId = args.options.bucketId;
         const bucketName = args.options.bucketName;
-        const planId = args.options.planId;
+        let bucketId = args.options.bucketId;
         const planName = args.options.planName;
+        let planId = args.options.planId;
+        let taskItems = [];
         if (bucketId || bucketName) {
             this
                 .getBucketId(args)
-                .then((bucketId) => this.getAllItems(`${this.resource}/v1.0/planner/buckets/${bucketId}/tasks`, logger, true))
+                .then((retrievedBucketId) => {
+                bucketId = retrievedBucketId;
+                return this.getAllItems(`${this.resource}/v1.0/planner/buckets/${bucketId}/tasks`, logger, true);
+            })
                 .then(() => {
-                logger.log(this.items);
+                taskItems = this.items;
+                return this.getAllItems(`${this.resource}/beta/planner/buckets/${bucketId}/tasks`, logger, true);
+            })
+                .then(() => {
+                logger.log(this.mergeTaskPriority(taskItems, this.items));
                 cb();
             }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
         }
         else if (planId || planName) {
             this
                 .getPlanId(args)
-                .then((planId) => this.getAllItems(`${this.resource}/v1.0/planner/plans/${planId}/tasks`, logger, true))
+                .then((retrievedPlanId) => {
+                planId = retrievedPlanId;
+                return this.getAllItems(`${this.resource}/v1.0/planner/plans/${planId}/tasks`, logger, true);
+            })
+                .then(() => {
+                taskItems = this.items;
+                return this.getAllItems(`${this.resource}/beta/planner/plans/${planId}/tasks`, logger, true);
+            })
                 .then(() => {
-                logger.log(this.items);
+                logger.log(this.mergeTaskPriority(taskItems, this.items));
                 cb();
             }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
         }
@@ -51,7 +66,11 @@ class PlannerTaskListCommand extends GraphItemsListCommand_1.GraphItemsListComma
             this
                 .getAllItems(`${this.resource}/v1.0/me/planner/tasks`, logger, true)
                 .then(() => {
-                logger.log(this.items);
+                taskItems = this.items;
+                return this.getAllItems(`${this.resource}/beta/me/planner/tasks`, logger, true);
+            })
+                .then(() => {
+                logger.log(this.mergeTaskPriority(taskItems, this.items));
                 cb();
             }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
         }
@@ -125,6 +144,17 @@ class PlannerTaskListCommand extends GraphItemsListCommand_1.GraphItemsListComma
             return Promise.resolve(group.id);
         });
     }
+    mergeTaskPriority(taskItems, betaTaskItems) {
+        const findBetaTask = (id) => betaTaskItems.find(task => task.id === id);
+        taskItems.forEach(task => {
+            const betaTaskItem = findBetaTask(task.id);
+            if (betaTaskItem) {
+                const { priority } = betaTaskItem;
+                Object.assign(task, { priority });
+            }
+        });
+        return taskItems;
+    }
     options() {
         const options = [
             {

package/dist/m365/spo/commands/group/group-user-add.js

@@ -22,7 +22,7 @@ class SpoGroupUserAddCommand extends SpoCommand_1.default {
             .getGroupId(args)
             .then((_groupId) => {
             groupId = _groupId;
-            return this.getOnlyActiveUsers(args, logger);
+            return this.getValidUsers(args, logger);
         })
             .then((resolvedUsernameList) => {
             if (this.verbose) {
@@ -73,13 +73,15 @@ class SpoGroupUserAddCommand extends SpoCommand_1.default {
             return groupId;
         });
     }
-    getOnlyActiveUsers(args, logger) {
+    getValidUsers(args, logger) {
         if (this.verbose) {
-            logger.logToStderr(`Removing Users which are not active from the original list`);
+            logger.logToStderr(`Checking if the specified users exist`);
         }
-        const activeUserNameList = [];
+        const validUserNames = [];
+        const invalidUserNames = [];
         const userInfo = args.options.userName ? args.options.userName : args.options.email;
-        return Promise.all(userInfo.split(',').map(singleUserName => {
+        return Promise
+            .all(userInfo.split(',').map(singleUserName => {
             const options = {
                 output: 'json',
                 debug: args.options.debug,
@@ -91,20 +93,25 @@ class SpoGroupUserAddCommand extends SpoCommand_1.default {
             else {
                 options.email = singleUserName.trim();
             }
-            return cli_1.Cli.executeCommandWithOutput(AadUserGetCommand, { options: Object.assign(Object.assign({}, options), { _: [] }) })
+            return cli_1.Cli
+                .executeCommandWithOutput(AadUserGetCommand, { options: Object.assign(Object.assign({}, options), { _: [] }) })
                 .then((getUserGetOutput) => {
                 if (this.debug) {
                     logger.logToStderr(getUserGetOutput.stderr);
                 }
-                activeUserNameList.push(JSON.parse(getUserGetOutput.stdout).userPrincipalName);
+                validUserNames.push(JSON.parse(getUserGetOutput.stdout).userPrincipalName);
             }, (err) => {
                 if (this.debug) {
                     logger.logToStderr(err.stderr);
                 }
+                invalidUserNames.push(singleUserName);
             });
         }))
             .then(() => {
-            return Promise.resolve(activeUserNameList);
+            if (invalidUserNames.length > 0) {
+                return Promise.reject(`Users not added to the group because the following users don't exist: ${invalidUserNames.join(', ')}`);
+            }
+            return Promise.resolve(validUserNames);
         });
     }
     getFormattedUserList(activeUserList) {

package/dist/m365/teams/commands/app/app-install.js

@@ -1,7 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const cli_1 = require("../../../../cli");
 const request_1 = require("../../../../request");
 const Utils_1 = require("../../../../Utils");
+const AadUserGetCommand = require("../../../aad/commands/user/user-get");
 const GraphCommand_1 = require("../../../base/GraphCommand");
 const commands_1 = require("../../commands");
 class TeamsAppInstallCommand extends GraphCommand_1.default {
@@ -9,33 +11,70 @@ class TeamsAppInstallCommand extends GraphCommand_1.default {
         return commands_1.default.APP_INSTALL;
     }
     get description() {
-        return 'Installs an app from the catalog to a Microsoft Teams team';
+        return 'Installs a Microsoft Teams team app from the catalog in the specified team or for the specified user';
     }
     commandAction(logger, args, cb) {
-        const endpoint = `${this.resource}/v1.0`;
-        const requestOptions = {
-            url: `${endpoint}/teams/${args.options.teamId}/installedApps`,
-            headers: {
-                'content-type': 'application/json;odata=nometadata',
-                'accept': 'application/json;odata.metadata=none'
-            },
-            responseType: 'json',
-            data: {
-                'teamsApp@odata.bind': `${endpoint}/appCatalogs/teamsApps/${args.options.appId}`
+        this
+            .validateUser(args, logger)
+            .then(_ => {
+            var _a;
+            let url = `${this.resource}/v1.0`;
+            if (args.options.teamId) {
+                url += `/teams/${encodeURIComponent(args.options.teamId)}/installedApps`;
             }
-        };
-        request_1.default
-            .post(requestOptions)
+            else {
+                url += `/users/${encodeURIComponent(((_a = args.options.userId) !== null && _a !== void 0 ? _a : args.options.userName))}/teamwork/installedApps`;
+            }
+            const requestOptions = {
+                url: url,
+                headers: {
+                    'content-type': 'application/json;odata=nometadata',
+                    'accept': 'application/json;odata.metadata=none'
+                },
+                responseType: 'json',
+                data: {
+                    'teamsApp@odata.bind': `${this.resource}/v1.0/appCatalogs/teamsApps/${args.options.appId}`
+                }
+            };
+            return request_1.default.post(requestOptions);
+        })
             .then(_ => cb(), (res) => this.handleRejectedODataJsonPromise(res, logger, cb));
     }
+    // we need this method, because passing an invalid user ID to the API
+    // won't cause an error
+    validateUser(args, logger) {
+        if (!args.options.userId) {
+            return Promise.resolve(true);
+        }
+        if (this.verbose) {
+            logger.logToStderr(`Checking if user ${args.options.userId} exists...`);
+        }
+        const options = {
+            id: args.options.userId,
+            output: 'json',
+            debug: args.options.debug,
+            verbose: args.options.verbose
+        };
+        return cli_1.Cli
+            .executeCommandWithOutput(AadUserGetCommand, { options: Object.assign(Object.assign({}, options), { _: [] }) })
+            .then((res) => {
+            if (this.verbose) {
+                logger.logToStderr(res.stderr);
+            }
+            return true;
+        }, (err) => {
+            if (this.verbose) {
+                logger.logToStderr(err.stderr);
+            }
+            return Promise.reject(`User with ID ${args.options.userId} not found. Original error: ${err.error.message}`);
+        });
+    }
     options() {
         const options = [
-            {
-                option: '--appId <appId>'
-            },
-            {
-                option: '--teamId <teamId>'
-            }
+            { option: '--appId <appId>' },
+            { option: '--teamId [teamId' },
+            { option: '--userId [userId]' },
+            { option: '--userName [userName]' }
         ];
         const parentOptions = super.options();
         return options.concat(parentOptions);
@@ -44,9 +83,24 @@ class TeamsAppInstallCommand extends GraphCommand_1.default {
         if (!Utils_1.default.isValidGuid(args.options.appId)) {
             return `${args.options.appId} is not a valid GUID`;
         }
-        if (!Utils_1.default.isValidGuid(args.options.teamId)) {
+        if (!args.options.teamId &&
+            !args.options.userId &&
+            !args.options.userName) {
+            return `Specify either teamId, userId or userName`;
+        }
+        if ((args.options.teamId && args.options.userId) ||
+            (args.options.teamId && args.options.userName) ||
+            (args.options.userId && args.options.userName)) {
+            return `Specify either teamId, userId or userName but not multiple`;
+        }
+        if (args.options.teamId &&
+            !Utils_1.default.isValidGuid(args.options.teamId)) {
             return `${args.options.teamId} is not a valid GUID`;
         }
+        if (args.options.userId &&
+            !Utils_1.default.isValidGuid(args.options.userId)) {
+            return `${args.options.userId} is not a valid GUID`;
+        }
         return true;
     }
 }

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

@@ -21,6 +21,7 @@ class TeamsChannelGetCommand extends GraphCommand_1.default {
         telemetryProps.teamName = typeof args.options.teamName !== 'undefined';
         telemetryProps.channelId = typeof args.options.channelId !== 'undefined';
         telemetryProps.channelName = typeof args.options.channelName !== 'undefined';
+        telemetryProps.primary = (!(!args.options.primary)).toString();
         return telemetryProps;
     }
     getTeamId(args) {
@@ -54,6 +55,9 @@ class TeamsChannelGetCommand extends GraphCommand_1.default {
         if (args.options.channelId) {
             return Promise.resolve(args.options.channelId);
         }
+        if (args.options.primary) {
+            return Promise.resolve('');
+        }
         const channelRequestOptions = {
             url: `${this.resource}/v1.0/teams/${encodeURIComponent(this.teamId)}/channels?$filter=displayName eq '${encodeURIComponent(args.options.channelName)}'`,
             headers: {
@@ -79,15 +83,21 @@ class TeamsChannelGetCommand extends GraphCommand_1.default {
             return this.getChannelId(args);
         })
             .then((channelId) => {
+            let url = '';
+            if (args.options.primary) {
+                url = `${this.resource}/v1.0/teams/${encodeURIComponent(this.teamId)}/primaryChannel`;
+            }
+            else {
+                url = `${this.resource}/v1.0/teams/${encodeURIComponent(this.teamId)}/channels/${encodeURIComponent(channelId)}`;
+            }
             const requestOptions = {
-                url: `${this.resource}/v1.0/teams/${encodeURIComponent(this.teamId)}/channels/${encodeURIComponent(channelId)}`,
+                url: url,
                 headers: {
                     accept: 'application/json;odata.metadata=none'
                 },
                 responseType: 'json'
             };
-            return request_1.default
-                .get(requestOptions);
+            return request_1.default.get(requestOptions);
         })
             .then((res) => {
             logger.log(res);
@@ -107,6 +117,9 @@ class TeamsChannelGetCommand extends GraphCommand_1.default {
             },
             {
                 option: '--channelName [channelName]'
+            },
+            {
+                option: '--primary'
             }
         ];
         const parentOptions = super.options();
@@ -122,11 +135,20 @@ class TeamsChannelGetCommand extends GraphCommand_1.default {
         if (args.options.teamId && !Utils_1.default.isValidGuid(args.options.teamId)) {
             return `${args.options.teamId} is not a valid GUID`;
         }
-        if (args.options.channelId && args.options.channelName) {
-            return 'Specify either channelId or channelName, but not both.';
+        if (args.options.channelId && args.options.channelName && args.options.primary) {
+            return 'Specify channelId, channelName or primary';
+        }
+        if (!args.options.channelId && args.options.channelName && args.options.primary) {
+            return 'Specify channelId, channelName or primary.';
+        }
+        if (args.options.channelId && !args.options.channelName && args.options.primary) {
+            return 'Specify channelId, channelName or primary.';
+        }
+        if (args.options.channelId && args.options.channelName && !args.options.primary) {
+            return 'Specify channelId, channelName or primary.';
         }
-        if (!args.options.channelId && !args.options.channelName) {
-            return 'Specify channelId or channelName, one is required';
+        if (!args.options.channelId && !args.options.channelName && !args.options.primary) {
+            return 'Specify channelId, channelName or primary, one is required';
         }
         if (args.options.channelId && !Utils_1.default.isValidTeamsChannelId(args.options.channelId)) {
             return `${args.options.channelId} is not a valid Teams ChannelId`;

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

@@ -0,0 +1,225 @@
+"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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const os = require("os");
+const Auth_1 = require("../../../../Auth");
+const request_1 = require("../../../../request");
+const Utils_1 = require("../../../../Utils");
+const GraphCommand_1 = require("../../../base/GraphCommand");
+const commands_1 = require("../../commands");
+class TeamsChatMessageSendCommand extends GraphCommand_1.default {
+    get name() {
+        return commands_1.default.CHAT_MESSAGE_SEND;
+    }
+    get description() {
+        return 'Send a message to an existing or new chat conversation.';
+    }
+    commandAction(logger, args, cb) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const chatId = args.options.chatId
+                    || args.options.userEmails && (yield this.ensureChatIdByUserEmails(args.options.userEmails))
+                    || args.options.chatName && (yield this.getChatIdByName(args.options.chatName));
+                yield this.sendChatMessage(chatId, args.options);
+                cb();
+            }
+            catch (error) {
+                this.handleRejectedODataJsonPromise(error, logger, cb);
+            }
+        });
+    }
+    options() {
+        const options = [
+            {
+                option: '--chatId [chatId]'
+            },
+            {
+                option: '-e, --userEmails [userEmails]'
+            },
+            {
+                option: '--chatName [chatName]'
+            },
+            {
+                option: '-m, --message <message>'
+            }
+        ];
+        const parentOptions = super.options();
+        return options.concat(parentOptions);
+    }
+    validate(args) {
+        if (!args.options.chatId && !args.options.userEmails && !args.options.chatName) {
+            return 'Specify chatId or userEmails or chatName, one is required.';
+        }
+        let nrOfMutuallyExclusiveOptionsInUse = 0;
+        if (args.options.chatId) {
+            nrOfMutuallyExclusiveOptionsInUse++;
+        }
+        if (args.options.userEmails) {
+            nrOfMutuallyExclusiveOptionsInUse++;
+        }
+        if (args.options.chatName) {
+            nrOfMutuallyExclusiveOptionsInUse++;
+        }
+        if (nrOfMutuallyExclusiveOptionsInUse > 1) {
+            return 'Specify either chatId or userEmails or chatName, but not multiple.';
+        }
+        if (!args.options.message) {
+            return 'Specify a message to send.';
+        }
+        if (args.options.chatId && !Utils_1.default.isValidTeamsChatId(args.options.chatId)) {
+            return `${args.options.chatId} is not a valid Teams ChatId.`;
+        }
+        if (args.options.userEmails) {
+            const userEmails = args.options.userEmails.toLowerCase().replace(/\s/g, '').split(',').filter(e => e && e !== '');
+            if (!userEmails || userEmails.length === 0 || userEmails.some(e => !Utils_1.default.isValidUserPrincipalName(e))) {
+                return `${args.options.userEmails} contains one or more invalid email addresses.`;
+            }
+        }
+        return true;
+    }
+    ensureChatIdByUserEmails(userEmailsOption) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const userEmails = userEmailsOption.toLowerCase().replace(/\s/g, '').split(',').filter(e => e && e !== '');
+            const currentUserEmail = Utils_1.default.getUserNameFromAccessToken(Auth_1.default.service.accessTokens[this.resource].accessToken).toLowerCase();
+            const existingChats = yield this.findExistingGroupChatsByMembers([currentUserEmail, ...userEmails]);
+            if (existingChats && existingChats.length > 0) {
+                if (existingChats.length > 1) {
+                    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 topic found. Please disambiguate:${os.EOL}${disambiguationText}`);
+                }
+                else {
+                    return existingChats[0].id;
+                }
+            }
+            const chat = yield this.createConversation([currentUserEmail, ...userEmails]);
+            return chat.id;
+        });
+    }
+    getChatIdByName(chatName) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const existingChats = yield this.findExistingGroupChatsByTopic(chatName);
+            if (!existingChats || existingChats.length === 0) {
+                throw new Error('No chat conversation was found with this name.');
+            }
+            if (existingChats.length === 1) {
+                return existingChats[0].id;
+            }
+            const disambiguationText = existingChats.map(c => {
+                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 topic found. Please disambiguate:${os.EOL}${disambiguationText}`);
+        });
+    }
+    // This Microsoft Graph API request throws an intermittent 404 exception, saying that it cannot find the principal.
+    // The same behavior occurs when creating the conversation through the Graph Explorer.
+    // It seems to happen when the userEmail casing does not match the casing of the actual UPN. 
+    // When the first request throws an error, the second request does succeed. 
+    // Therefore a retry-mechanism is implemented here. 
+    createConversation(memberEmails, retried = 0) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const jsonBody = {
+                    chatType: memberEmails.length > 2 ? 'group' : 'oneOnOne',
+                    members: memberEmails.map(email => {
+                        return {
+                            '@odata.type': '#microsoft.graph.aadUserConversationMember',
+                            roles: ['owner'],
+                            'user@odata.bind': `https://graph.microsoft.com/v1.0/users/${email}`
+                        };
+                    })
+                };
+                const requestOptions = {
+                    url: `${this.resource}/v1.0/chats`,
+                    headers: {
+                        accept: 'application/json;odata.metadata=none',
+                        'content-type': 'application/json;odata=nometadata'
+                    },
+                    responseType: 'json',
+                    data: jsonBody
+                };
+                return yield request_1.default.post(requestOptions);
+            }
+            catch (err) {
+                if (((_a = err.message) === null || _a === void 0 ? void 0 : _a.indexOf('404')) > -1 && retried < 4) {
+                    return yield this.createConversation(memberEmails, retried + 1);
+                }
+                throw err;
+            }
+        });
+    }
+    sendChatMessage(chatId, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = {
+                url: `${this.resource}/v1.0/chats/${chatId}/messages`,
+                headers: {
+                    accept: 'application/json;odata.metadata=none',
+                    'content-type': 'application/json;odata=nometadata'
+                },
+                responseType: 'json',
+                data: {
+                    body: {
+                        content: options.message
+                    }
+                }
+            };
+            yield request_1.default.post(requestOptions);
+        });
+    }
+    findExistingGroupChatsByMembers(expectedMemberEmails) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const endpoint = `${this.resource}/v1.0/chats?$filter=chatType eq 'group'&$expand=members&$select=id,topic,createdDateTime,members`;
+            const foundChats = [];
+            const chats = yield this.getAllChats(endpoint, []);
+            for (const chat of chats) {
+                const chatMembers = chat.members;
+                if (chatMembers.length === expectedMemberEmails.length) {
+                    const chatMemberEmails = chatMembers.map(member => { var _a; return (_a = member.email) === null || _a === void 0 ? void 0 : _a.toLowerCase(); });
+                    if (expectedMemberEmails.every(email => chatMemberEmails.some(memberEmail => memberEmail === email))) {
+                        foundChats.push(chat);
+                    }
+                }
+            }
+            return foundChats;
+        });
+    }
+    findExistingGroupChatsByTopic(topic) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const endpoint = `${this.resource}/v1.0/chats?$filter=topic eq '${encodeURIComponent(topic)}'&$expand=members&$select=id,topic,createdDateTime,chatType`;
+            const chats = yield this.getAllChats(endpoint, []);
+            return chats;
+        });
+    }
+    getAllChats(url, items) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = {
+                url: url,
+                headers: {
+                    accept: 'application/json;odata.metadata=none'
+                },
+                responseType: 'json'
+            };
+            const res = yield request_1.default.get(requestOptions);
+            items = items.concat(res.value);
+            if (res['@odata.nextLink']) {
+                return yield this.getAllChats(res['@odata.nextLink'], items);
+            }
+            else {
+                return items;
+            }
+        });
+    }
+}
+module.exports = new TeamsChatMessageSendCommand();
+//# sourceMappingURL=chat-message-send.js.map

package/dist/m365/teams/commands.js

@@ -16,6 +16,7 @@ exports.default = {
     CHAT_LIST: `${prefix} chat list`,
     CHAT_MEMBER_LIST: `${prefix} chat member list`,
     CHAT_MESSAGE_LIST: `${prefix} chat message list`,
+    CHAT_MESSAGE_SEND: `${prefix} chat message send`,
     CONVERSATIONMEMBER_ADD: `${prefix} conversationmember add`,
     CONVERSATIONMEMBER_LIST: `${prefix} conversationmember list`,
     FUNSETTINGS_LIST: `${prefix} funsettings list`,

package/docs/docs/cmd/aad/app/app-delete.md

@@ -0,0 +1,51 @@
+# aad app delete
+
+Removes an Azure AD app registration
+
+## Usage
+
+```sh
+m365 aad app delete [options]
+```
+
+## Options
+
+`--appId [appId]`
+: Application (client) ID of the Azure AD application registration to remove. Specify either `appId`, `objectId` or `name`
+
+`--objectId [objectId]`
+: Object ID of the Azure AD application registration to remove. Specify either `appId`, `objectId` or `name`
+
+`--name [name]`
+: Name of the Azure AD application registration to remove. Specify either `appId`, `objectId` or `name`
+
+`--confirm`:
+: Don't prompt for confirmation to delete the app
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+For best performance use the `objectId` option to reference the Azure AD application registration to delete. If you use `appId` or `name`, this command will first need to find the corresponding object ID for that application.
+
+If the command finds multiple Azure AD application registrations with the specified app name, it will prompt you to disambiguate which app it should use, listing the discovered object IDs.
+
+## Examples
+
+Delete the Azure AD application registration by its app (client) ID
+
+```sh
+m365 aad app delete --appId d75be2e1-0204-4f95-857d-51a37cf40be8
+```
+
+Delete the Azure AD application registration by its object ID
+
+```sh
+m365 aad app delete --objectId d75be2e1-0204-4f95-857d-51a37cf40be8
+```
+
+Delete the Azure AD application registration by its name. Will NOT prompt for confirmation before deleting.
+
+```sh
+m365 aad app delete --name "My app" --confirm
+```

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

@@ -19,14 +19,19 @@ m365 aad app get [options]
 `--name [name]`
 : Name of the Azure AD application registration to get. Specify either `appId`, `objectId` or `name`
 
+`--save`
+: Use to store the information about the created app in a local file
+
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
 
-For best performance use the `objectId` option to reference the Azure AD application registration to update. If you use `appId` or `name`, this command will first need to find the corresponding object ID for that application.
+For best performance use the `objectId` option to reference the Azure AD application registration to get. If you use `appId` or `name`, this command will first need to find the corresponding object ID for that application.
 
 If the command finds multiple Azure AD application registrations with the specified app name, it will prompt you to disambiguate which app it should use, listing the discovered object IDs.
 
+If you want to store the information about the Azure AD app registration, use the `--save` option. This is useful when you build solutions connected to Microsoft 365 and want to easily manage app registrations used with your solution. When you use the `--save` option, after you get the app registration, the command will write its ID and name to the `.m365rc.json` file in the current directory. If the file already exists, it will add the information about the App registration to it if it's not already present, allowing you to track multiple apps. If the file doesn't exist, the command will create it.
+
 ## Examples
 
 Get the Azure AD application registration by its app (client) ID
@@ -46,3 +51,9 @@ Get the Azure AD application registration by its name
 ```sh
 m365 aad app get --name "My app"
 ```
+
+Get the Azure AD application registration by its name. Store information about the retrieved app registration in the _.m365rc.json_ file in the current directory.
+
+```sh
+m365 aad app get --name "My app" --save
+```