@pnp/cli-microsoft365 10.5.0 → 10.6.0-beta.38233e7

package/dist/m365/spo/commands/listitem/listitem-roleassignment-add.js

@@ -4,7 +4,6 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
 var _SpoListItemRoleAssignmentAddCommand_instances, _SpoListItemRoleAssignmentAddCommand_initTelemetry, _SpoListItemRoleAssignmentAddCommand_initOptions, _SpoListItemRoleAssignmentAddCommand_initValidators;
-import { cli } from '../../../../cli/cli.js';
 import request from '../../../../request.js';
 import { entraGroup } from '../../../../utils/entraGroup.js';
 import { formatting } from '../../../../utils/formatting.js';
@@ -12,9 +11,6 @@ import { urlUtil } from '../../../../utils/urlUtil.js';
 import { validation } from '../../../../utils/validation.js';
 import SpoCommand from '../../../base/SpoCommand.js';
 import commands from '../../commands.js';
-import spoGroupGetCommand from '../group/group-get.js';
-import spoRoleDefinitionListCommand from '../roledefinition/roledefinition-list.js';
-import spoUserGetCommand from '../user/user-get.js';
 import { spo } from '../../../../utils/spo.js';
 class SpoListItemRoleAssignmentAddCommand extends SpoCommand {
     get name() {
@@ -47,15 +43,13 @@ class SpoListItemRoleAssignmentAddCommand extends SpoCommand {
                 requestUrl += `GetList('${formatting.encodeQueryParameter(listServerRelativeUrl)}')/`;
             }
             requestUrl += `items(${args.options.listItemId})/`;
-            const roleDefinitionId = await this.getRoleDefinitionId(args.options);
+            const roleDefinitionId = await this.getRoleDefinitionId(args.options, logger);
             let principalId = args.options.principalId;
             if (args.options.upn) {
-                principalId = await this.getUserPrincipalId(args.options);
-                await this.addRoleAssignment(requestUrl, roleDefinitionId, principalId);
+                principalId = await this.getUserPrincipalId(args.options, logger);
             }
             else if (args.options.groupName) {
-                principalId = await this.getGroupPrincipalId(args.options);
-                await this.addRoleAssignment(requestUrl, roleDefinitionId, principalId);
+                principalId = await this.getGroupPrincipalId(args.options, logger);
             }
             else if (args.options.entraGroupId || args.options.entraGroupName) {
                 if (this.verbose) {
@@ -85,45 +79,20 @@ class SpoListItemRoleAssignmentAddCommand extends SpoCommand {
         };
         await request.post(requestOptions);
     }
-    async getRoleDefinitionId(options) {
+    async getRoleDefinitionId(options, logger) {
         if (!options.roleDefinitionName) {
             return options.roleDefinitionId;
         }
-        const roleDefinitionListCommandOptions = {
-            webUrl: options.webUrl,
-            output: 'json',
-            debug: this.debug,
-            verbose: this.verbose
-        };
-        const output = await cli.executeCommandWithOutput(spoRoleDefinitionListCommand, { options: { ...roleDefinitionListCommandOptions, _: [] } });
-        const getRoleDefinitionListOutput = JSON.parse(output.stdout);
-        const roleDefinitionId = getRoleDefinitionListOutput.find((role) => role.Name === options.roleDefinitionName).Id;
-        return roleDefinitionId;
+        const roleDefintion = await spo.getRoleDefinitionByName(options.webUrl, options.roleDefinitionName, logger, this.verbose);
+        return roleDefintion.Id;
     }
-    async getGroupPrincipalId(options) {
-        const groupGetCommandOptions = {
-            webUrl: options.webUrl,
-            name: options.groupName,
-            output: 'json',
-            debug: this.debug,
-            verbose: this.verbose
-        };
-        const output = await cli.executeCommandWithOutput(spoGroupGetCommand, { options: { ...groupGetCommandOptions, _: [] } });
-        const getGroupOutput = JSON.parse(output.stdout);
-        return getGroupOutput.Id;
+    async getGroupPrincipalId(options, logger) {
+        const group = await spo.getGroupByName(options.webUrl, options.groupName, logger, this.verbose);
+        return group.Id;
     }
-    async getUserPrincipalId(options) {
-        const userGetCommandOptions = {
-            webUrl: options.webUrl,
-            email: options.upn,
-            id: undefined,
-            output: 'json',
-            debug: this.debug,
-            verbose: this.verbose
-        };
-        const output = await cli.executeCommandWithOutput(spoUserGetCommand, { options: { ...userGetCommandOptions, _: [] } });
-        const getUserOutput = JSON.parse(output.stdout);
-        return getUserOutput.Id;
+    async getUserPrincipalId(options, logger) {
+        const user = await spo.getUserByEmail(options.webUrl, options.upn, logger, this.verbose);
+        return user.Id;
     }
 }
 _SpoListItemRoleAssignmentAddCommand_instances = new WeakSet(), _SpoListItemRoleAssignmentAddCommand_initTelemetry = function _SpoListItemRoleAssignmentAddCommand_initTelemetry() {

package/dist/m365/spo/commands/listitem/listitem-roleassignment-remove.js

@@ -11,8 +11,6 @@ import { urlUtil } from '../../../../utils/urlUtil.js';
 import { validation } from '../../../../utils/validation.js';
 import SpoCommand from '../../../base/SpoCommand.js';
 import commands from '../../commands.js';
-import spoGroupGetCommand from '../group/group-get.js';
-import spoUserGetCommand from '../user/user-get.js';
 import { entraGroup } from '../../../../utils/entraGroup.js';
 import { spo } from '../../../../utils/spo.js';
 class SpoListItemRoleAssignmentRemoveCommand extends SpoCommand {
@@ -59,10 +57,10 @@ class SpoListItemRoleAssignmentRemoveCommand extends SpoCommand {
             }
             requestUrl += `items(${options.listItemId})/`;
             if (options.upn) {
-                options.principalId = await this.getUserPrincipalId(options);
+                options.principalId = await this.getUserPrincipalId(options, logger);
             }
             else if (options.groupName) {
-                options.principalId = await this.getGroupPrincipalId(options);
+                options.principalId = await this.getGroupPrincipalId(options, logger);
             }
             else if (options.entraGroupId || options.entraGroupName) {
                 if (this.verbose) {
@@ -92,30 +90,13 @@ class SpoListItemRoleAssignmentRemoveCommand extends SpoCommand {
         };
         await request.post(requestOptions);
     }
-    async getGroupPrincipalId(options) {
-        const groupGetCommandOptions = {
-            webUrl: options.webUrl,
-            name: options.groupName,
-            output: 'json',
-            debug: this.debug,
-            verbose: this.verbose
-        };
-        const output = await cli.executeCommandWithOutput(spoGroupGetCommand, { options: { ...groupGetCommandOptions, _: [] } });
-        const getGroupOutput = JSON.parse(output.stdout);
-        return getGroupOutput.Id;
+    async getGroupPrincipalId(options, logger) {
+        const group = await spo.getGroupByName(options.webUrl, options.groupName, logger, this.verbose);
+        return group.Id;
     }
-    async getUserPrincipalId(options) {
-        const userGetCommandOptions = {
-            webUrl: options.webUrl,
-            email: options.upn,
-            id: undefined,
-            output: 'json',
-            debug: this.debug,
-            verbose: this.verbose
-        };
-        const output = await cli.executeCommandWithOutput(spoUserGetCommand, { options: { ...userGetCommandOptions, _: [] } });
-        const getUserOutput = JSON.parse(output.stdout);
-        return getUserOutput.Id;
+    async getUserPrincipalId(options, logger) {
+        const user = await spo.getUserByEmail(options.webUrl, options.upn, logger, this.verbose);
+        return user.Id;
     }
 }
 _SpoListItemRoleAssignmentRemoveCommand_instances = new WeakSet(), _SpoListItemRoleAssignmentRemoveCommand_initTelemetry = function _SpoListItemRoleAssignmentRemoveCommand_initTelemetry() {

package/dist/m365/spo/commands/web/web-roleassignment-add.js

@@ -4,16 +4,12 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
 var _SpoWebRoleAssignmentAddCommand_instances, _SpoWebRoleAssignmentAddCommand_initTelemetry, _SpoWebRoleAssignmentAddCommand_initOptions, _SpoWebRoleAssignmentAddCommand_initValidators, _SpoWebRoleAssignmentAddCommand_initOptionSets;
-import { cli } from '../../../../cli/cli.js';
 import request from '../../../../request.js';
+import { entraGroup } from '../../../../utils/entraGroup.js';
+import { spo } from '../../../../utils/spo.js';
 import { validation } from '../../../../utils/validation.js';
 import SpoCommand from '../../../base/SpoCommand.js';
 import commands from '../../commands.js';
-import spoGroupGetCommand from '../group/group-get.js';
-import spoRoleDefinitionListCommand from '../roledefinition/roledefinition-list.js';
-import spoUserGetCommand from '../user/user-get.js';
-import { entraGroup } from '../../../../utils/entraGroup.js';
-import { spo } from '../../../../utils/spo.js';
 class SpoWebRoleAssignmentAddCommand extends SpoCommand {
     get name() {
         return commands.WEB_ROLEASSIGNMENT_ADD;
@@ -34,12 +30,14 @@ class SpoWebRoleAssignmentAddCommand extends SpoCommand {
             await logger.logToStderr(`Adding role assignment to web ${args.options.webUrl}...`);
         }
         try {
-            args.options.roleDefinitionId = await this.getRoleDefinitionId(args.options);
+            const roleDefinitionId = await this.getRoleDefinitionId(args.options, logger);
             if (args.options.upn) {
-                args.options.principalId = await this.getUserPrincipalId(args.options);
+                const principalId = await this.getUserPrincipalId(args.options, logger);
+                await this.addRoleAssignment(args.options.webUrl, principalId, roleDefinitionId, logger);
             }
             else if (args.options.groupName) {
-                args.options.principalId = await this.getGroupPrincipalId(args.options);
+                const principalId = await this.getGroupPrincipalId(args.options, logger);
+                await this.addRoleAssignment(args.options.webUrl, principalId, roleDefinitionId, logger);
             }
             else if (args.options.entraGroupId || args.options.entraGroupName) {
                 if (this.verbose) {
@@ -49,17 +47,19 @@ class SpoWebRoleAssignmentAddCommand extends SpoCommand {
                     ? await entraGroup.getGroupById(args.options.entraGroupId)
                     : await entraGroup.getGroupByDisplayName(args.options.entraGroupName);
                 const siteUser = await spo.ensureEntraGroup(args.options.webUrl, group);
-                args.options.principalId = siteUser.Id;
+                await this.addRoleAssignment(args.options.webUrl, siteUser.Id, roleDefinitionId, logger);
             }
-            await this.addRoleAssignment(logger, args.options);
         }
         catch (err) {
             this.handleRejectedODataJsonPromise(err);
         }
     }
-    async addRoleAssignment(logger, options) {
+    async addRoleAssignment(webUrl, principalId, roleDefinitionId, logger) {
+        if (this.verbose) {
+            await logger.logToStderr('Adding role assignment...');
+        }
         const requestOptions = {
-            url: `${options.webUrl}/_api/web/roleassignments/addroleassignment(principalid='${options.principalId}',roledefid='${options.roleDefinitionId}')`,
+            url: `${webUrl}/_api/web/roleassignments/addroleassignment(principalid='${principalId}',roledefid='${roleDefinitionId}')`,
             method: 'POST',
             headers: {
                 'accept': 'application/json;odata=nometadata',
@@ -69,45 +69,20 @@ class SpoWebRoleAssignmentAddCommand extends SpoCommand {
         };
         await request.post(requestOptions);
     }
-    async getRoleDefinitionId(options) {
+    async getRoleDefinitionId(options, logger) {
         if (!options.roleDefinitionName) {
             return options.roleDefinitionId;
         }
-        const roleDefinitionListCommandOptions = {
-            webUrl: options.webUrl,
-            output: 'json',
-            debug: this.debug,
-            verbose: this.verbose
-        };
-        const output = await cli.executeCommandWithOutput(spoRoleDefinitionListCommand, { options: { ...roleDefinitionListCommandOptions, _: [] } });
-        const getRoleDefinitionListOutput = JSON.parse(output.stdout);
-        const roleDefinitionId = getRoleDefinitionListOutput.find((role) => role.Name === options.roleDefinitionName).Id;
-        return roleDefinitionId;
+        const roledefinition = await spo.getRoleDefinitionByName(options.webUrl, options.roleDefinitionName, logger, this.verbose);
+        return roledefinition.Id;
     }
-    async getGroupPrincipalId(options) {
-        const groupGetCommandOptions = {
-            webUrl: options.webUrl,
-            name: options.groupName,
-            output: 'json',
-            debug: this.debug,
-            verbose: this.verbose
-        };
-        const output = await cli.executeCommandWithOutput(spoGroupGetCommand, { options: { ...groupGetCommandOptions, _: [] } });
-        const getGroupOutput = JSON.parse(output.stdout);
-        return getGroupOutput.Id;
+    async getGroupPrincipalId(options, logger) {
+        const group = await spo.getGroupByName(options.webUrl, options.groupName, logger, this.verbose);
+        return group.Id;
     }
-    async getUserPrincipalId(options) {
-        const userGetCommandOptions = {
-            webUrl: options.webUrl,
-            email: options.upn,
-            id: undefined,
-            output: 'json',
-            debug: this.debug,
-            verbose: this.verbose
-        };
-        const output = await cli.executeCommandWithOutput(spoUserGetCommand, { options: { ...userGetCommandOptions, _: [] } });
-        const getUserOutput = JSON.parse(output.stdout);
-        return getUserOutput.Id;
+    async getUserPrincipalId(options, logger) {
+        const user = await spo.getUserByEmail(options.webUrl, options.upn, logger, this.verbose);
+        return user.Id;
     }
 }
 _SpoWebRoleAssignmentAddCommand_instances = new WeakSet(), _SpoWebRoleAssignmentAddCommand_initTelemetry = function _SpoWebRoleAssignmentAddCommand_initTelemetry() {

package/dist/m365/spo/commands/web/web-roleassignment-remove.js

@@ -4,15 +4,13 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
 var _SpoWebRoleAssignmentRemoveCommand_instances, _SpoWebRoleAssignmentRemoveCommand_initTelemetry, _SpoWebRoleAssignmentRemoveCommand_initOptions, _SpoWebRoleAssignmentRemoveCommand_initValidators, _SpoWebRoleAssignmentRemoveCommand_initOptionSets;
-import { cli } from '../../../../cli/cli.js';
 import request from '../../../../request.js';
 import { validation } from '../../../../utils/validation.js';
 import SpoCommand from '../../../base/SpoCommand.js';
 import commands from '../../commands.js';
-import spoGroupGetCommand from '../group/group-get.js';
-import spoUserGetCommand from '../user/user-get.js';
 import { entraGroup } from '../../../../utils/entraGroup.js';
 import { spo } from '../../../../utils/spo.js';
+import { cli } from '../../../../cli/cli.js';
 class SpoWebRoleAssignmentRemoveCommand extends SpoCommand {
     get name() {
         return commands.WEB_ROLEASSIGNMENT_REMOVE;
@@ -45,10 +43,12 @@ class SpoWebRoleAssignmentRemoveCommand extends SpoCommand {
         }
         try {
             if (options.upn) {
-                options.principalId = await this.getUserPrincipalId(options);
+                const principalId = await this.getUserPrincipalId(options, logger);
+                await this.removeRoleAssignmentWithOptions(options.webUrl, principalId, logger);
             }
             else if (options.groupName) {
-                options.principalId = await this.getGroupPrincipalId(options);
+                const principalId = await this.getGroupPrincipalId(options, logger);
+                await this.removeRoleAssignmentWithOptions(options.webUrl, principalId, logger);
             }
             else if (options.entraGroupId || options.entraGroupName) {
                 if (this.verbose) {
@@ -58,17 +58,19 @@ class SpoWebRoleAssignmentRemoveCommand extends SpoCommand {
                     ? await entraGroup.getGroupById(options.entraGroupId)
                     : await entraGroup.getGroupByDisplayName(options.entraGroupName);
                 const siteUser = await spo.ensureEntraGroup(options.webUrl, group);
-                options.principalId = siteUser.Id;
+                await this.removeRoleAssignmentWithOptions(options.webUrl, siteUser.Id, logger);
             }
-            await this.removeRoleAssignmentWithOptions(logger, options);
         }
         catch (err) {
             this.handleRejectedODataJsonPromise(err);
         }
     }
-    async removeRoleAssignmentWithOptions(logger, options) {
+    async removeRoleAssignmentWithOptions(webUrl, principalId, logger) {
+        if (this.verbose) {
+            await logger.logToStderr('Removing role assignment...');
+        }
         const requestOptions = {
-            url: `${options.webUrl}/_api/web/roleassignments/removeroleassignment(principalid='${options.principalId}')`,
+            url: `${webUrl}/_api/web/roleassignments/removeroleassignment(principalid='${principalId}')`,
             method: 'POST',
             headers: {
                 'accept': 'application/json;odata=nometadata',
@@ -78,30 +80,13 @@ class SpoWebRoleAssignmentRemoveCommand extends SpoCommand {
         };
         await request.post(requestOptions);
     }
-    async getGroupPrincipalId(options) {
-        const groupGetCommandOptions = {
-            webUrl: options.webUrl,
-            name: options.groupName,
-            output: 'json',
-            debug: this.debug,
-            verbose: this.verbose
-        };
-        const output = await cli.executeCommandWithOutput(spoGroupGetCommand, { options: { ...groupGetCommandOptions, _: [] } });
-        const getGroupOutput = JSON.parse(output.stdout);
-        return getGroupOutput.Id;
+    async getGroupPrincipalId(options, logger) {
+        const group = await spo.getGroupByName(options.webUrl, options.groupName, logger, this.verbose);
+        return group.Id;
     }
-    async getUserPrincipalId(options) {
-        const userGetCommandOptions = {
-            webUrl: options.webUrl,
-            email: options.upn,
-            id: undefined,
-            output: 'json',
-            debug: this.debug,
-            verbose: this.verbose
-        };
-        const output = await cli.executeCommandWithOutput(spoUserGetCommand, { options: { ...userGetCommandOptions, _: [] } });
-        const getUserOutput = JSON.parse(output.stdout);
-        return getUserOutput.Id;
+    async getUserPrincipalId(options, logger) {
+        const user = await spo.getUserByEmail(options.webUrl, options.upn, logger, this.verbose);
+        return user.Id;
     }
 }
 _SpoWebRoleAssignmentRemoveCommand_instances = new WeakSet(), _SpoWebRoleAssignmentRemoveCommand_initTelemetry = function _SpoWebRoleAssignmentRemoveCommand_initTelemetry() {

package/dist/m365/tenant/commands/people/people-profilecardproperty-add.js

@@ -5,6 +5,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 };
 var _TenantPeopleProfileCardPropertyAddCommand_instances, _TenantPeopleProfileCardPropertyAddCommand_initTelemetry, _TenantPeopleProfileCardPropertyAddCommand_initOptions, _TenantPeopleProfileCardPropertyAddCommand_initValidators;
 import request from '../../../../request.js';
+import { optionsUtils } from '../../../../utils/optionsUtils.js';
 import GraphCommand from '../../../base/GraphCommand.js';
 import commands from '../../commands.js';
 import { profileCardPropertyNames } from './profileCardProperties.js';
@@ -71,7 +72,7 @@ class TenantPeopleProfileCardPropertyAddCommand extends GraphCommand {
         ];
     }
     getLocalizations(options) {
-        const unknownOptions = Object.keys(this.getUnknownOptions(options));
+        const unknownOptions = Object.keys(optionsUtils.getUnknownOptions(options, this.options));
         if (unknownOptions.length === 0) {
             return [];
         }
@@ -88,7 +89,7 @@ class TenantPeopleProfileCardPropertyAddCommand extends GraphCommand {
 _TenantPeopleProfileCardPropertyAddCommand_instances = new WeakSet(), _TenantPeopleProfileCardPropertyAddCommand_initTelemetry = function _TenantPeopleProfileCardPropertyAddCommand_initTelemetry() {
     this.telemetry.push((args) => {
         // Add unknown options to telemetry
-        const unknownOptions = Object.keys(this.getUnknownOptions(args.options));
+        const unknownOptions = Object.keys(optionsUtils.getUnknownOptions(args.options, this.options));
         const unknownOptionsObj = unknownOptions.reduce((obj, key) => ({ ...obj, [key]: true }), {});
         Object.assign(this.telemetryProperties, {
             displayName: typeof args.options.displayName !== 'undefined',
@@ -114,7 +115,7 @@ _TenantPeopleProfileCardPropertyAddCommand_instances = new WeakSet(), _TenantPeo
         if (!propertyName.startsWith('customattribute') && args.options.displayName !== undefined) {
             return `The option 'displayName' can only be used when adding customAttributes as profile card properties`;
         }
-        const unknownOptions = Object.keys(this.getUnknownOptions(args.options));
+        const unknownOptions = Object.keys(optionsUtils.getUnknownOptions(args.options, this.options));
         if (!propertyName.startsWith('customattribute') && unknownOptions.length > 0) {
             return `Unknown options like ${unknownOptions.join(', ')} are only supported with customAttributes`;
         }

package/dist/m365/tenant/commands/people/people-profilecardproperty-set.js

@@ -8,6 +8,7 @@ import GraphCommand from '../../../base/GraphCommand.js';
 import request from '../../../../request.js';
 import { profileCardPropertyNames as allProfileCardPropertyNames } from './profileCardProperties.js';
 import commands from '../../commands.js';
+import { optionsUtils } from '../../../../utils/optionsUtils.js';
 class TenantPeopleProfileCardPropertySetCommand extends GraphCommand {
     get name() {
         return commands.PEOPLE_PROFILECARDPROPERTY_SET;
@@ -73,7 +74,7 @@ class TenantPeopleProfileCardPropertySetCommand extends GraphCommand {
      * @example Transform "--displayName-en-US 'Cost center'" to { languageTag: 'en-US', displayName: 'Cost center' }
      */
     getLocalizations(options) {
-        const unknownOptions = this.getUnknownOptions(options);
+        const unknownOptions = optionsUtils.getUnknownOptions(options, this.options);
         const result = Object.keys(unknownOptions).map(o => ({
             languageTag: o.substring(o.indexOf('-') + 1),
             displayName: unknownOptions[o]
@@ -84,7 +85,7 @@ class TenantPeopleProfileCardPropertySetCommand extends GraphCommand {
 _TenantPeopleProfileCardPropertySetCommand_instances = new WeakSet(), _TenantPeopleProfileCardPropertySetCommand_initTelemetry = function _TenantPeopleProfileCardPropertySetCommand_initTelemetry() {
     this.telemetry.push((args) => {
         // Add unknown options to telemetry
-        const unknownOptions = Object.keys(this.getUnknownOptions(args.options));
+        const unknownOptions = Object.keys(optionsUtils.getUnknownOptions(args.options, this.options));
         const unknownOptionsObj = unknownOptions.reduce((obj, key) => ({ ...obj, [key]: true }), {});
         Object.assign(this.telemetryProperties, {
             displayName: typeof args.options.displayName !== 'undefined',
@@ -104,7 +105,7 @@ _TenantPeopleProfileCardPropertySetCommand_instances = new WeakSet(), _TenantPeo
             return `'${args.options.name}' is not a valid value for option name. Allowed values are: ${this.profileCardPropertyNames.join(', ')}.`;
         }
         // Unknown options are allowed only if they start with 'displayName-'
-        const unknownOptionKeys = Object.keys(this.getUnknownOptions(args.options));
+        const unknownOptionKeys = Object.keys(optionsUtils.getUnknownOptions(args.options, this.options));
         const invalidOptionKey = unknownOptionKeys.find(o => !o.startsWith('displayName-'));
         if (invalidOptionKey) {
             return `Invalid option: '${invalidOptionKey}'`;

package/dist/m365/todo/commands/list/list-remove.js

@@ -46,7 +46,7 @@ class TodoListRemoveCommand extends DelegatedGraphCommand {
             responseType: 'json'
         };
         const response = await request.get(requestOptions);
-        return response.value && response.value.length === 1 ? response.value[0].id : null;
+        return response.value && response.value.length === 1 ? response.value[0].id : undefined;
     }
     async removeList(args) {
         try {

package/dist/m365/util/commands/accesstoken/accesstoken-get.js

@@ -7,6 +7,7 @@ var _UtilAccessTokenGetCommand_instances, _UtilAccessTokenGetCommand_initTelemet
 import auth, { Auth } from '../../../../Auth.js';
 import Command from '../../../../Command.js';
 import commands from '../../commands.js';
+import { accessToken } from '../../../../utils/accessToken.js';
 class UtilAccessTokenGetCommand extends Command {
     get name() {
         return commands.ACCESSTOKEN_GET;
@@ -34,8 +35,14 @@ class UtilAccessTokenGetCommand extends Command {
             resource = Auth.getEndpointForResource('https://graph.microsoft.com', auth.connection.cloudType);
         }
         try {
-            const accessToken = await auth.ensureAccessToken(resource, logger, this.debug, args.options.new);
-            await logger.log(accessToken);
+            const token = await auth.ensureAccessToken(resource, logger, this.debug, args.options.new);
+            if (args.options.decoded) {
+                const { header, payload } = accessToken.getDecodedAccessToken(token);
+                await logger.logRaw(`${JSON.stringify(header, null, 2)}.${JSON.stringify(payload, null, 2)}.[signature]`);
+            }
+            else {
+                await logger.log(token);
+            }
         }
         catch (err) {
             this.handleRejectedODataJsonPromise(err);
@@ -45,7 +52,8 @@ class UtilAccessTokenGetCommand extends Command {
 _UtilAccessTokenGetCommand_instances = new WeakSet(), _UtilAccessTokenGetCommand_initTelemetry = function _UtilAccessTokenGetCommand_initTelemetry() {
     this.telemetry.push((args) => {
         Object.assign(this.telemetryProperties, {
-            new: args.options.new
+            new: args.options.new,
+            decoded: args.options.decoded
         });
     });
 }, _UtilAccessTokenGetCommand_initOptions = function _UtilAccessTokenGetCommand_initOptions() {
@@ -53,6 +61,8 @@ _UtilAccessTokenGetCommand_instances = new WeakSet(), _UtilAccessTokenGetCommand
         option: '-r, --resource <resource>'
     }, {
         option: '--new'
+    }, {
+        option: '--decoded'
     });
 };
 export default new UtilAccessTokenGetCommand();

package/dist/utils/accessToken.js

@@ -75,6 +75,14 @@ export const accessToken = {
         }
         return userId;
     },
+    getDecodedAccessToken(accessToken) {
+        const chunks = accessToken.split('.');
+        const headerString = Buffer.from(chunks[0], 'base64').toString();
+        const payloadString = Buffer.from(chunks[1], 'base64').toString();
+        const header = JSON.parse(headerString);
+        const payload = JSON.parse(payloadString);
+        return { header, payload };
+    },
     /**
      * Asserts the presence of a delegated access token.
      * @throws {CommandError} Will throw an error if the access token is not available.

package/dist/utils/entraApp.js

@@ -3,6 +3,7 @@ import request from '../request.js';
 import { odata } from './odata.js';
 import { formatting } from './formatting.js';
 import { cli } from '../cli/cli.js';
+import { optionsUtils } from './optionsUtils.js';
 async function getCertificateBase64Encoded({ options, logger, debug }) {
     if (options.certificateBase64Encoded) {
         return options.certificateBase64Encoded;
@@ -129,7 +130,7 @@ function updateAppPermissions({ spId, resourceAccessPermission, oAuth2Permission
 }
 export const entraApp = {
     appPermissions: [],
-    createAppRegistration: async ({ options, apis, logger, verbose, debug }) => {
+    createAppRegistration: async ({ options, apis, logger, verbose, debug, unknownOptions }) => {
         const applicationInfo = {
             displayName: options.name,
             signInAudience: options.multitenant ? 'AzureADMultipleOrgs' : 'AzureADMyOrg'
@@ -164,6 +165,7 @@ export const entraApp = {
         if (options.allowPublicClientFlows) {
             applicationInfo.isFallbackPublicClient = true;
         }
+        optionsUtils.addUnknownOptionsToPayload(applicationInfo, unknownOptions);
         if (verbose) {
             await logger.logToStderr(`Creating Microsoft Entra app registration...`);
         }

package/dist/utils/optionsUtils.js

@@ -0,0 +1,28 @@
+const longOptionRegex = /--([^\s]+)/;
+const shortOptionRegex = /-([a-z])\b/;
+export const optionsUtils = {
+    getUnknownOptions(options, knownOptions) {
+        const unknownOptions = JSON.parse(JSON.stringify(options));
+        // remove minimist catch-all option
+        delete unknownOptions._;
+        knownOptions.forEach(o => {
+            const longOptionName = longOptionRegex.exec(o.option)[1];
+            delete unknownOptions[longOptionName];
+            // short names are optional so we need to check if the current command has
+            // one before continuing
+            const shortOptionMatch = shortOptionRegex.exec(o.option);
+            if (shortOptionMatch) {
+                const shortOptionName = shortOptionMatch[1];
+                delete unknownOptions[shortOptionName];
+            }
+        });
+        return unknownOptions;
+    },
+    addUnknownOptionsToPayload(payload, unknownOptions) {
+        const unknownOptionsNames = Object.getOwnPropertyNames(unknownOptions);
+        unknownOptionsNames.forEach(o => {
+            payload[o] = unknownOptions[o];
+        });
+    }
+};
+//# sourceMappingURL=optionsUtils.js.map

package/dist/utils/powerPlatform.js

@@ -51,7 +51,7 @@ export const powerPlatform = {
         }
         if (items.length > 1) {
             const resultAsKeyValuePair = formatting.convertArrayToHashTable('websiteUrl', items);
-            return cli.handleMultipleResultsFound(`Multiple Power Page websites with name '${websiteName}' found`, resultAsKeyValuePair);
+            return cli.handleMultipleResultsFound(`Multiple Power Page websites with name '${websiteName}' found.`, resultAsKeyValuePair);
         }
         return items[0];
     },
@@ -62,6 +62,56 @@ export const powerPlatform = {
             throw Error(`The specified Power Page website with url '${url}' does not exist.`);
         }
         return items[0];
+    },
+    /**
+     * Get a card by name
+     * Returns a card object
+     * @param dynamicsApiUrl The dynamics api url of the environment
+     * @param name The name of the card
+     * @param logger The logger object
+     * @param verbose Set for verbose logging
+     */
+    async getCardByName(dynamicsApiUrl, name) {
+        const requestOptions = {
+            url: `${dynamicsApiUrl}/api/data/v9.1/cards?$filter=name eq '${name}'`,
+            headers: {
+                accept: 'application/json;odata.metadata=none'
+            },
+            responseType: 'json'
+        };
+        const result = await request.get(requestOptions);
+        if (result.value.length === 0) {
+            throw Error(`The specified card '${name}' does not exist.`);
+        }
+        if (result.value.length > 1) {
+            const resultAsKeyValuePair = formatting.convertArrayToHashTable('cardid', result.value);
+            return cli.handleMultipleResultsFound(`Multiple cards with name '${name}' found.`, resultAsKeyValuePair);
+        }
+        return result.value[0];
+    },
+    /**
+   * Get a solution by name
+   * Returns the solution object
+   * @param dynamicsApiUrl The dynamics api url of the environment
+   * @param name The name of the solution
+   */
+    async getSolutionByName(dynamicsApiUrl, name) {
+        const requestOptions = {
+            url: `${dynamicsApiUrl}/api/data/v9.0/solutions?$filter=isvisible eq true and uniquename eq \'${name}\'&$expand=publisherid($select=friendlyname)&$select=solutionid,uniquename,version,publisherid,installedon,solutionpackageversion,friendlyname,versionnumber&api-version=9.1`,
+            headers: {
+                accept: 'application/json;odata.metadata=none'
+            },
+            responseType: 'json'
+        };
+        const result = await request.get(requestOptions);
+        if (result.value.length === 0) {
+            throw Error(`The specified solution '${name}' does not exist.`);
+        }
+        if (result.value.length > 1) {
+            const resultAsKeyValuePair = formatting.convertArrayToHashTable('solutionid', result.value);
+            return cli.handleMultipleResultsFound(`Multiple solutions with name '${name}' found.`, resultAsKeyValuePair);
+        }
+        return result.value[0];
     }
 };
 //# sourceMappingURL=powerPlatform.js.map