@pnp/cli-microsoft365 10.4.0-beta.17b3a55 → 10.4.0-beta.47f1e4d

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/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/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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "10.4.0-beta.17b3a55",
+  "version": "10.4.0-beta.47f1e4d",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",