Commands › Exchange Online

Set-MailboxCalendarConfiguration

Exchange Online ExchangeOnlineManagement Set-*

Modify mailbox calendar settings for Outlook on the web. This affects how the user's calendar looks and how reminders work in Outlook on the web. This also affects settings that define how meeting invitations, responses, and notifications are sent to the user.

Quick start script

# Set-MailboxCalendarConfiguration — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-ExchangeOnline -CertificateThumbprint $thumb -AppId $appId -Organization $org

# 2. Capture the current state first — you cannot roll back what you never recorded
$before = Get-MailboxCalendarConfiguration
$before | Format-List

# 3. Make the change (dry run first)
Set-MailboxCalendarConfiguration -Identity <MailboxIdParameter> -WhatIf
Set-MailboxCalendarConfiguration -Identity <MailboxIdParameter>

# 4. Verify and diff
$after = Get-MailboxCalendarConfiguration
Compare-Object ($before | Out-String) ($after | Out-String)

Syntax — 3 parameter sets

Default

Set-MailboxCalendarConfiguration [-Identity] <MailboxIdParameter>
 [-AgendaMailEnabled <Boolean>]
 [-Confirm]
 [-ConversationalSchedulingEnabled <Boolean>]
 [-DailyAgendaMailSchedule <AgendaMailSchedule>]
 [-DefaultMeetingDuration <Int32>]
 [-DefaultReminderTime <TimeSpan>]
 [-DomainController <Fqdn>]
 [-FirstWeekOfYear <FirstWeekRules>]
 [-RemindersEnabled <Boolean>]
 [-ReminderSoundEnabled <Boolean>]
 [-ShowWeekNumbers <Boolean>]
 [-SkipAgendaMailOnFreeDays <Boolean>]
 [-TimeIncrement <HourIncrement>]
 [-UseBrightCalendarColorThemeInOwa <Boolean>]
 [-WeekStartDay <DayOfWeek>]
 [-WhatIf]
 [-WorkDays <DaysOfWeek>]
 [-WorkingHoursEndTime <TimeSpan>]
 [-WorkingHoursStartTime <TimeSpan>]
 [-WorkingHoursTimeZone <ExTimeZoneValue>]
 [<CommonParameters>]

Identity

Set-MailboxCalendarConfiguration [-Identity] <MailboxIdParameter>
 [-AgendaMailEnabled <Boolean>]
 [-AgendaMailIntroductionEnabled <Boolean>]
 [-AgendaPaneEnabled <Boolean>]
 [-AutoDeclineWhenBusy <Boolean>]
 [-CalendarFeedsPreferredLanguage <String>]
 [-CalendarFeedsPreferredRegion <String>]
 [-CalendarFeedsRootPageId <String>]
 [-Confirm]
 [-ConversationalSchedulingEnabled <Boolean>]
 [-CreateEventsFromEmailAsPrivate <Boolean>]
 [-DailyAgendaMailSchedule <AgendaMailSchedule>]
 [-DefaultMeetingDuration <Int32>]
 [-DefaultMinutesToReduceLongEventsBy <Int32>]
 [-DefaultMinutesToReduceShortEventsBy <Int32>]
 [-DefaultOnlineMeetingProvider <OnlineMeetingProviderType>]
 [-DefaultReminderTime <TimeSpan>]
 [-DeleteMeetingRequestOnRespond <Boolean>]
 [-DiningEventsFromEmailEnabled <Boolean>]
 [-EntertainmentEventsFromEmailEnabled <Boolean>]
 [-EventsFromEmailEnabled <Boolean>]
 [-FirstWeekOfYear <FirstWeekRules>]
 [-FlightEventsFromEmailEnabled <Boolean>]
 [-HotelEventsFromEmailEnabled <Boolean>]
 [-InvoiceEventsFromEmailEnabled <Boolean>]
 [-LocationDetailsInFreeBusy <LocationDetailsPermissionInFreeBusy>]
 [-OnlineMeetingsByDefaultEnabled <System.Boolean>]
 [-PackageDeliveryEventsFromEmailEnabled <Boolean>]
 [-PreserveDeclinedMeetings <Boolean>]
 [-RemindersEnabled <Boolean>]
 [-ReminderSoundEnabled <Boolean>]
 [-RentalCarEventsFromEmailEnabled <Boolean>]
 [-ServiceAppointmentEventsFromEmailEnabled <Boolean>]
 [-ShortenEventScopeDefault <ShortenEventScopeOption>]
 [-ShowWeekNumbers <Boolean>]
 [-SkipAgendaMailOnFreeDays <Boolean>]
 [-TimeIncrement <HourIncrement>]
 [-UseBrightCalendarColorThemeInOwa <Boolean>]
 [-WeatherEnabled <WeatherEnabledStatus>]
 [-WeatherLocationBookmark <Int32>]
 [-WeatherLocations <MultiValuedProperty>]
 [-WeatherUnit <WeatherTemperatureUnit>]
 [-WeekStartDay <DayOfWeek>]
 [-WhatIf]
 [-WorkDays <DaysOfWeek>]
 [-WorkingHoursEndTime <TimeSpan>]
 [-WorkingHoursStartTime <TimeSpan>]
 [-WorkingHoursTimeZone <ExTimeZoneValue>]
 [-WorkspaceUserEnabled <System.Boolean>]
 [<CommonParameters>]

MailboxLocation

Set-MailboxCalendarConfiguration [-MailboxLocation <MailboxLocationIdParameter>]
 [-AgendaMailEnabled <Boolean>]
 [-AgendaMailIntroductionEnabled <Boolean>]
 [-AgendaPaneEnabled <Boolean>]
 [-AutoDeclineWhenBusy <Boolean>]
 [-CalendarFeedsPreferredLanguage <String>]
 [-CalendarFeedsPreferredRegion <String>]
 [-CalendarFeedsRootPageId <String>]
 [-Confirm]
 [-ConversationalSchedulingEnabled <Boolean>]
 [-CreateEventsFromEmailAsPrivate <Boolean>]
 [-DailyAgendaMailSchedule <AgendaMailSchedule>]
 [-DefaultMeetingDuration <Int32>]
 [-DefaultMinutesToReduceLongEventsBy <Int32>]
 [-DefaultMinutesToReduceShortEventsBy <Int32>]
 [-DefaultOnlineMeetingProvider <OnlineMeetingProviderType>]
 [-DefaultReminderTime <TimeSpan>]
 [-DeleteMeetingRequestOnRespond <Boolean>]
 [-DiningEventsFromEmailEnabled <Boolean>]
 [-EntertainmentEventsFromEmailEnabled <Boolean>]
 [-EventsFromEmailEnabled <Boolean>]
 [-FirstWeekOfYear <FirstWeekRules>]
 [-FlightEventsFromEmailEnabled <Boolean>]
 [-HotelEventsFromEmailEnabled <Boolean>]
 [-InvoiceEventsFromEmailEnabled <Boolean>]
 [-LocationDetailsInFreeBusy <LocationDetailsPermissionInFreeBusy>]
 [-OnlineMeetingsByDefaultEnabled <System.Boolean>]
 [-PackageDeliveryEventsFromEmailEnabled <Boolean>]
 [-PreserveDeclinedMeetings <Boolean>]
 [-RemindersEnabled <Boolean>]
 [-ReminderSoundEnabled <Boolean>]
 [-RentalCarEventsFromEmailEnabled <Boolean>]
 [-ServiceAppointmentEventsFromEmailEnabled <Boolean>]
 [-ShortenEventScopeDefault <ShortenEventScopeOption>]
 [-ShowWeekNumbers <Boolean>]
 [-SkipAgendaMailOnFreeDays <Boolean>]
 [-TimeIncrement <HourIncrement>]
 [-UseBrightCalendarColorThemeInOwa <Boolean>]
 [-WeatherEnabled <WeatherEnabledStatus>]
 [-WeatherLocationBookmark <Int32>]
 [-WeatherLocations <MultiValuedProperty>]
 [-WeatherUnit <WeatherTemperatureUnit>]
 [-WeekStartDay <DayOfWeek>]
 [-WhatIf]
 [-WorkDays <DaysOfWeek>]
 [-WorkingHoursEndTime <TimeSpan>]
 [-WorkingHoursStartTime <TimeSpan>]
 [-WorkingHoursTimeZone <ExTimeZoneValue>]
 [-WorkspaceUserEnabled <System.Boolean>]
 [<CommonParameters>]

Parameters (51)

Parameter	Type	Required	What it controls
-Identity	MailboxIdParameter	yes	The Identity parameter specifies the mailbox that you want to modify. You can use any value that uniquely identifies the mailbox. For example:
-AgendaMailEnabled	Boolean		This parameter is reserved for internal Microsoft use.
-AgendaMailIntroductionEnabled	Boolean		This parameter is available only in the cloud-based service.
-AgendaPaneEnabled	Boolean		This parameter is available only in the cloud-based service.
-AutoDeclineWhenBusy	Boolean		This parameter is available only in the cloud-based service.
-CalendarFeedsPreferredLanguage	String		This parameter is available only in the cloud-based service.
-CalendarFeedsPreferredRegion	String		This parameter is available only in the cloud-based service.
-CalendarFeedsRootPageId	String		This parameter is available only in the cloud-based service.
-Confirm	SwitchParameter		The Confirm switch specifies whether to show or hide the confirmation prompt. How this switch affects the cmdlet depends on whether the cmdlet requires confirmation before proceeding.
-ConversationalSchedulingEnabled	Boolean		The ConversationalSchedulingEnabled parameter specifies whether to enable or disable conversational scheduling. Valid values are:
-CreateEventsFromEmailAsPrivate	Boolean		This parameter is available only in the cloud-based service.
-DailyAgendaMailSchedule	AgendaMailSchedule		This parameter is reserved for internal Microsoft use.
-DefaultMeetingDuration	Int32		This parameter is reserved for internal Microsoft use.
-DefaultMinutesToReduceLongEventsBy	Int32		This parameter is available only in the cloud-based service.
-DefaultMinutesToReduceShortEventsBy	Int32		This parameter is available only in the cloud-based service.
-DefaultOnlineMeetingProvider	OnlineMeetingProviderType		This parameter is available only in the cloud-based service.
-DefaultReminderTime	TimeSpan		The DefaultReminderTime parameter specifies the length of time before a meeting or appointment when the reminder is first displayed.
-DeleteMeetingRequestOnRespond	Boolean		This parameter is available only in the cloud-based service.
-DiningEventsFromEmailEnabled	Boolean		This parameter is available only in the cloud-based service.
-DomainController	Fqdn		This parameter is available only in on-premises Exchange.
-EntertainmentEventsFromEmailEnabled	Boolean		This parameter is available only in the cloud-based service.
-EventsFromEmailEnabled	Boolean		This parameter is available only in the cloud-based service.
-FirstWeekOfYear	FirstWeekRules		The FirstWeekOfYear parameter specifies the first week of the year. Valid values are:
-FlightEventsFromEmailEnabled	Boolean		This parameter is available only in the cloud-based service.
-HotelEventsFromEmailEnabled	Boolean		This parameter is available only in the cloud-based service.
-InvoiceEventsFromEmailEnabled	Boolean		This parameter is available only in the cloud-based service.
-LocationDetailsInFreeBusy	LocationDetailsPermissionInFreeBusy		This parameter is available only in the cloud-based service.
-MailboxLocation	MailboxLocationIdParameter		This parameter is available only in the cloud-based service.
-OnlineMeetingsByDefaultEnabled	Boolean		This parameter is available only in the cloud-based service.
-PackageDeliveryEventsFromEmailEnabled	Boolean		This parameter is available only in the cloud-based service.
-PreserveDeclinedMeetings	Boolean		This parameter is available only in the cloud-based service.
-RemindersEnabled	Boolean		The RemindersEnabled parameter enables or disables reminders for calendar items. Valid values are:
-ReminderSoundEnabled	Boolean		The ReminderSoundEnabled parameter specifies whether a sound is played along with the reminder. Valid values are:
-RentalCarEventsFromEmailEnabled	Boolean		This parameter is available only in the cloud-based service.
-ServiceAppointmentEventsFromEmailEnabled	Boolean		This parameter is available only in the cloud-based service.
-ShortenEventScopeDefault	ShortenEventScopeOption		This parameter is available only in the cloud-based service.
-ShowWeekNumbers	Boolean		The ShowWeekNumbers parameter specifies whether the week number is displayed in the Outlook on the web calendar. Valid values are:
-SkipAgendaMailOnFreeDays	Boolean		This parameter is reserved for internal Microsoft use.
-TimeIncrement	HourIncrement		The TimeIncrement parameter specifies the scale that the Outlook on the web calendar uses to show time. Valid values are:
-UseBrightCalendarColorThemeInOwa	Boolean		The UseBrightCalendarColorThemeInOwa parameter specifies whether to use light colors or bright colors for the calendar in Outlook on the web. Valid values are:
-WeatherEnabled	Boolean		This parameter is available only in the cloud-based service.
-WeatherLocationBookmark	Int32		This parameter is available only in the cloud-based service.
-WeatherLocations	MultiValuedProperty		This parameter is available only in the cloud-based service.
-WeatherUnit	WeatherTemperatureUnit		This parameter is available only in the cloud-based service.
-WeekStartDay	DayOfWeek		The WeekStartDay parameter specifies the first day of the week. Valid values are:
-WhatIf	SwitchParameter		The WhatIf switch shows what the command does without making any changes. You don't need to specify a value with this switch.
-WorkDays	DaysOfWeek		The WorkDays parameter specifies the work days in the calendar. Valid values are:
-WorkingHoursEndTime	TimeSpan		The WorkingHoursEndTime parameter specifies the time that the work day ends.
-WorkingHoursStartTime	TimeSpan		The WorkingHoursStartTime parameter specifies the time that the work day starts.
-WorkingHoursTimeZone	ExTimeZoneValue		The WorkingHoursTimeZone parameter specifies the time zone that's used by the WorkingHoursStartTime and WorkingHoursEndTime parameters.
-WorkspaceUserEnabled	Boolean		This parameter is available only in the cloud-based service.

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.