New command: `outlook calendar list`

[milanholemans]

Usage

m365 outlook calendar list [options]

Description

Retrieves a list of all calendars of a user.

Options

Option	Description
--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.

Examples

List all calendars for the current signed-in user.

m365 outlook calendar list --userId "@meId"

List all calendars in a specific calendar group for the current signed-in user.

m365 outlook calendar list --userId "@meId" --calendarGroupName "Colleague calendars"

List all calendars for a specific user.

m365 outlook calendar list --userName "john.doe@contoso.com"

List all calendars from a specific calendar group for a specific user.

m365 outlook calendar list --userId b743445a-112c-4fda-9afd-05943f9c7b36 --calendarGroupId "AAMkADIxYjJiYmIzLTFmNjYtNGNhMy0YOkcEEh3vhfAAAGgdFjAAA="

Default properties

• id
• name

Additional Info

• Is it possible to list calendar groups of someone else while using delegated permissions? If not, we should make sure the user cannot pass any user-related options.

API: https://learn.microsoft.com/en-us/graph/api/user-list-calendars?view=graph-rest-1.0&tabs=http

Make sure to take this comment into account: #7075 (comment)

[MartinM85]

Looks good to me, only to clarify the first example.

To list all calendars we will have to iterate through the all calendar groups.
If you expect that the m365 outlook calendar list command will call the GET /me/calendars endpoint then it will list only calendars in a user's default calendar group not all calendars.

[milanholemans]

Looks good to me, only to clarify the first example.

To list all calendars we will have to iterate through the all calendar groups. If you expect that the m365 outlook calendar list command will call the GET /me/calendars endpoint then it will list only calendars in a user's default calendar group not all calendars.

Thanks for the useful information. I'll add it to the spec!

[waldekmastykarz]

No further comments. Let's open it up