@pnp/cli-microsoft365 11.6.0 → 11.7.0-beta.293104a

package/dist/m365/outlook/commands.js

@@ -1,6 +1,12 @@
 const prefix = 'outlook';
 export default {
+    CALENDAR_ADD: `${prefix} calendar add`,
+    CALENDAR_GET: `${prefix} calendar get`,
+    CALENDAR_REMOVE: `${prefix} calendar remove`,
     CALENDARGROUP_LIST: `${prefix} calendargroup list`,
+    EVENT_CANCEL: `${prefix} event cancel`,
+    EVENT_LIST: `${prefix} event list`,
+    EVENT_REMOVE: `${prefix} event remove`,
     MAIL_SEARCHFOLDER_ADD: `${prefix} mail searchfolder add`,
     MAIL_SEND: `${prefix} mail send`,
     MAILBOX_SETTINGS_GET: `${prefix} mailbox settings get`,

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/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-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/outlook/calendar/calendar-add.mdx

@@ -0,0 +1,165 @@
+import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# outlook calendar add
+
+Creates a new calendar for a user
+
+## Usage
+
+```sh
+m365 outlook calendar add [options]
+```
+
+## Options
+
+```md definition-list
+`--userId [userId]`
+: ID of the user. Specify either `userId` or `userName`, but not both.
+
+`--userName [userName]`
+: UPN of the user. Specify either `userId` or `userName`, but not both.
+
+`--name <name>`
+: Name of the calendar.
+
+`--calendarGroupId [calendarGroupId]`
+: Id of the group where the calendar will belong. Specify either `calendarGroupId` or `calendarGroupName`, but not both.
+
+`--calendarGroupName [calendarGroupName]`
+: Name of the group where the calendar will belong. Specify either `calendarGroupId` or `calendarGroupName`, but not both.
+
+`--color [color]`
+: The color of the calendar in UI. Allowed values are `auto`, `lightBlue`, `lightGreen`, `lightOrange`, `lightGray`, `lightYellow`, `lightTeal`, `lightPink`, `lightBrown`, `lightRed`, `maxColor`. Defaults to `auto`.
+
+`--defaultOnlineMeetingProvider [defaultOnlineMeetingProvider]`
+: The default online meeting provider for meetings sent from the calendar. Allowed values are `none`, `teamsForBusiness`. Defaults to `teamsForBusiness`.
+
+`--default`
+: Specify whether the calendar will be the default calendar for new events.
+```
+
+<Global />
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions         |
+  |-----------------|---------------------|
+  | Microsoft Graph | Calendars.ReadWrite |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions         |
+  |-----------------|---------------------|
+  | Microsoft Graph | Calendars.ReadWrite |
+
+  </TabItem>
+</Tabs>
+
+## Examples
+
+Create a new calendar for a user in a default calendar's group
+
+```sh
+m365 outlook calendar add --userId '@meId' --name 'Holidays'
+```
+
+Create a new calendar for a user specified by email in a specific calendar group and defined color
+
+```sh
+m365 outlook calendar add --userName 'john.doe@contoso.com' --name 'Interviews' --calendarGroupId 'AAMkADY1YmE3N2FhLWEwMz' --color 'lightBlue'
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "AQMkAGRlMCQAAAA==",
+    "name": "My Calendars",
+    "color": "auto",
+    "hexColor": "",
+    "groupClassId": "0006f0b7-0000-0000-c000-000000000046",
+    "isDefaultCalendar": false,
+    "changeKey": "fJKVL07sbkmIfHqjbDnRgQACxSYYpw==",
+    "canShare": true,
+    "canViewPrivateItems": true,
+    "canEdit": true,
+    "allowedOnlineMeetingProviders": [
+      "teamsForBusiness"
+    ],
+    "defaultOnlineMeetingProvider": "teamsForBusiness",
+    "isTallyingResponses": false,
+    "isRemovable": true,
+    "owner": {
+      "name": "John Doe",
+      "address": "john.doe@contoso.com"
+    }
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  allowedOnlineMeetingProviders: ["teamsForBusiness"]
+  canEdit                      : true
+  canShare                     : true
+  canViewPrivateItems          : true
+  changeKey                    : fJKVL07sbkmIfHqjbDnRgQACxSYYug==
+  color                        : auto
+  defaultOnlineMeetingProvider : teamsForBusiness
+  groupClassId                 : 0006f0b7-0000-0000-c000-000000000046
+  hexColor                     :
+  id                           : AQMkAGRlMCQAAAA==
+  isDefaultCalendar            : false
+  isRemovable                  : true
+  isTallyingResponses          : false
+  name                         : My Calendars
+  owner                        : {"name":"John Doe","address":"john.doe@contoso.com"}
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,name,color,hexColor,groupClassId,isDefaultCalendar,changeKey,canShare,canViewPrivateItems,canEdit,defaultOnlineMeetingProvider,isTallyingResponses,isRemovable
+  AQMkAGRlMCQAAAA==,My Calendars,auto,,0006f0b7-0000-0000-c000-000000000046,0,fJKVL07sbkmIfHqjbDnRgQACxSYYzQ==,1,1,1,teamsForBusiness,0,1
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # outlook calendar add --userId "893f9116-e024-4bc6-8e98-54c245129485" --name "My Calendars"
+
+  Date: 2/5/2026
+
+  ## My Calendars (AQMkAGRlMCQAAAA==)
+
+  Property | Value
+  ---------|-------
+  id | AQMkAGRlMCQAAAA==
+  name | My Calendars
+  color | auto
+  hexColor |
+  groupClassId | 0006f0b7-0000-0000-c000-000000000046
+  isDefaultCalendar | false
+  changeKey | fJKVL07sbkmIfHqjbDnRgQACxSYY4A==
+  canShare | true
+  canViewPrivateItems | true
+  canEdit | true
+  defaultOnlineMeetingProvider | teamsForBusiness
+  isTallyingResponses | false
+  isRemovable | true
+  ```
+
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/outlook/calendar/calendar-get.mdx

@@ -0,0 +1,165 @@
+import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# outlook calendar get
+
+Retrieves the calendar of a user or a group.
+
+## Usage
+
+```sh
+m365 outlook calendar get [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --id [id]`
+: ID of the calendar. Specify either `id` or `name`, but not both.
+
+`-n, --name [name]`
+: Name of the calendar. Specify either `id` or `name`, but not both.
+
+`--userId [userId]`
+: ID of the user. Specify either `userId` or `userName`, but not both.
+
+`--userName [userName]`
+: UPN of the user. Specify either `userId` or `userName`, but not both.
+
+`--calendarGroupId [calendarGroupId]`
+: ID of the calendar group. Specify either `calendarGroupId` or `calendarGroupName`, but not both.
+
+`--calendarGroupName [calendarGroupName]`
+: Name of the calendar group. Specify either `calendarGroupId` or `calendarGroupName`, but not both.
+```
+
+<Global />
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions        |
+  |-----------------|--------------------|
+  | Microsoft Graph | Calendar.ReadBasic |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions        |
+  |-----------------|--------------------|
+  | Microsoft Graph | Calendar.ReadBasic |
+
+  </TabItem>
+</Tabs>
+
+## Examples
+
+Get the calendar for the current signed-in user by id.
+
+```sh
+m365 outlook calendar get --userId "@meId" --id "AAMkAGI2TGuLAAA=" 
+```
+
+Get the calendar from a specific calendar group for the current signed-in user by name.
+
+```sh
+m365 outlook calendar get --userId "@meId" --calendarGroupName "Colleague calendars" --name "Calendar" 
+```
+
+Get the calendar from a specific calendar group for a specific user by name.
+
+```sh
+m365 outlook calendar get --userId b743445a-112c-4fda-9afd-05943f9c7b36 --calendarGroupId "AAMkADIxYjJiYmIzLTFmNjYtNGNhMy0YOkcEEh3vhfAAAGgdFjAAA="  --name "Calendar" 
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "AQMkAGRAAAA==",
+    "name": "Calendar",
+    "color": "lightOrange",
+    "hexColor": "#f7630c",
+    "groupClassId": "0006f0b7-0000-0000-c000-000000000046",
+    "isDefaultCalendar": true,
+    "changeKey": "fJKVL07sbkmIfHqjbDnRgQAACWzbtQ==",
+    "canShare": true,
+    "canViewPrivateItems": true,
+    "canEdit": true,
+    "allowedOnlineMeetingProviders": [
+      "teamsForBusiness"
+    ],
+    "defaultOnlineMeetingProvider": "teamsForBusiness",
+    "isTallyingResponses": true,
+    "isRemovable": false,
+    "owner": {
+      "name": "John Doe",
+      "address": "john.doe@contoso.com"
+    }
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  allowedOnlineMeetingProviders: ["teamsForBusiness"]
+  canEdit                      : true
+  canShare                     : true
+  canViewPrivateItems          : true
+  changeKey                    : fJKVL07sbkmIfHqjbDnRgQAACWzbtQ==
+  color                        : lightOrange
+  defaultOnlineMeetingProvider : teamsForBusiness
+  groupClassId                 : 0006f0b7-0000-0000-c000-000000000046
+  hexColor                     : #f7630c
+  id                           : AQMkAGRAAAA==
+  isDefaultCalendar            : true
+  isRemovable                  : false
+  isTallyingResponses          : true
+  name                         : Calendar
+  owner                        : {"name":"John Doe","address":"john.doe@contoso.com"}
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,name,color,hexColor,groupClassId,isDefaultCalendar,changeKey,canShare,canViewPrivateItems,canEdit,defaultOnlineMeetingProvider,isTallyingResponses,isRemovable
+  AQMkAGRAAAA==,Calendar,lightOrange,#f7630c,0006f0b7-0000-0000-c000-000000000046,1,fJKVL07sbkmIfHqjbDnRgQAACWzbtQ==,1,1,1,teamsForBusiness,1,0
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # outlook calendar get --name "Calendar" --userName "john.doe@contoso.com"
+
+  Date: 2/9/2026
+
+  ## Calendar (AQMkAGRAAAA==)
+
+  Property | Value
+  ---------|-------
+  id | AQMkAGRAAAA==
+  name | Calendar
+  color | lightOrange
+  hexColor | #f7630c
+  groupClassId | 0006f0b7-0000-0000-c000-000000000046
+  isDefaultCalendar | true
+  changeKey | fJKVL07sbkmIfHqjbDnRgQAACWzbtQ==
+  canShare | true
+  canViewPrivateItems | true
+  canEdit | true
+  defaultOnlineMeetingProvider | teamsForBusiness
+  isTallyingResponses | true
+  isRemovable | false
+  ```
+
+  </TabItem>
+</Tabs>