New command: `outlook calendar add`

[MartinM85]

Usage

m365 outlook calendar add [options]

Description

Creates a new calendar for 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.
--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.

Examples

Create a new calendar for a user in a default calendar's group

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

m365 outlook calendar add --userName 'john.doe@contoso.com' --name 'Interviews' --calendarGroupId 'AAMkADY1YmE3N2FhLWEwMz' --color 'lightBlue'

Default properties

Additional Info

• API: https://learn.microsoft.com/en-us/graph/api/user-post-calendars?view=graph-rest-1.0&tabs=http
• Permissions: Microsoft Graph, delegated/application Calendars.ReadWrite

Feel free to comment if you think it would be useful to specify any additional properties during creation: https://learn.microsoft.com/en-us/graph/api/resources/calendar?view=graph-rest-1.0#properties

[milanholemans]

Hi @MartinM85, nice spec.

A few comments from my side:

• Currently, some option descriptions mention that the option is "optional". Since this can be determined from the option notation, I suggest we remove it from the description.
• Aren't we missing an option calendarGroupName?
• Could we add an extra flag like --default to add a new default calendar?

[MartinM85]

@milanholemans Spec updated. The --default flag makes sense to me.