@pnp/cli-microsoft365 10.4.0-beta.791a39c → 10.4.0-beta.946980f

package/dist/cli/cli.js

@@ -159,9 +159,17 @@ async function execute(rawArgs) {
                     shouldPrompt) {
                     await cli.error('🌶️  Provide values for the following parameters:');
                     for (const error of result.error.errors) {
-                        const optionInfo = cli.commandToExecute.options.find(o => o.name === error.path.join('.'));
+                        const optionName = error.path.join('.');
+                        const optionInfo = cli.commandToExecute.options.find(o => o.name === optionName);
                         const answer = await cli.promptForValue(optionInfo);
-                        cli.optionsFromArgs.options[error.path.join('.')] = answer;
+                        // coerce the answer to the correct type
+                        try {
+                            const parsed = getCommandOptionsFromArgs([`--${optionName}`, answer], cli.commandToExecute);
+                            cli.optionsFromArgs.options[optionName] = parsed[optionName];
+                        }
+                        catch (e) {
+                            return cli.closeWithError(e.message, cli.optionsFromArgs, true);
+                        }
                     }
                 }
                 else {

package/dist/m365/entra/commands/group/group-member-add.js

@@ -29,8 +29,11 @@ class EntraGroupMemberAddCommand extends GraphCommand {
     }
     async commandAction(logger, args) {
         try {
+            if (args.options.groupDisplayName) {
+                await this.warn(logger, `Option 'groupDisplayName' is deprecated and will be removed in the next major release.`);
+            }
             if (this.verbose) {
-                await logger.logToStderr(`Adding member(s) ${args.options.ids || args.options.userNames} to group ${args.options.groupId || args.options.groupDisplayName}...`);
+                await logger.logToStderr(`Adding member(s) ${args.options.ids || args.options.userNames} to group ${args.options.groupId || args.options.groupDisplayName || args.options.groupName}...`);
             }
             const groupId = await this.getGroupId(logger, args.options);
             const userIds = await this.getUserIds(logger, args.options);
@@ -77,9 +80,9 @@ class EntraGroupMemberAddCommand extends GraphCommand {
             return options.groupId;
         }
         if (this.verbose) {
-            await logger.logToStderr(`Retrieving ID of group ${options.groupDisplayName}...`);
+            await logger.logToStderr(`Retrieving ID of group ${options.groupDisplayName || options.groupName}...`);
         }
-        return entraGroup.getGroupIdByDisplayName(options.groupDisplayName);
+        return entraGroup.getGroupIdByDisplayName(options.groupDisplayName || options.groupName);
     }
     async getUserIds(logger, options) {
         if (options.ids) {
@@ -96,6 +99,7 @@ _EntraGroupMemberAddCommand_instances = new WeakSet(), _EntraGroupMemberAddComma
         Object.assign(this.telemetryProperties, {
             groupId: typeof args.options.groupId !== 'undefined',
             groupDisplayName: typeof args.options.groupDisplayName !== 'undefined',
+            groupName: typeof args.options.groupName !== 'undefined',
             ids: typeof args.options.ids !== 'undefined',
             userNames: typeof args.options.userNames !== 'undefined'
         });
@@ -104,7 +108,9 @@ _EntraGroupMemberAddCommand_instances = new WeakSet(), _EntraGroupMemberAddComma
     this.options.unshift({
         option: '-i, --groupId [groupId]'
     }, {
-        option: '-n, --groupDisplayName [groupDisplayName]'
+        option: '--groupDisplayName [groupDisplayName]'
+    }, {
+        option: '-n, --groupName [groupName]'
     }, {
         option: '--ids [ids]'
     }, {
@@ -136,9 +142,9 @@ _EntraGroupMemberAddCommand_instances = new WeakSet(), _EntraGroupMemberAddComma
         return true;
     });
 }, _EntraGroupMemberAddCommand_initOptionSets = function _EntraGroupMemberAddCommand_initOptionSets() {
-    this.optionSets.push({ options: ['groupId', 'groupDisplayName'] }, { options: ['ids', 'userNames'] });
+    this.optionSets.push({ options: ['groupId', 'groupDisplayName', 'groupName'] }, { options: ['ids', 'userNames'] });
 }, _EntraGroupMemberAddCommand_initTypes = function _EntraGroupMemberAddCommand_initTypes() {
-    this.types.string.push('groupId', 'groupDisplayName', 'ids', 'userNames', 'role');
+    this.types.string.push('groupId', 'groupDisplayName', 'groupName', 'ids', 'userNames', 'role');
 };
 export default new EntraGroupMemberAddCommand();
 //# sourceMappingURL=group-member-add.js.map

package/dist/m365/entra/commands/group/group-member-set.js

@@ -29,8 +29,11 @@ class EntraGroupMemberSetCommand extends GraphCommand {
     }
     async commandAction(logger, args) {
         try {
+            if (args.options.groupDisplayName) {
+                await this.warn(logger, `Option 'groupDisplayName' is deprecated and will be removed in the next major release.`);
+            }
             if (this.verbose) {
-                await logger.logToStderr(`Adding member(s) ${args.options.ids || args.options.userNames} to role ${args.options.role} of group ${args.options.groupId || args.options.groupDisplayName}...`);
+                await logger.logToStderr(`Adding member(s) ${args.options.ids || args.options.userNames} to role ${args.options.role} of group ${args.options.groupId || args.options.groupDisplayName || args.options.groupName}...`);
             }
             const groupId = await this.getGroupId(logger, args.options);
             const userIds = await this.getUserIds(logger, args.options);
@@ -49,9 +52,9 @@ class EntraGroupMemberSetCommand extends GraphCommand {
             return options.groupId;
         }
         if (this.verbose) {
-            await logger.logToStderr(`Retrieving ID of group ${options.groupDisplayName}...`);
+            await logger.logToStderr(`Retrieving ID of group ${options.groupDisplayName || options.groupName}...`);
         }
-        return entraGroup.getGroupIdByDisplayName(options.groupDisplayName);
+        return entraGroup.getGroupIdByDisplayName(options.groupDisplayName || options.groupName);
     }
     async getUserIds(logger, options) {
         if (options.ids) {
@@ -158,6 +161,7 @@ _EntraGroupMemberSetCommand_instances = new WeakSet(), _EntraGroupMemberSetComma
         Object.assign(this.telemetryProperties, {
             groupId: typeof args.options.groupId !== 'undefined',
             groupDisplayName: typeof args.options.groupDisplayName !== 'undefined',
+            groupName: typeof args.options.groupName !== 'undefined',
             ids: typeof args.options.ids !== 'undefined',
             userNames: typeof args.options.userNames !== 'undefined'
         });
@@ -166,7 +170,9 @@ _EntraGroupMemberSetCommand_instances = new WeakSet(), _EntraGroupMemberSetComma
     this.options.unshift({
         option: '-i, --groupId [groupId]'
     }, {
-        option: '-n, --groupDisplayName [groupDisplayName]'
+        option: '--groupDisplayName [groupDisplayName]'
+    }, {
+        option: '-n, --groupName [groupName]'
     }, {
         option: '--ids [ids]'
     }, {
@@ -198,9 +204,9 @@ _EntraGroupMemberSetCommand_instances = new WeakSet(), _EntraGroupMemberSetComma
         return true;
     });
 }, _EntraGroupMemberSetCommand_initOptionSets = function _EntraGroupMemberSetCommand_initOptionSets() {
-    this.optionSets.push({ options: ['groupId', 'groupDisplayName'] }, { options: ['ids', 'userNames'] });
+    this.optionSets.push({ options: ['groupId', 'groupDisplayName', 'groupName'] }, { options: ['ids', 'userNames'] });
 }, _EntraGroupMemberSetCommand_initTypes = function _EntraGroupMemberSetCommand_initTypes() {
-    this.types.string.push('groupId', 'groupDisplayName', 'ids', 'userNames', 'role');
+    this.types.string.push('groupId', 'groupDisplayName', 'groupName', 'ids', 'userNames', 'role');
 };
 export default new EntraGroupMemberSetCommand();
 //# sourceMappingURL=group-member-set.js.map

package/dist/m365/entra/commands/user/user-session-revoke.js

@@ -0,0 +1,70 @@
+import { z } from 'zod';
+import { globalOptionsZod } from '../../../../Command.js';
+import { zod } from '../../../../utils/zod.js';
+import GraphCommand from '../../../base/GraphCommand.js';
+import commands from '../../commands.js';
+import { validation } from '../../../../utils/validation.js';
+import request from '../../../../request.js';
+import { cli } from '../../../../cli/cli.js';
+import { formatting } from '../../../../utils/formatting.js';
+const options = globalOptionsZod
+    .extend({
+    userId: zod.alias('i', z.string().refine(id => validation.isValidGuid(id), id => ({
+        message: `'${id}' is not a valid GUID.`
+    })).optional()),
+    userName: zod.alias('n', z.string().refine(name => validation.isValidUserPrincipalName(name), name => ({
+        message: `'${name}' is not a valid UPN.`
+    })).optional()),
+    force: zod.alias('f', z.boolean().optional())
+})
+    .strict();
+class EntraUserSessionRevokeCommand extends GraphCommand {
+    get name() {
+        return commands.USER_SESSION_REVOKE;
+    }
+    get description() {
+        return 'Revokes all sign-in sessions for a given user';
+    }
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(options => [options.userId, options.userName].filter(o => o !== undefined).length === 1, {
+            message: `Specify either 'userId' or 'userName'.`
+        });
+    }
+    async commandAction(logger, args) {
+        const revokeUserSessions = async () => {
+            try {
+                const userIdentifier = args.options.userId ?? args.options.userName;
+                if (this.verbose) {
+                    await logger.logToStderr(`Invalidating all the refresh tokens for user ${userIdentifier}...`);
+                }
+                const requestOptions = {
+                    url: `${this.resource}/v1.0/users('${formatting.encodeQueryParameter(userIdentifier)}')/revokeSignInSessions`,
+                    headers: {
+                        accept: 'application/json;odata.metadata=none'
+                    },
+                    responseType: 'json',
+                    data: {}
+                };
+                await request.post(requestOptions);
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        };
+        if (args.options.force) {
+            await revokeUserSessions();
+        }
+        else {
+            const result = await cli.promptForConfirmation({ message: `This will revoke all sessions for the user '${args.options.userId || args.options.userName}', requiring the user to re-sign in from all devices. Are you sure?` });
+            if (result) {
+                await revokeUserSessions();
+            }
+        }
+    }
+}
+export default new EntraUserSessionRevokeCommand();
+//# sourceMappingURL=user-session-revoke.js.map

package/dist/m365/entra/commands.js

@@ -119,6 +119,7 @@ export default {
     USER_REGISTRATIONDETAILS_LIST: `${prefix} user registrationdetails list`,
     USER_REMOVE: `${prefix} user remove`,
     USER_RECYCLEBINITEM_RESTORE: `${prefix} user recyclebinitem restore`,
+    USER_SESSION_REVOKE: `${prefix} user session revoke`,
     USER_SET: `${prefix} user set`,
     USER_SIGNIN_LIST: `${prefix} user signin list`
 };

package/dist/m365/outlook/commands/mailbox/mailbox-settings-get.js

@@ -0,0 +1,71 @@
+import { z } from 'zod';
+import { globalOptionsZod } from '../../../../Command.js';
+import { zod } from '../../../../utils/zod.js';
+import GraphCommand from '../../../base/GraphCommand.js';
+import commands from '../../commands.js';
+import { validation } from '../../../../utils/validation.js';
+import request from '../../../../request.js';
+import { accessToken } from '../../../../utils/accessToken.js';
+import auth from '../../../../Auth.js';
+const options = globalOptionsZod
+    .extend({
+    userId: zod.alias('i', z.string().refine(id => validation.isValidGuid(id), id => ({
+        message: `'${id}' is not a valid GUID.`
+    })).optional()),
+    userName: zod.alias('n', z.string().refine(name => validation.isValidUserPrincipalName(name), name => ({
+        message: `'${name}' is not a valid UPN.`
+    })).optional())
+})
+    .strict();
+class OutlookMailboxSettingsGetCommand extends GraphCommand {
+    get name() {
+        return commands.MAILBOX_SETTINGS_GET;
+    }
+    get description() {
+        return `Get the user's mailbox settings`;
+    }
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(options => !(options.userId && options.userName), {
+            message: 'Specify either userId or userName, but not both'
+        });
+    }
+    async commandAction(logger, args) {
+        const isAppOnlyAccessToken = accessToken.isAppOnlyAccessToken(auth.connection.accessTokens[auth.defaultResource].accessToken);
+        let requestUrl = `${this.resource}/v1.0/me/mailboxSettings`;
+        if (isAppOnlyAccessToken) {
+            if (!args.options.userId && !args.options.userName) {
+                throw 'When running with application permissions either userId or userName is required';
+            }
+            const userIdentifier = args.options.userId ?? args.options.userName;
+            if (this.verbose) {
+                await logger.logToStderr(`Retrieving mailbox settings for user ${userIdentifier}...`);
+            }
+            requestUrl = `${this.resource}/v1.0/users('${userIdentifier}')/mailboxSettings`;
+        }
+        else {
+            if (args.options.userId || args.options.userName) {
+                throw 'You can retrieve mailbox settings of other users only if CLI is authenticated in app-only mode';
+            }
+        }
+        const requestOptions = {
+            url: requestUrl,
+            headers: {
+                accept: 'application/json;odata.metadata=none'
+            },
+            responseType: 'json'
+        };
+        try {
+            const result = await request.get(requestOptions);
+            await logger.log(result);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+}
+export default new OutlookMailboxSettingsGetCommand();
+//# sourceMappingURL=mailbox-settings-get.js.map

package/dist/m365/outlook/commands/mailbox/mailbox-settings-set.js

@@ -46,6 +46,9 @@ class OutlookMailboxSettingsSetCommand extends GraphCommand {
     }
     getRefinedSchema(schema) {
         return schema
+            .refine(options => !(options.userId && options.userName), {
+            message: 'Specify either userId or userName, but not both'
+        })
             .refine(options => [options.workingDays, options.workingHoursStartTime, options.workingHoursEndTime, options.workingHoursTimeZone,
             options.autoReplyStatus, options.autoReplyExternalAudience, options.autoReplyExternalMessage, options.autoReplyInternalMessage,
             options.autoReplyStartDateTime, options.autoReplyStartTimeZone, options.autoReplyEndDateTime, options.autoReplyEndTimeZone,
@@ -57,8 +60,8 @@ class OutlookMailboxSettingsSetCommand extends GraphCommand {
         const isAppOnlyAccessToken = accessToken.isAppOnlyAccessToken(auth.connection.accessTokens[auth.defaultResource].accessToken);
         let requestUrl = `${this.resource}/v1.0/me/mailboxSettings`;
         if (isAppOnlyAccessToken) {
-            if (args.options.userId && args.options.userName) {
-                throw 'When running with application permissions either userId or userName is required, but not both';
+            if (!args.options.userId && !args.options.userName) {
+                throw 'When running with application permissions either userId or userName is required';
             }
             const userIdentifier = args.options.userId ?? args.options.userName;
             if (this.verbose) {

package/dist/m365/outlook/commands.js

@@ -1,6 +1,7 @@
 const prefix = 'outlook';
 export default {
     MAIL_SEND: `${prefix} mail send`,
+    MAILBOX_SETTINGS_GET: `${prefix} mailbox settings get`,
     MAILBOX_SETTINGS_SET: `${prefix} mailbox settings set`,
     MESSAGE_GET: `${prefix} message get`,
     MESSAGE_LIST: `${prefix} message list`,

package/dist/m365/spo/commands/field/field-get.js

@@ -42,7 +42,7 @@ class SpoFieldGetCommand extends SpoCommand {
             fieldRestUrl = `/getbyid('${formatting.encodeQueryParameter(args.options.id)}')`;
         }
         else {
-            fieldRestUrl = `/getbyinternalnameortitle('${formatting.encodeQueryParameter(args.options.title)}')`;
+            fieldRestUrl = `/getbyinternalnameortitle('${formatting.encodeQueryParameter((args.options.title || args.options.internalName))}')`;
         }
         const requestOptions = {
             url: `${args.options.webUrl}/_api/web/${listRestUrl}fields${fieldRestUrl}`,
@@ -67,7 +67,8 @@ _SpoFieldGetCommand_instances = new WeakSet(), _SpoFieldGetCommand_initTelemetry
             listTitle: typeof args.options.listTitle !== 'undefined',
             listUrl: typeof args.options.listUrl !== 'undefined',
             id: typeof args.options.id !== 'undefined',
-            title: typeof args.options.title !== 'undefined'
+            title: typeof args.options.title !== 'undefined',
+            internalName: typeof args.options.internalName !== 'undefined'
         });
     });
 }, _SpoFieldGetCommand_initOptions = function _SpoFieldGetCommand_initOptions() {
@@ -83,6 +84,8 @@ _SpoFieldGetCommand_instances = new WeakSet(), _SpoFieldGetCommand_initTelemetry
         option: '-i, --id [id]'
     }, {
         option: '-t, --title [title]'
+    }, {
+        option: '--internalName [internalName]'
     });
 }, _SpoFieldGetCommand_initValidators = function _SpoFieldGetCommand_initValidators() {
     this.validators.push(async (args) => {
@@ -99,7 +102,7 @@ _SpoFieldGetCommand_instances = new WeakSet(), _SpoFieldGetCommand_initTelemetry
         return true;
     });
 }, _SpoFieldGetCommand_initOptionSets = function _SpoFieldGetCommand_initOptionSets() {
-    this.optionSets.push({ options: ['id', 'title'] });
+    this.optionSets.push({ options: ['id', 'title', 'internalName'] });
 };
 export default new SpoFieldGetCommand();
 //# sourceMappingURL=field-get.js.map

package/dist/m365/spo/commands/field/field-remove.js

@@ -34,16 +34,16 @@ class SpoFieldRemoveCommand extends SpoCommand {
         else {
             messageEnd = `in site ${args.options.webUrl}`;
         }
-        const removeField = async (listRestUrl, fieldId, title) => {
+        const removeField = async (listRestUrl, fieldId, title, internalName) => {
             if (this.verbose) {
-                await logger.logToStderr(`Removing field ${fieldId || title} ${messageEnd}...`);
+                await logger.logToStderr(`Removing field ${fieldId || title || internalName} ${messageEnd}...`);
             }
             let fieldRestUrl = '';
             if (fieldId) {
                 fieldRestUrl = `/getbyid('${formatting.encodeQueryParameter(fieldId)}')`;
             }
             else {
-                fieldRestUrl = `/getbyinternalnameortitle('${formatting.encodeQueryParameter(title)}')`;
+                fieldRestUrl = `/getbyinternalnameortitle('${formatting.encodeQueryParameter(title || internalName)}')`;
             }
             const requestOptions = {
                 url: `${args.options.webUrl}/_api/web/${listRestUrl}fields${fieldRestUrl}`,
@@ -88,7 +88,7 @@ class SpoFieldRemoveCommand extends SpoCommand {
                     }
                     const promises = [];
                     for (let index = 0; index < filteredResults.length; index++) {
-                        promises.push(removeField(listRestUrl, filteredResults[index].Id, undefined));
+                        promises.push(removeField(listRestUrl, filteredResults[index].Id));
                     }
                     await Promise.all(promises);
                 }
@@ -98,8 +98,7 @@ class SpoFieldRemoveCommand extends SpoCommand {
             }
             else {
                 try {
-                    await removeField(listRestUrl, args.options.id, args.options.title);
-                    // REST post call doesn't return anything
+                    await removeField(listRestUrl, args.options.id, args.options.title, args.options.internalName);
                 }
                 catch (err) {
                     this.handleRejectedODataJsonPromise(err);
@@ -110,7 +109,7 @@ class SpoFieldRemoveCommand extends SpoCommand {
             await prepareRemoval();
         }
         else {
-            const confirmMessage = `Are you sure you want to remove the ${args.options.group ? 'fields' : 'field'} ${args.options.id || args.options.title || 'from group ' + args.options.group} ${messageEnd}?`;
+            const confirmMessage = `Are you sure you want to remove the ${args.options.group ? 'fields' : 'field'} ${args.options.id || args.options.title || args.options.internalName || 'from group ' + args.options.group} ${messageEnd}?`;
             const result = await cli.promptForConfirmation({ message: confirmMessage });
             if (result) {
                 await prepareRemoval();
@@ -127,6 +126,7 @@ _SpoFieldRemoveCommand_instances = new WeakSet(), _SpoFieldRemoveCommand_initTel
             id: typeof args.options.id !== 'undefined',
             group: typeof args.options.group !== 'undefined',
             title: typeof args.options.title !== 'undefined',
+            internalName: typeof args.options.internalName !== 'undefined',
             force: (!(!args.options.force)).toString()
         });
     });
@@ -143,6 +143,8 @@ _SpoFieldRemoveCommand_instances = new WeakSet(), _SpoFieldRemoveCommand_initTel
         option: '-i, --id [id]'
     }, {
         option: '-t, --title [title]'
+    }, {
+        option: '--internalName [internalName]'
     }, {
         option: '-g, --group [group]'
     }, {
@@ -163,7 +165,7 @@ _SpoFieldRemoveCommand_instances = new WeakSet(), _SpoFieldRemoveCommand_initTel
         return true;
     });
 }, _SpoFieldRemoveCommand_initOptionSets = function _SpoFieldRemoveCommand_initOptionSets() {
-    this.optionSets.push({ options: ['id', 'title', 'group'] });
+    this.optionSets.push({ options: ['id', 'title', 'internalName', 'group'] });
 };
 export default new SpoFieldRemoveCommand();
 //# sourceMappingURL=field-remove.js.map

package/dist/m365/spo/commands/field/field-set.js

@@ -66,7 +66,7 @@ class SpoFieldSetCommand extends SpoCommand {
             // retrieve column CSOM object id
             const fieldQuery = args.options.id ?
                 `<Method Id="663" ParentId="7" Name="GetById"><Parameters><Parameter Type="Guid">${formatting.escapeXml(args.options.id)}</Parameter></Parameters></Method>` :
-                `<Method Id="663" ParentId="7" Name="GetByInternalNameOrTitle"><Parameters><Parameter Type="String">${formatting.escapeXml(args.options.name || args.options.title)}</Parameter></Parameters></Method>`;
+                `<Method Id="663" ParentId="7" Name="GetByInternalNameOrTitle"><Parameters><Parameter Type="String">${formatting.escapeXml(args.options.title || args.options.internalName)}</Parameter></Parameters></Method>`;
             let requestOptions = {
                 url: `${args.options.webUrl}/_vti_bin/client.svc/ProcessQuery`,
                 headers: {
@@ -108,6 +108,7 @@ class SpoFieldSetCommand extends SpoCommand {
             'listUrl',
             'id',
             'title',
+            'internalName',
             'updateExistingLists',
             'debug',
             'verbose',
@@ -125,6 +126,7 @@ _SpoFieldSetCommand_instances = new WeakSet(), _SpoFieldSetCommand_initTelemetry
         Object.assign(this.telemetryProperties, {
             id: typeof args.options.id !== 'undefined',
             title: typeof args.options.title !== 'undefined',
+            internalName: typeof args.options.internalName !== 'undefined',
             listId: typeof args.options.listId !== 'undefined',
             listTitle: typeof args.options.listTitle !== 'undefined',
             listUrl: typeof args.options.listUrl !== 'undefined',
@@ -144,6 +146,8 @@ _SpoFieldSetCommand_instances = new WeakSet(), _SpoFieldSetCommand_initTelemetry
         option: '-i, --id [id]'
     }, {
         option: '-t, --title [title]'
+    }, {
+        option: '--internalName [internalName]'
     }, {
         option: '--updateExistingLists'
     });
@@ -168,7 +172,7 @@ _SpoFieldSetCommand_instances = new WeakSet(), _SpoFieldSetCommand_initTelemetry
         return true;
     });
 }, _SpoFieldSetCommand_initOptionSets = function _SpoFieldSetCommand_initOptionSets() {
-    this.optionSets.push({ options: ['id', 'title'] });
+    this.optionSets.push({ options: ['id', 'title', 'internalName'] });
 };
 export default new SpoFieldSetCommand();
 //# sourceMappingURL=field-set.js.map

package/dist/m365/spo/commands/mail/mail-send.js

@@ -8,6 +8,7 @@ import request from '../../../../request.js';
 import { validation } from '../../../../utils/validation.js';
 import SpoCommand from '../../../base/SpoCommand.js';
 import commands from '../../commands.js';
+import outlookCommands from '../../../outlook/commands.js';
 class SpoMailSendCommand extends SpoCommand {
     get name() {
         return commands.MAIL_SEND;
@@ -23,6 +24,7 @@ class SpoMailSendCommand extends SpoCommand {
         __classPrivateFieldGet(this, _SpoMailSendCommand_instances, "m", _SpoMailSendCommand_initValidators).call(this);
     }
     async commandAction(logger, args) {
+        await this.showDeprecationWarning(logger, commands.MAIL_SEND, outlookCommands.MAIL_SEND);
         const params = {
             properties: {
                 __metadata: { "type": "SP.Utilities.EmailProperties" },

package/docs/docs/cmd/entra/group/group-member-add.mdx

@@ -14,10 +14,13 @@ m365 entra group member add [options]
 
 ```md definition-list
 `-i, --groupId [groupId]`
-: The ID of the Microsoft Entra group. Specify `groupId` or `groupDisplayName` but not both.
+: The ID of the Microsoft Entra group. Specify `groupId`, `groupDisplayName` or `groupName` but not multiple.
 
 `-n, --groupDisplayName [groupDisplayName]`
-: The display name of the Microsoft Entra group. Specify `groupId` or `groupDisplayName` but not both.
+: (deprecated. Use option `groupName` instead) The display name of the Microsoft Entra group. Specify `groupId`, `groupDisplayName` or `groupName` but not multiple.
+
+`--groupName [groupName]`
+: The display name of the Microsoft Entra group. Specify `groupId`, `groupDisplayName` or `groupName` but not multiple.
 
 `--ids [ids]`
 : Microsoft Entra IDs of users. You can also pass a comma-separated list of IDs. Specify either `ids` or `userNames` but not both.
@@ -39,6 +42,12 @@ Add a single member specified by ID as a member to a group specified by display
 m365 entra group member add --groupDisplayName Developers --ids 098b9f52-f48c-4401-819f-29c33794c3f5 --role Member
 ```
 
+Add a single member specified by ID as a member to a group specified by group name.
+
+```sh
+m365 entra group member add --groupName Developers --ids 098b9f52-f48c-4401-819f-29c33794c3f5 --role Member
+```
+
 Add multiple members specified by ID as members to a group specified by ID.
 
 ```sh
@@ -51,6 +60,12 @@ Add a single member specified by UPN as an owner to a group specified by display
 m365 entra group member add --groupDisplayName Developers --userNames john.doe@contoso.com --role Owner
 ```
 
+Add a single member specified by UPN as an owner to a group specified by group name.
+
+```sh
+m365 entra group member add --groupName Developers --userNames john.doe@contoso.com --role Owner
+```
+
 Adds multiple members specified by UPN as owners to a group specified by ID.
 
 ```sh

package/docs/docs/cmd/entra/group/group-member-set.mdx

@@ -14,10 +14,13 @@ m365 entra group member set [options]
 
 ```md definition-list
 `-i, --groupId [groupId]`
-: The ID of the Entra ID group. Specify `groupId` or `groupDisplayName` but not both.
+: The ID of the Entra ID group. Specify `groupId`, `groupDisplayName` or `groupName` but not multiple.
 
 `-n, --groupDisplayName [groupDisplayName]`
-: The display name of the Entra ID group. Specify `groupId` or `groupDisplayName` but not both.
+: (deprecated. Use option `groupName` instead) The display name of the Entra ID group. Specify `groupId`, `groupDisplayName` or `groupName` but not multiple.
+
+`--groupName [groupName]`
+: The display name of the Microsoft Entra group. Specify `groupId`, `groupDisplayName` or `groupName` but not multiple.
 
 `--ids [ids]`
 : Comma-separated list of user IDs. Specify either `ids` or `userNames` but not both.
@@ -39,6 +42,12 @@ Update a single member specified by ID to a member of a group specified by displ
 m365 entra group member set --groupDisplayName Developers --ids 098b9f52-f48c-4401-819f-29c33794c3f5 --role Member
 ```
 
+Update a single member specified by ID to a member of a group specified by group name
+
+```sh
+m365 entra group member set --groupName Developers --ids 098b9f52-f48c-4401-819f-29c33794c3f5 --role Member
+```
+
 Update multiple members specified by ID to members of a group specified by ID
 
 ```sh
@@ -51,6 +60,12 @@ Update a single member specified by UPN to an owner of a group specified by disp
 m365 entra group member set --groupDisplayName Developers --userNames john.doe@contoso.com --role Owner
 ```
 
+Update a single member specified by UPN to an owner of a group specified by group name
+
+```sh
+m365 entra group member set --groupName Developers --userNames john.doe@contoso.com --role Owner
+```
+
 Update multiple members specified by UPN to owners of a group specified by ID
 
 ```sh

package/docs/docs/cmd/entra/user/user-session-revoke.mdx

@@ -0,0 +1,65 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# entra user session revoke
+
+Revokes all sign-in sessions for a given user
+
+## Usage
+
+```sh
+m365 entra user session revoke [options]
+```
+
+## Options
+```md definition-list
+`-i, --userId [userId]`
+: The id of the user. Specify either `userId` or `userName`, but not both.
+
+`-n, --userName [userName]`
+: The user principal name of the user. Specify either `userId` or `userName`, but not both.
+
+`-f, --force`
+: Don't prompt for confirmation.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+To use this command you must be either **User Administrator** or **Global Administrator**.
+
+:::
+
+:::note
+
+There might be a small delay of a few minutes before tokens are revoked.
+
+This API doesn't revoke sign-in sessions for external users, because external users sign in through their home tenant.
+
+:::
+
+## Examples
+
+Revoke sign-in sessions of a user specified by id
+
+```sh
+m365 entra user session revoke --userId 4fb72b9b-d0b0-4a35-8bc1-83f9a6488c48
+```
+
+Revoke sign-in sessions of a user specified by its UPN
+
+```sh
+m365 entra user session revoke --userName john.doe@contoso.onmicrosoft.com
+```
+
+Revoke sign-in sessions of a user specified by its UPN without prompting for confirmation
+
+```sh
+m365 entra user session revoke --userName john.doe@contoso.onmicrosoft.com --force
+```
+
+## Response
+
+The command won't return a response on success.