@pnp/cli-microsoft365 10.10.0 → 10.11.0-beta.24af61c

package/dist/m365/spo/commands/file/file-version-list.js

@@ -18,7 +18,7 @@ class SpoFileVersionListCommand extends SpoCommand {
         return 'Retrieves all versions of a file';
     }
     defaultProperties() {
-        return ['Created', 'ID', 'IsCurrentVersion', 'VersionLabel'];
+        return ['Created', 'ID', 'IsCurrentVersion', 'VersionLabel', 'ExpirationDate'];
     }
     constructor() {
         super();
@@ -42,7 +42,7 @@ class SpoFileVersionListCommand extends SpoCommand {
             else {
                 requestUrl += `/GetFileById('${args.options.fileId}')`;
             }
-            requestUrl += `/versions`;
+            requestUrl += `/versions?$select=*,ExpirationDate`;
             const response = await odata.getAllItems(requestUrl);
             await logger.log(response);
         }

package/dist/m365/spo/commands/page/Page.js

@@ -72,10 +72,14 @@ export class Page {
         return output;
     }
     static getSectionInformation(section, isJSONOutput) {
-        return {
-            order: section.order,
-            columns: section.columns.map(column => this.getColumnsInformation(column, isJSONOutput))
+        const sectionOutput = {
+            order: section.order
         };
+        if (this.isVerticalSection(section)) {
+            sectionOutput.isVertical = true;
+        }
+        sectionOutput.columns = section.columns.map(column => this.getColumnsInformation(column, isJSONOutput));
+        return sectionOutput;
     }
     /**
      * Publish a modern page in SharePoint Online
@@ -99,5 +103,8 @@ export class Page {
         }
         return pageName;
     }
+    static isVerticalSection(section) {
+        return section.layoutIndex === 2 && section?.controlData?.position?.sectionFactor === 12;
+    }
 }
 //# sourceMappingURL=Page.js.map

package/dist/m365/spo/commands/page/page-section-list.js

@@ -34,10 +34,14 @@ class SpoPageSectionListCommand extends SpoCommand {
                 }
                 else {
                     await logger.log(output.map(s => {
-                        return {
+                        const sectionOutput = {
                             order: s.order,
                             columns: s.columns.length
                         };
+                        if (s.isVertical) {
+                            sectionOutput.isVertical = s.isVertical;
+                        }
+                        return sectionOutput;
                     }));
                 }
             }

package/dist/m365/spo/commands/serviceprincipal/serviceprincipal-permissionrequest-list.js

@@ -45,9 +45,6 @@ class SpoServicePrincipalPermissionRequestListCommand extends SpoCommand {
                         }
                     }
                 }
-                if (spoWebAppServicePrincipalPermissionRequestResult.length === 0) {
-                    spoWebAppServicePrincipalPermissionRequestResult = result;
-                }
                 await logger.log(spoWebAppServicePrincipalPermissionRequestResult.map(r => {
                     return {
                         Id: r.Id.replace('/Guid(', '').replace(')/', ''),
@@ -71,14 +68,23 @@ class SpoServicePrincipalPermissionRequestListCommand extends SpoCommand {
             responseType: 'json'
         };
         const response = await request.get(requestOptions);
-        if (response.value && response.value.length > 0) {
-            return response.value[0].scope.split(' ');
+        if (!response.value || response.value.length === 0) {
+            return null;
         }
-        return null;
+        const scopes = [];
+        response.value.forEach(grant => {
+            if (grant.scope) {
+                grant.scope.split(' ')
+                    .map(permission => permission.trim())
+                    .filter(Boolean)
+                    .forEach(permission => scopes.push(permission));
+            }
+        });
+        return scopes;
     }
     async getSPOClientExtensibilityWebApplicationPrincipalId() {
         const requestOptions = {
-            url: `https://graph.microsoft.com/v1.0/servicePrincipals/?$filter=displayName eq 'SharePoint Online Client Extensibility Web Application Principal'`,
+            url: `https://graph.microsoft.com/v1.0/servicePrincipals/?$filter=displayName eq 'SharePoint Online Web Client Extensibility'`,
             headers: {
                 accept: 'application/json;odata.metadata=none'
             },

package/dist/m365/spo/commands/site/site-appcatalog-list.js

@@ -1,7 +1,15 @@
+import { z } from 'zod';
+import { globalOptionsZod } from '../../../../Command.js';
+import { zod } from '../../../../utils/zod.js';
 import { odata } from '../../../../utils/odata.js';
 import { spo } from '../../../../utils/spo.js';
 import SpoCommand from '../../../base/SpoCommand.js';
 import commands from '../../commands.js';
+const options = globalOptionsZod
+    .extend({
+    excludeDeletedSites: zod.alias('excludeDeletedSites', z.boolean().optional())
+})
+    .strict();
 class SpoSiteAppCatalogListCommand extends SpoCommand {
     get name() {
         return commands.SITE_APPCATALOG_LIST;
@@ -9,16 +17,44 @@ class SpoSiteAppCatalogListCommand extends SpoCommand {
     get description() {
         return 'List all site collection app catalogs within the tenant';
     }
+    get schema() {
+        return options;
+    }
     defaultProperties() {
         return ['AbsoluteUrl', 'SiteID'];
     }
-    async commandAction(logger) {
+    async commandAction(logger, args) {
         try {
             if (this.verbose) {
                 await logger.logToStderr('Retrieving site collection app catalogs...');
             }
             const spoUrl = await spo.getSpoUrl(logger, this.debug);
-            const appCatalogs = await odata.getAllItems(`${spoUrl}/_api/Web/TenantAppCatalog/SiteCollectionAppCatalogsSites`);
+            let appCatalogs = await odata.getAllItems(`${spoUrl}/_api/Web/TenantAppCatalog/SiteCollectionAppCatalogsSites`);
+            if (args.options.excludeDeletedSites) {
+                if (this.verbose) {
+                    await logger.logToStderr('Excluding inaccessible sites from the results...');
+                }
+                const activeAppCatalogs = [];
+                for (const appCatalog of appCatalogs) {
+                    try {
+                        await spo.getWeb(appCatalog.AbsoluteUrl, logger, this.verbose);
+                        activeAppCatalogs.push(appCatalog);
+                    }
+                    catch (error) {
+                        if (this.debug) {
+                            await logger.logToStderr(error);
+                        }
+                        if (error.status === 404 || error.status === 403) {
+                            if (this.verbose) {
+                                await logger.logToStderr(`Site at '${appCatalog.AbsoluteUrl}' is inaccessible. Excluding from results...`);
+                            }
+                            continue;
+                        }
+                        throw error;
+                    }
+                }
+                appCatalogs = activeAppCatalogs;
+            }
             await logger.log(appCatalogs);
         }
         catch (err) {

package/dist/m365/spo/commands/tenant/tenant-site-unarchive.js

@@ -31,7 +31,7 @@ class SpoTenantSiteUnarchiveCommand extends SpoCommand {
             await this.unarchiveSite(logger, args.options.url);
         }
         else {
-            const result = await cli.promptForConfirmation({ message: `Are you sure you want to unarchive site '${args.options.url}'? This may cause additional billing costs.` });
+            const result = await cli.promptForConfirmation({ message: `Are you sure you want to unarchive site '${args.options.url}'? You won't be able to rearchive this site for 120 days.` });
             if (result) {
                 await this.unarchiveSite(logger, args.options.url);
             }

package/dist/m365/teams/commands/callrecord/callrecord-list.js

@@ -0,0 +1,100 @@
+import { globalOptionsZod } from '../../../../Command.js';
+import { z } from 'zod';
+import commands from '../../commands.js';
+import GraphApplicationCommand from '../../../base/GraphApplicationCommand.js';
+import { validation } from '../../../../utils/validation.js';
+import { entraUser } from '../../../../utils/entraUser.js';
+import { odata } from '../../../../utils/odata.js';
+const options = globalOptionsZod
+    .extend({
+    userId: z.string()
+        .refine((val) => validation.isValidGuid(val), {
+        message: 'Invalid GUID.'
+    }).optional(),
+    userName: z.string()
+        .refine((val) => validation.isValidUserPrincipalName(val), {
+        message: 'Invalid user principal name.'
+    }).optional(),
+    startDateTime: z.string()
+        .refine((val) => {
+        if (!validation.isValidISODateTime(val)) {
+            return false;
+        }
+        const date = new Date(val);
+        const maxDate = new Date();
+        const minDate = new Date();
+        minDate.setDate(maxDate.getDate() - 30);
+        return date >= minDate && date <= maxDate;
+    }, {
+        message: 'Date must be a valid ISO date within the last 30 days and not in the future.'
+    }).optional(),
+    endDateTime: z.string()
+        .refine((val) => {
+        if (!validation.isValidISODateTime(val)) {
+            return false;
+        }
+        const date = new Date(val);
+        const maxDate = new Date();
+        const minDate = new Date();
+        minDate.setDate(maxDate.getDate() - 30);
+        return date >= minDate && date <= maxDate;
+    }, {
+        message: 'Date must be a valid ISO date within the last 30 days and not in the future.'
+    }).optional()
+})
+    .strict();
+class TeamsCallRecordListCommand extends GraphApplicationCommand {
+    get name() {
+        return commands.CALLRECORD_LIST;
+    }
+    get description() {
+        return 'Lists all Teams calls within the tenant';
+    }
+    defaultProperties() {
+        return ['id', 'type', 'startDateTime', 'endDateTime'];
+    }
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine((options) => [options.userId, options.userName].filter(o => o !== undefined).length <= 1, {
+            message: 'Use one of the following options: userId or userName but not both.'
+        })
+            .refine((options) => [options.startDateTime, options.endDateTime].filter(o => o !== undefined).length <= 1 || new Date(options.startDateTime) < new Date(options.endDateTime), {
+            message: 'Value of startDateTime, must be before endDateTime.'
+        });
+    }
+    async commandAction(logger, args) {
+        try {
+            if (this.verbose) {
+                await logger.logToStderr(`Retrieving call records...`);
+            }
+            let apiUrl = `${this.resource}/v1.0/communications/callRecords`;
+            const filters = [];
+            if (args.options.userId || args.options.userName) {
+                let userId = args.options.userId;
+                if (args.options.userName) {
+                    userId = await entraUser.getUserIdByUpn(args.options.userName);
+                }
+                filters.push(`participants_v2/any(p:p/id eq '${userId}')`);
+            }
+            if (args.options.startDateTime) {
+                filters.push(`startDateTime ge ${new Date(args.options.startDateTime).toISOString()}`);
+            }
+            if (args.options.endDateTime) {
+                filters.push(`startDateTime lt ${new Date(args.options.endDateTime).toISOString()}`);
+            }
+            if (filters.length > 0) {
+                apiUrl += `?$filter=${filters.join(' and ')}`;
+            }
+            const callRecords = await odata.getAllItems(apiUrl);
+            await logger.log(callRecords);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+}
+export default new TeamsCallRecordListCommand();
+//# sourceMappingURL=callrecord-list.js.map

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

@@ -12,8 +12,8 @@ import commands from '../../commands.js';
 import { chatUtil } from './chatUtil.js';
 import { cli } from '../../../../cli/cli.js';
 import { formatting } from '../../../../utils/formatting.js';
-import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
-class TeamsChatMessageSendCommand extends DelegatedGraphCommand {
+import GraphDelegatedCommand from '../../../base/GraphDelegatedCommand.js';
+class TeamsChatMessageSendCommand extends GraphDelegatedCommand {
     get name() {
         return commands.CHAT_MESSAGE_SEND;
     }

package/dist/m365/teams/commands/message/message-remove.js

@@ -9,9 +9,9 @@ import request from '../../../../request.js';
 import { formatting } from '../../../../utils/formatting.js';
 import { teams } from '../../../../utils/teams.js';
 import { validation } from '../../../../utils/validation.js';
-import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
+import GraphDelegatedCommand from '../../../base/GraphDelegatedCommand.js';
 import commands from '../../commands.js';
-class TeamsMessageRemoveCommand extends DelegatedGraphCommand {
+class TeamsMessageRemoveCommand extends GraphDelegatedCommand {
     get name() {
         return commands.MESSAGE_REMOVE;
     }

package/dist/m365/teams/commands/message/message-restore.js

@@ -7,9 +7,9 @@ var _TeamsMessageRestoreCommand_instances, _TeamsMessageRestoreCommand_initTelem
 import request from '../../../../request.js';
 import { validation } from '../../../../utils/validation.js';
 import commands from '../../commands.js';
-import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
+import GraphDelegatedCommand from '../../../base/GraphDelegatedCommand.js';
 import { teams } from '../../../../utils/teams.js';
-class TeamsMessageRestoreCommand extends DelegatedGraphCommand {
+class TeamsMessageRestoreCommand extends GraphDelegatedCommand {
     get name() {
         return commands.MESSAGE_RESTORE;
     }

package/dist/m365/teams/commands.js

@@ -7,6 +7,7 @@ export default {
     APP_UNINSTALL: `${prefix} app uninstall`,
     APP_UPDATE: `${prefix} app update`,
     CACHE_REMOVE: `${prefix} cache remove`,
+    CALLRECORD_LIST: `${prefix} callrecord list`,
     CHANNEL_ADD: `${prefix} channel add`,
     CHANNEL_GET: `${prefix} channel get`,
     CHANNEL_LIST: `${prefix} channel list`,

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

@@ -5,9 +5,9 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 };
 var _TodoListAddCommand_instances, _TodoListAddCommand_initOptions;
 import request from '../../../../request.js';
-import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
+import GraphDelegatedCommand from '../../../base/GraphDelegatedCommand.js';
 import commands from '../../commands.js';
-class TodoListAddCommand extends DelegatedGraphCommand {
+class TodoListAddCommand extends GraphDelegatedCommand {
     get name() {
         return commands.LIST_ADD;
     }

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

@@ -6,9 +6,9 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 var _TodoListGetCommand_instances, _TodoListGetCommand_initTelemetry, _TodoListGetCommand_initOptions, _TodoListGetCommand_initOptionSets;
 import request from '../../../../request.js';
 import { formatting } from '../../../../utils/formatting.js';
-import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
+import GraphDelegatedCommand from '../../../base/GraphDelegatedCommand.js';
 import commands from '../../commands.js';
-class TodoListGetCommand extends DelegatedGraphCommand {
+class TodoListGetCommand extends GraphDelegatedCommand {
     get name() {
         return commands.LIST_GET;
     }

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

@@ -1,7 +1,7 @@
 import { odata } from '../../../../utils/odata.js';
-import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
+import GraphDelegatedCommand from '../../../base/GraphDelegatedCommand.js';
 import commands from '../../commands.js';
-class TodoListListCommand extends DelegatedGraphCommand {
+class TodoListListCommand extends GraphDelegatedCommand {
     get name() {
         return commands.LIST_LIST;
     }

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

@@ -7,9 +7,9 @@ var _TodoListRemoveCommand_instances, _TodoListRemoveCommand_initTelemetry, _Tod
 import { cli } from '../../../../cli/cli.js';
 import request from '../../../../request.js';
 import { formatting } from '../../../../utils/formatting.js';
-import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
+import GraphDelegatedCommand from '../../../base/GraphDelegatedCommand.js';
 import commands from '../../commands.js';
-class TodoListRemoveCommand extends DelegatedGraphCommand {
+class TodoListRemoveCommand extends GraphDelegatedCommand {
     get name() {
         return commands.LIST_REMOVE;
     }

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

@@ -6,9 +6,9 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 var _TodoListSetCommand_instances, _TodoListSetCommand_initTelemetry, _TodoListSetCommand_initOptions, _TodoListSetCommand_initOptionSets;
 import request from '../../../../request.js';
 import { formatting } from '../../../../utils/formatting.js';
-import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
+import GraphDelegatedCommand from '../../../base/GraphDelegatedCommand.js';
 import commands from '../../commands.js';
-class TodoListSetCommand extends DelegatedGraphCommand {
+class TodoListSetCommand extends GraphDelegatedCommand {
     get name() {
         return commands.LIST_SET;
     }

package/dist/m365/todo/commands/task/task-add.js

@@ -7,9 +7,9 @@ var _TodoTaskAddCommand_instances, _a, _TodoTaskAddCommand_initTelemetry, _TodoT
 import request from '../../../../request.js';
 import { formatting } from '../../../../utils/formatting.js';
 import { validation } from '../../../../utils/validation.js';
-import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
+import GraphDelegatedCommand from '../../../base/GraphDelegatedCommand.js';
 import commands from '../../commands.js';
-class TodoTaskAddCommand extends DelegatedGraphCommand {
+class TodoTaskAddCommand extends GraphDelegatedCommand {
     get name() {
         return commands.TASK_ADD;
     }

package/dist/m365/todo/commands/task/task-get.js

@@ -7,9 +7,9 @@ var _TodoTaskGetCommand_instances, _TodoTaskGetCommand_initTelemetry, _TodoTaskG
 import { cli } from '../../../../cli/cli.js';
 import request from '../../../../request.js';
 import { formatting } from '../../../../utils/formatting.js';
-import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
+import GraphDelegatedCommand from '../../../base/GraphDelegatedCommand.js';
 import commands from '../../commands.js';
-class TodoTaskGetCommand extends DelegatedGraphCommand {
+class TodoTaskGetCommand extends GraphDelegatedCommand {
     get name() {
         return commands.TASK_GET;
     }

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

@@ -8,9 +8,9 @@ import { cli } from '../../../../cli/cli.js';
 import request from '../../../../request.js';
 import { formatting } from '../../../../utils/formatting.js';
 import { odata } from '../../../../utils/odata.js';
-import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
+import GraphDelegatedCommand from '../../../base/GraphDelegatedCommand.js';
 import commands from '../../commands.js';
-class TodoTaskListCommand extends DelegatedGraphCommand {
+class TodoTaskListCommand extends GraphDelegatedCommand {
     get name() {
         return commands.TASK_LIST;
     }

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

@@ -7,9 +7,9 @@ var _TodoTaskRemoveCommand_instances, _TodoTaskRemoveCommand_initTelemetry, _Tod
 import { cli } from '../../../../cli/cli.js';
 import request from '../../../../request.js';
 import { formatting } from '../../../../utils/formatting.js';
-import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
+import GraphDelegatedCommand from '../../../base/GraphDelegatedCommand.js';
 import commands from '../../commands.js';
-class TodoTaskRemoveCommand extends DelegatedGraphCommand {
+class TodoTaskRemoveCommand extends GraphDelegatedCommand {
     get name() {
         return commands.TASK_REMOVE;
     }

package/dist/m365/todo/commands/task/task-set.js

@@ -7,9 +7,9 @@ var _TodoTaskSetCommand_instances, _TodoTaskSetCommand_initTelemetry, _TodoTaskS
 import request from '../../../../request.js';
 import { formatting } from '../../../../utils/formatting.js';
 import { validation } from '../../../../utils/validation.js';
-import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
+import GraphDelegatedCommand from '../../../base/GraphDelegatedCommand.js';
 import commands from '../../commands.js';
-class TodoTaskSetCommand extends DelegatedGraphCommand {
+class TodoTaskSetCommand extends GraphDelegatedCommand {
     get name() {
         return commands.TASK_SET;
     }

package/dist/m365/viva/commands/engage/EngageRole.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=EngageRole.js.map

package/dist/m365/viva/commands/engage/engage-role-list.js

@@ -0,0 +1,28 @@
+import { odata } from '../../../../utils/odata.js';
+import GraphCommand from '../../../base/GraphCommand.js';
+import commands from '../../commands.js';
+class VivaEngageRoleListCommand extends GraphCommand {
+    get name() {
+        return commands.ENGAGE_ROLE_LIST;
+    }
+    get description() {
+        return 'Lists all Viva Engage roles';
+    }
+    defaultProperties() {
+        return ['id', 'displayName'];
+    }
+    async commandAction(logger) {
+        if (this.verbose) {
+            await logger.logToStderr('Getting all Viva Engage roles...');
+        }
+        try {
+            const results = await odata.getAllItems(`${this.resource}/beta/employeeExperience/roles`);
+            await logger.log(results);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+}
+export default new VivaEngageRoleListCommand();
+//# sourceMappingURL=engage-role-list.js.map

package/dist/m365/viva/commands/engage/engage-role-member-list.js

@@ -0,0 +1,57 @@
+import { z } from 'zod';
+import { globalOptionsZod } from '../../../../Command.js';
+import { zod } from '../../../../utils/zod.js';
+import { odata } from '../../../../utils/odata.js';
+import GraphCommand from '../../../base/GraphCommand.js';
+import commands from '../../commands.js';
+import { validation } from '../../../../utils/validation.js';
+import { vivaEngage } from '../../../../utils/vivaEngage.js';
+const options = globalOptionsZod
+    .extend({
+    roleId: zod.alias('i', z.string().refine(name => validation.isValidGuid(name), name => ({
+        message: `'${name}' is not a valid GUID.`
+    })).optional()),
+    roleName: zod.alias('n', z.string().optional())
+})
+    .strict();
+class VivaEngageRoleMemberListCommand extends GraphCommand {
+    get name() {
+        return commands.ENGAGE_ROLE_MEMBER_LIST;
+    }
+    get description() {
+        return 'Lists all users assigned to a Viva Engage role';
+    }
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(options => [options.roleId, options.roleName].filter(x => x !== undefined).length === 1, {
+            message: 'Specify either roleId, or roleName, but not both.'
+        });
+    }
+    defaultProperties() {
+        return ['id', 'userId'];
+    }
+    async commandAction(logger, args) {
+        let roleId = args.options.roleId;
+        try {
+            if (args.options.roleName) {
+                if (this.verbose) {
+                    await logger.logToStderr(`Retrieving Viva Engage role ID for role name '${args.options.roleName}'...`);
+                }
+                roleId = await vivaEngage.getRoleIdByName(args.options.roleName);
+            }
+            if (this.verbose) {
+                await logger.logToStderr(`Getting all users assigned to a Viva Engage role ${roleId}...`);
+            }
+            const results = await odata.getAllItems(`${this.resource}/beta/employeeExperience/roles/${roleId}/members`);
+            await logger.log(results);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+}
+export default new VivaEngageRoleMemberListCommand();
+//# sourceMappingURL=engage-role-member-list.js.map

package/dist/m365/viva/commands.js

@@ -27,6 +27,8 @@ export default {
     ENGAGE_REPORT_GROUPSACTIVITYCOUNTS: `${prefix} engage report groupsactivitycounts`,
     ENGAGE_REPORT_GROUPSACTIVITYDETAIL: `${prefix} engage report groupsactivitydetail`,
     ENGAGE_REPORT_GROUPSACTIVITYGROUPCOUNTS: `${prefix} engage report groupsactivitygroupcounts`,
+    ENGAGE_ROLE_LIST: `${prefix} engage role list`,
+    ENGAGE_ROLE_MEMBER_LIST: `${prefix} engage role member list`,
     ENGAGE_SEARCH: `${prefix} engage search`,
     ENGAGE_USER_GET: `${prefix} engage user get`,
     ENGAGE_USER_LIST: `${prefix} engage user list`

package/dist/utils/accessToken.js

@@ -84,17 +84,21 @@ export const accessToken = {
         return { header, payload };
     },
     /**
-     * Asserts the presence of a delegated access token.
+     * Asserts the presence of a delegated or application-only access token.
      * @throws {CommandError} Will throw an error if the access token is not available.
-     * @throws {CommandError} Will throw an error if the access token is an application-only access token.
+     * @throws {CommandError} Will throw an error if the access token type is not correct.
      */
-    assertDelegatedAccessToken() {
+    assertAccessTokenType(type) {
         const accessToken = auth?.connection?.accessTokens?.[auth.defaultResource]?.accessToken;
         if (!accessToken) {
             throw new CommandError('No access token found.');
         }
-        if (this.isAppOnlyAccessToken(accessToken)) {
-            throw new CommandError('This command does not support application-only permissions.');
+        const isAppAccessToken = this.isAppOnlyAccessToken(accessToken);
+        if (type === 'delegated' && isAppAccessToken) {
+            throw new CommandError('This command requires delegated permissions.');
+        }
+        if (type === 'application' && !isAppAccessToken) {
+            throw new CommandError('This command requires application-only permissions.');
         }
     }
 };

package/dist/utils/entraApp.js

@@ -308,6 +308,21 @@ export const entraApp = {
             return await cli.handleMultipleResultsFound(`Multiple apps with name '${appName}' found in Microsoft Entra ID.`, resultAsKeyValuePair);
         }
         return apps[0];
+    },
+    async getAppRegistrationByObjectId(objectId, properties) {
+        let url = `https://graph.microsoft.com/v1.0/applications/${objectId}`;
+        if (properties) {
+            url += `?$select=${properties.join(',')}`;
+        }
+        const requestOptions = {
+            url: url,
+            headers: {
+                accept: 'application/json;odata.metadata=none'
+            },
+            responseType: 'json'
+        };
+        const app = await request.get(requestOptions);
+        return app;
     }
 };
 //# sourceMappingURL=entraApp.js.map