@pnp/cli-microsoft365 11.7.0-beta.b67a258 → 11.7.0-beta.bd906c5

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

@@ -11,9 +11,24 @@ export const options = z.strictObject({
         error: e => `'${e.input}' is not a valid value for option chatId.`
     })
         .alias('i'),
+    createdEndDateTime: z.string()
+        .refine(time => validation.isValidISODateTime(time), {
+        error: e => `'${e.input}' is not a valid ISO date-time string for option createdEndDateTime.`
+    })
+        .optional(),
     endDateTime: z.string()
         .refine(time => validation.isValidISODateTime(time), {
         error: e => `'${e.input}' is not a valid ISO date-time string for option endDateTime.`
+    })
+        .optional(),
+    modifiedStartDateTime: z.string()
+        .refine(time => validation.isValidISODateTime(time), {
+        error: e => `'${e.input}' is not a valid ISO date-time string for option modifiedStartDateTime.`
+    })
+        .optional(),
+    modifiedEndDateTime: z.string()
+        .refine(time => validation.isValidISODateTime(time), {
+        error: e => `'${e.input}' is not a valid ISO date-time string for option modifiedEndDateTime.`
     })
         .optional()
 });
@@ -30,13 +45,37 @@ class TeamsChatMessageListCommand extends GraphCommand {
     get schema() {
         return options;
     }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(options => !(options.endDateTime && options.createdEndDateTime), {
+            error: 'Specify either endDateTime or createdEndDateTime, but not both.'
+        })
+            .refine(options => !(options.createdEndDateTime && (options.modifiedStartDateTime || options.modifiedEndDateTime)), {
+            error: 'You cannot combine createdEndDateTime with modifiedStartDateTime or modifiedEndDateTime. These filters operate on different properties.'
+        })
+            .refine(options => !(options.endDateTime && (options.modifiedStartDateTime || options.modifiedEndDateTime)), {
+            error: 'You cannot combine endDateTime with modifiedStartDateTime or modifiedEndDateTime. These filters operate on different properties.'
+        });
+    }
     async commandAction(logger, args) {
+        if (args.options.endDateTime) {
+            await this.warn(logger, `Option 'endDateTime' is deprecated. Please use 'createdEndDateTime' instead.`);
+            args.options.createdEndDateTime = args.options.endDateTime;
+        }
         try {
             let apiUrl = `${this.resource}/v1.0/chats/${args.options.chatId}/messages`;
-            if (args.options.endDateTime) {
-                // You can only filter results if the request URL contains the $orderby and $filter query parameters configured for the same property;
-                // otherwise, the $filter query option is ignored.
-                apiUrl += `?$filter=createdDateTime lt ${args.options.endDateTime}&$orderby=createdDateTime desc`;
+            if (args.options.createdEndDateTime) {
+                apiUrl += `?$filter=createdDateTime lt ${args.options.createdEndDateTime}&$orderby=createdDateTime desc`;
+            }
+            else if (args.options.modifiedStartDateTime || args.options.modifiedEndDateTime) {
+                const filters = [];
+                if (args.options.modifiedStartDateTime) {
+                    filters.push(`lastModifiedDateTime gt ${args.options.modifiedStartDateTime}`);
+                }
+                if (args.options.modifiedEndDateTime) {
+                    filters.push(`lastModifiedDateTime lt ${args.options.modifiedEndDateTime}`);
+                }
+                apiUrl += `?$filter=${filters.join(' and ')}&$orderby=lastModifiedDateTime desc`;
             }
             const items = await odata.getAllItems(apiUrl);
             if (args.options.output && args.options.output !== 'json') {

package/dist/utils/calendar.js

@@ -0,0 +1,37 @@
+import { odata } from './odata.js';
+import { formatting } from './formatting.js';
+import { cli } from '../cli/cli.js';
+import request from '../request.js';
+export const calendar = {
+    async getUserCalendarById(userId, calendarId, calendarGroupId, properties) {
+        let url = `https://graph.microsoft.com/v1.0/users('${userId}')/${calendarGroupId ? `calendarGroups/${calendarGroupId}/` : ''}calendars/${calendarId}`;
+        if (properties) {
+            url += `?$select=${properties}`;
+        }
+        const requestOptions = {
+            url: url,
+            headers: {
+                accept: 'application/json;odata.metadata=none'
+            },
+            responseType: 'json'
+        };
+        return await request.get(requestOptions);
+    },
+    async getUserCalendarByName(userId, name, calendarGroupId, properties) {
+        let url = `https://graph.microsoft.com/v1.0/users('${userId}')/${calendarGroupId ? `calendarGroups/${calendarGroupId}/` : ''}calendars?$filter=name eq '${formatting.encodeQueryParameter(name)}'`;
+        if (properties) {
+            url += `&$select=${properties}`;
+        }
+        const calendars = await odata.getAllItems(url);
+        if (calendars.length === 0) {
+            throw new Error(`The specified calendar '${name}' does not exist.`);
+        }
+        if (calendars.length > 1) {
+            const resultAsKeyValuePair = formatting.convertArrayToHashTable('id', calendars);
+            const selectedCalendar = await cli.handleMultipleResultsFound(`Multiple calendars with name '${name}' found.`, resultAsKeyValuePair);
+            return selectedCalendar;
+        }
+        return calendars[0];
+    }
+};
+//# sourceMappingURL=calendar.js.map

package/dist/utils/calendarGroup.js

@@ -0,0 +1,22 @@
+import { odata } from './odata.js';
+import { formatting } from './formatting.js';
+import { cli } from '../cli/cli.js';
+export const calendarGroup = {
+    async getUserCalendarGroupByName(userId, displayName, properties) {
+        let url = `https://graph.microsoft.com/v1.0/users('${userId}')/calendarGroups?$filter=name eq '${formatting.encodeQueryParameter(displayName)}'`;
+        if (properties) {
+            url += `&$select=${properties}`;
+        }
+        const calendarGroups = await odata.getAllItems(url);
+        if (calendarGroups.length === 0) {
+            throw new Error(`The specified calendar group '${displayName}' does not exist.`);
+        }
+        if (calendarGroups.length > 1) {
+            const resultAsKeyValuePair = formatting.convertArrayToHashTable('id', calendarGroups);
+            const selectedCalendarGroup = await cli.handleMultipleResultsFound(`Multiple calendar groups with name '${displayName}' found.`, resultAsKeyValuePair);
+            return selectedCalendarGroup;
+        }
+        return calendarGroups[0];
+    }
+};
+//# sourceMappingURL=calendarGroup.js.map

package/dist/utils/entraApp.js

@@ -336,8 +336,15 @@ export const entraApp = {
             },
             responseType: 'json'
         };
-        const app = await request.get(requestOptions);
-        return app;
+        try {
+            return await request.get(requestOptions);
+        }
+        catch (error) {
+            if (error?.response?.status === 404) {
+                throw Error(`App with objectId '${objectId}' not found in Microsoft Entra ID.`);
+            }
+            throw error;
+        }
     }
 };
 //# sourceMappingURL=entraApp.js.map

package/dist/utils/spfx.js

@@ -1,3 +1,4 @@
+import { Range, coerce, gt, validRange } from 'semver';
 export const spfx = {
     isReactProject(project) {
         return (typeof project.yoRcJson !== 'undefined' &&
@@ -11,6 +12,64 @@ export const spfx = {
             typeof project.yoRcJson['@microsoft/generator-sharepoint'] !== 'undefined' &&
             project.yoRcJson["@microsoft/generator-sharepoint"].framework === 'knockout') ||
             typeof project.packageJson?.dependencies?.['knockout'] !== 'undefined';
+    },
+    getHighestNodeVersion(versionRange) {
+        if (!versionRange) {
+            throw new Error('Node version range was not provided.');
+        }
+        const ranges = versionRange
+            .split('||')
+            .map(range => range.trim())
+            .filter(range => range.length > 0);
+        let highestMajor = null;
+        let exactVersion = null;
+        const simpleVersionPattern = /^\d+(\.\d+(\.\d+)?)?$/;
+        if (ranges.every(r => simpleVersionPattern.test(r))) {
+            const highest = ranges.reduce((best, curr) => gt(coerce(curr), coerce(best)) ? curr : best);
+            const parts = highest.split('.');
+            if (parts.length >= 3) {
+                return highest;
+            }
+            if (parts.length === 2) {
+                return `${highest}.x`;
+            }
+        }
+        for (const rangeString of ranges) {
+            const normalized = validRange(rangeString);
+            if (!normalized) {
+                continue;
+            }
+            const rangeObj = new Range(normalized);
+            let maxMajor = 0;
+            // Analyze the range to find the maximum major version
+            for (const comparatorSet of rangeObj.set) {
+                for (const comparator of comparatorSet) {
+                    if (comparator.operator === '<') {
+                        // Exclusive upper bound: <17.0.0 means max major is 16
+                        maxMajor = Math.max(maxMajor, comparator.semver.major - 1);
+                    }
+                    else if (comparator.operator === '<=') {
+                        // Inclusive upper bound: <=17.0.0 means we can use exactly that version
+                        maxMajor = Math.max(maxMajor, comparator.semver.major);
+                        // Store the exact version for <= comparator
+                        if (highestMajor === null || comparator.semver.major > highestMajor) {
+                            exactVersion = comparator.semver.version;
+                        }
+                    }
+                    else if (comparator.operator === '>=' || comparator.operator === '>') {
+                        // For lower bounds use the major version
+                        maxMajor = Math.max(maxMajor, comparator.semver.major);
+                    }
+                }
+            }
+            // Track the highest major version across all ranges
+            highestMajor = Math.max(highestMajor ?? 0, maxMajor);
+        }
+        if (highestMajor === null) {
+            throw new Error(`Unable to resolve the highest Node version for range '${versionRange}'.`);
+        }
+        // Return exact version if we have a <= comparator, otherwise use .x
+        return exactVersion || `${highestMajor}.x`;
     }
 };
 //# sourceMappingURL=spfx.js.map

package/docs/docs/cmd/entra/license/license-list.mdx

@@ -16,6 +16,25 @@ m365 entra license list [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                |
+  |-----------------|----------------------------|
+  | Microsoft Graph | LicenseAssignment.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                |
+  |-----------------|----------------------------|
+  | Microsoft Graph | LicenseAssignment.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 List all licenses within the tenant.

package/docs/docs/cmd/entra/m365group/m365group-conversation-list.mdx

@@ -24,6 +24,25 @@ m365 entra m365group conversation list [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                 |
+  |-----------------|-----------------------------|
+  | Microsoft Graph | Group-Conversation.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                 |
+  |-----------------|-----------------------------|
+  | Microsoft Graph | Group-Conversation.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Lists conversations for the Microsoft 365 group specified by id.

package/docs/docs/cmd/entra/m365group/m365group-conversation-post-list.mdx

@@ -27,6 +27,25 @@ m365 entra m365group conversation post list [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                 |
+  |-----------------|-----------------------------|
+  | Microsoft Graph | Group-Conversation.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                 |
+  |-----------------|-----------------------------|
+  | Microsoft Graph | Group-Conversation.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Lists the posts of the specific conversation of Microsoft 365 group by groupId

package/docs/docs/cmd/entra/user/user-groupmembership-list.mdx

@@ -30,6 +30,25 @@ m365 entra user groupmembership list [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                              |
+  |-----------------|------------------------------------------|
+  | Microsoft Graph | User.ReadBasic.All, GroupMember.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                              |
+  |-----------------|------------------------------------------|
+  | Microsoft Graph | User.ReadBasic.All, GroupMember.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Retrieves groups that the user is a member of

package/docs/docs/cmd/entra/user/user-guest-add.mdx

@@ -39,6 +39,25 @@ m365 entra user guest add [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions     |
+  |-----------------|-----------------|
+  | Microsoft Graph | User.Invite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions     |
+  |-----------------|-----------------|
+  | Microsoft Graph | User.Invite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Invite a user via email and set the display name.

package/docs/docs/cmd/entra/user/user-license-add.mdx

@@ -35,6 +35,25 @@ The user must have a `usageLocation` value in order to assign a license to it.
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                     |
+  |-----------------|---------------------------------|
+  | Microsoft Graph | LicenseAssignment.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                     |
+  |-----------------|---------------------------------|
+  | Microsoft Graph | LicenseAssignment.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Assign specific licenses to a specific user by UPN.

package/docs/docs/cmd/entra/user/user-license-list.mdx

@@ -28,10 +28,27 @@ m365 entra user license list [options]
 
 :::tip
 
-If you don't specify any option, the command will list the license details of the current logged in user. This does not work when using application permissions.
+If you don't specify any option, the command will list the license details of the current logged in user.
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                |
+  |-----------------|----------------------------|
+  | Microsoft Graph | LicenseAssignment.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  This command does not support application permissions.
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 List license details of the current logged in user.

package/docs/docs/cmd/entra/user/user-license-remove.mdx

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # entra user license remove
 
@@ -28,6 +30,25 @@ m365 entra user license remove [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                     |
+  |-----------------|---------------------------------|
+  | Microsoft Graph | LicenseAssignment.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                     |
+  |-----------------|---------------------------------|
+  | Microsoft Graph | LicenseAssignment.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Remove specific licenses from a specific user by UPN.

package/docs/docs/cmd/entra/user/user-password-validate.mdx

@@ -29,6 +29,18 @@ This command is based on an API that is currently in preview and is subject to c
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions    |
+  |-----------------|----------------|
+  | Microsoft Graph | User.ReadWrite |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Validate password _cli365P@ssW0rd_ against the organization's password validation policy.

package/docs/docs/cmd/entra/user/user-recyclebinitem-clear.mdx

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # entra user recyclebinitem clear
 
@@ -33,6 +35,25 @@ After running this command, it may take a minute before all deleted users are ef
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions            |
+  |-----------------|------------------------|
+  | Microsoft Graph | User.DeleteRestore.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions            |
+  |-----------------|------------------------|
+  | Microsoft Graph | User.DeleteRestore.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Removes all users from the tenant recycle bin.

package/docs/docs/cmd/entra/user/user-recyclebinitem-list.mdx

@@ -16,6 +16,25 @@ m365 entra user recyclebinitem list [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions   |
+  |-----------------|---------------|
+  | Microsoft Graph | User.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions   |
+  |-----------------|---------------|
+  | Microsoft Graph | User.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 List all removed users.

package/docs/docs/cmd/entra/user/user-recyclebinitem-remove.mdx

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # entra user recyclebinitem remove
 
@@ -36,6 +38,25 @@ After running this command, it may take a minute before the deleted user is effe
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions            |
+  |-----------------|------------------------|
+  | Microsoft Graph | User.DeleteRestore.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions            |
+  |-----------------|------------------------|
+  | Microsoft Graph | User.DeleteRestore.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Removes a specific user from the recycle bin.

package/docs/docs/cmd/entra/user/user-recyclebinitem-restore.mdx

@@ -35,6 +35,25 @@ After running this command, it may take a minute before the user will reappear i
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions            |
+  |-----------------|------------------------|
+  | Microsoft Graph | User.DeleteRestore.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions            |
+  |-----------------|------------------------|
+  | Microsoft Graph | User.DeleteRestore.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Restore user from the recycle bin.

package/docs/docs/cmd/entra/user/user-registrationdetails-list.mdx

@@ -77,6 +77,25 @@ When multiple values are specified for `--registeredMethods` option, the command
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions       |
+  |-----------------|-------------------|
+  | Microsoft Graph | AuditLog.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions       |
+  |-----------------|-------------------|
+  | Microsoft Graph | AuditLog.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Retrieve registration details for all users.

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

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # entra user session revoke
 
@@ -40,6 +42,25 @@ This API doesn't revoke sign-in sessions for external users, because external us
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions             |
+  |-----------------|-------------------------|
+  | Microsoft Graph | User.RevokeSessions.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions             |
+  |-----------------|-------------------------|
+  | Microsoft Graph | User.RevokeSessions.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Revoke sign-in sessions of a user specified by id

package/docs/docs/cmd/entra/user/user-signin-list.mdx

@@ -30,6 +30,25 @@ m365 entra user signin list [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions       |
+  |-----------------|-------------------|
+  | Microsoft Graph | AuditLog.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions       |
+  |-----------------|-------------------|
+  | Microsoft Graph | AuditLog.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get all user's sign-ins in your tenant.