New command: `outlook calendargroup list`

[milanholemans]

Usage

m365 outlook calendargroup list [options]

Description

Retrieves calendar groups from 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.

Examples

Retrieve all calendar groups from the current signed in user.

m365 outlook calendargroup list --userId "@meId"

Retrieve all calendar groups from a specific user by email.

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

Retrieve all calendar groups from a specific user by ID.

m365 outlook calendargroup list --userId b743445a-112c-4fda-9afd-05943f9c7b36

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-calendargroups?view=graph-rest-1.0&tabs=http

[MartinM85]

The specification looks good to me.

A few notes:

• If we want to list calendar group of the signed in user by the m365 outlook calendargroup list then the description for the options should be a little bit different.

• On the other hand we support @meId and @meUserName tokens to simplify working with the signed in user Introduce @me.id and @me.userName to simplify working with the current user #3056.

With delegated permissions you can access calendars shared with you by others.

[milanholemans]

I agree that using @meId would be better instead of just running in the context of the current user by default. I think makes it more in line with other commands.

[MartinM85]

LGTM