New command: `outlook event get`

[MartinM85]

Usage

m365 outlook event get [options]

Description

Retrieve an event from a specific calendar of a user

Options

Option	Description
-i, --id <id>	ID of the event.
--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.
--calendarId [calendarId]	ID of the calendar. Specify either calendarId or calendarName, but not both.
--calendarName [calendarName]	Name of the calendar. Specify either calendarId or calendarName, but not both.
--timeZone [timeZone]	The time zone for the event start and end times. If not specified, the start and end times are in UTC.

Examples

Get an event for the current signed-in user from a calendar specified by id.

m365 outlook event get --id "AAMkAGVmMDEzMTM4L" --userId "@meId" --calendarId "AAMkAGRkZ"

Get an event for the user from a calendar specified by id and return event times in Pacific Standard Time time zone.

m365 outlook event get --id "AAMkAGVmMDEzMTM4L" --userName "john.doe@contoso.com" --calendarId "AAMkAGRkZ" --timeZone 'Pacific Standard Time'

Default properties

N/A

Additional Info

API: https://learn.microsoft.com/en-us/graph/api/event-get

Remarks

When you specify a value for timeZone, consider the options of the time zone list, or additional time zone list

[Jwaegebaert]

Specs already look pretty clear to me. Just a few small remarks I noticed:

• I’d suggest changing --eventId <eventId> to -i, --id <id> since we’re already in the event scope.
• For timeZone, since it’s optional, we should mention what the default value is when it’s not provided.
• I’m not fully convinced properties adds much value here. It feels a bit verbose, since we’re fetching a single object and would normally return all properties anyway without explicitly using $select. Returning the full object should be fine.

[MartinM85]

@Jwaegebaert Spec updated.

[Jwaegebaert]

LGTM!