Set-MailboxCalendarConfiguration

This cmdlet is available in on-premises Exchange and in the cloud-based service. Some parameters and settings may be exclusive to one environment or the other.

Use the Set-MailboxCalendarConfiguration cmdlet to 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.

For information about the parameter sets in the Syntax section below, see Exchange cmdlet syntax.

Syntax

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>]
Set-MailboxCalendarConfiguration
   [-Identity] <MailboxIdParameter>
   [-AgendaMailEnabled <Boolean>]
   [-AgendaMailIntroductionEnabled <Boolean>]
   [-AgendaPaneEnabled <Boolean>]
   [-CalendarFeedsPreferredLanguage <String>]
   [-CalendarFeedsPreferredRegion <String>]
   [-CalendarFeedsRootPageId <String>]
   [-Confirm]
   [-ConversationalSchedulingEnabled <Boolean>]
   [-CreateEventsFromEmailAsPrivate <Boolean>]
   [-DailyAgendaMailSchedule <AgendaMailSchedule>]
   [-DefaultMeetingDuration <Int32>]
   [-DefaultMinutesToReduceLongEventsBy <Int32>]
   [-DefaultMinutesToReduceShortEventsBy <Int32>]
   [-DefaultOnlineMeetingProvider <OnlineMeetingProviderType>]
   [-DefaultReminderTime <TimeSpan>]
   [-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>]
Set-MailboxCalendarConfiguration
   [-MailboxLocation <MailboxLocationIdParameter>]
   [-AgendaMailEnabled <Boolean>]
   [-AgendaMailIntroductionEnabled <Boolean>]
   [-AgendaPaneEnabled <Boolean>]
   [-CalendarFeedsPreferredLanguage <String>]
   [-CalendarFeedsPreferredRegion <String>]
   [-CalendarFeedsRootPageId <String>]
   [-Confirm]
   [-ConversationalSchedulingEnabled <Boolean>]
   [-CreateEventsFromEmailAsPrivate <Boolean>]
   [-DailyAgendaMailSchedule <AgendaMailSchedule>]
   [-DefaultMeetingDuration <Int32>]
   [-DefaultMinutesToReduceLongEventsBy <Int32>]
   [-DefaultMinutesToReduceShortEventsBy <Int32>]
   [-DefaultOnlineMeetingProvider <OnlineMeetingProviderType>]
   [-DefaultReminderTime <TimeSpan>]
   [-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>]

Description

The Set-MailboxCalendarConfiguration cmdlet primarily allows users to manage their own calendar settings in Outlook on the web Options. However, administrators who are members of the Organization Management or Recipient Management role groups can configure the calendar settings for users by using this cmdlet.

You need to be assigned permissions before you can run this cmdlet. Although this topic lists all parameters for the cmdlet, you may not have access to some parameters if they're not included in the permissions assigned to you. To find the permissions required to run any cmdlet or parameter in your organization, see Find the permissions required to run any Exchange cmdlet.

Examples

Example 1

Set-MailboxCalendarConfiguration -Identity peter@contoso.com -RemindersEnabled $false

This example disables the calendar reminders for the calendar of the user peter@contoso.com.

Example 2

Set-MailboxCalendarConfiguration -Identity peter@contoso.com -WorkingHoursTimeZone "Pacific Standard Time"

This example sets the time zone of the work hours' start and end times to Pacific Standard Time for the calendar of the user peter@contoso.com.

Example 3

Set-MailboxCalendarConfiguration -Identity Tony -WorkingHoursStartTime 07:00:00

This example sets the working day's starting hour to 7 A.M. for the calendar of the user Tony.

Parameters

-AgendaMailEnabled

This parameter is reserved for internal Microsoft use.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-AgendaMailIntroductionEnabled

This parameter is available only in the cloud-based service.

{{ Fill AgendaMailIntroductionEnabled Description }}

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-AgendaPaneEnabled

This parameter is available only in the cloud-based service.

This parameter is reserved for internal Microsoft use.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-CalendarFeedsPreferredLanguage

This parameter is available only in the cloud-based service.

The CalendarFeedsPreferredLanguage parameter specifies the preferred language for calendar feeds. A valid value is an ISO 639-1 lowercase two-letter language code (for example, en for English).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-CalendarFeedsPreferredRegion

This parameter is available only in the cloud-based service.

The CalendarFeedsPreferredRegion specifies the preferred region for calendar feeds. A valid value is an ISO 3166-1 two-letter country code (for example, AU for Australia).

A reference for two-letter country codes is available at Country Codes List.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-CalendarFeedsRootPageId

This parameter is available only in the cloud-based service.

The CalendarFeedsRootPageId parameter specifies the root page ID for calendar feeds.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Confirm

The Confirm switch specifies whether to show or hide the confirmation prompt. How this switch affects the cmdlet depends on if the cmdlet requires confirmation before proceeding.

  • Destructive cmdlets (for example, Remove-* cmdlets) have a built-in pause that forces you to acknowledge the command before proceeding. For these cmdlets, you can skip the confirmation prompt by using this exact syntax: -Confirm:$false.
  • Most other cmdlets (for example, New-* and Set-* cmdlets) don't have a built-in pause. For these cmdlets, specifying the Confirm switch without a value introduces a pause that forces you acknowledge the command before proceeding.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ConversationalSchedulingEnabled

The ConversationalSchedulingEnabled parameter specifies whether to enable or disable conversational scheduling. Valid values are:

  • $true: Conversational scheduling is enabled. This is the default value.
  • $false: Conversational scheduling is disabled.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-CreateEventsFromEmailAsPrivate

This parameter is available only in the cloud-based service.

The CreateEventsFromEmailAsPrivate parameter specifies whether to create events from email messages as Normal or Private. Valid values are:

  • $true: Events from email are created as Private. This is the default value.
  • $false: Events from email are created as Normal (public).
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-DailyAgendaMailSchedule

This parameter is reserved for internal Microsoft use.

Type:AgendaMailSchedule
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-DefaultMeetingDuration

This parameter is reserved for internal Microsoft use.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-DefaultMinutesToReduceLongEventsBy

This parameter is available only in the cloud-based service.

{{ Fill DefaultMinutesToReduceLongEventsBy Description }}

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-DefaultMinutesToReduceShortEventsBy

This parameter is available only in the cloud-based service.

{{ Fill DefaultMinutesToReduceShortEventsBy Description }}

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-DefaultOnlineMeetingProvider

This parameter is available only in the cloud-based service.

The DefaultOnlineMeetingProvider parameter specifies the default provider for online meetings. Valid values are:

  • AlibabaDingTalk
  • AmazonChimePrivate
  • AmazonChimePublic
  • AppleFacetime
  • BlueJeans
  • ClaroVideoconferencia
  • FacebookWorkplace
  • GoogleMeet
  • GoToMeeting
  • JioMeet
  • RingCentral
  • SkypeForBusiness
  • SkypeForConsumer
  • TeamsForBusiness (This is the default value.)
  • Webex
  • Zoom
Type:OnlineMeetingProviderType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-DefaultReminderTime

The DefaultReminderTime parameter specifies the length of time before a meeting or appointment whenthe reminder is first displayed.

To specify a value, enter it as a time span: dd.hh:mm:ss where dd = days, hh = hours, mm = minutes, and ss = seconds.

Note that the value can't contain seconds. Valid values are:

  • 00:00:00
  • 00:05:00 (5 minutes)
  • 00:10:00 (10 minutes)
  • 00:15:00 (15 minutes) This is the default value.
  • 00:30:00 (30 minutes)
  • 01:00:00 (1 hour)
  • 02:00:00 (2 hours)
  • 03:00:00 (3 hours)
  • 04:00:00 (4 hours)
  • 08:00:00 (8 hours)
  • 12:00:00 (12 hours)
  • 1.00:00:00 (1 day)
  • 2.00:00:00 (2 days)
  • 3.00:00:00 (3 days)
  • 7.00:00:00 (7 days)
  • 14.00:00:00 (14 days)

This parameter is ignored when the RemindersEnabled parameter is set to $false.

Type:TimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DiningEventsFromEmailEnabled

This parameter is available only in the cloud-based service.

The DiningEventsFromEmailEnabled parameter specifies whether to create dining reservation events from email messages. Valid values are:

  • $true: Create dining reservation events from email messages. This is the default value.
  • $false: Don't create dining reservation events from email messages.

This parameter is meaningful only when the EventsFromEmailEnabled parameter is set to $true (which is the default value).

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-DomainController

This parameter is available only in on-premises Exchange.

The DomainController parameter specifies the domain controller that's used by this cmdlet to read data from or write data to Active Directory. You identify the domain controller by its fully qualified domain name (FQDN). For example, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-EntertainmentEventsFromEmailEnabled

This parameter is available only in the cloud-based service.

The EntertainmentEventsFromEmailEnabled parameter specifies whether to create entertainment reservation events from email messages. Valid values are:

  • $true: Create entertainment reservation events from email messages. This is the default value.
  • $false: Don't create entertainment reservation events from email messages.

This parameter is meaningful only when the EventsFromEmailEnabled parameter is set to $true (which is the default value).

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-EventsFromEmailEnabled

This parameter is available only in the cloud-based service.

The EventsFromEmailEnabled parameter specifies whether to enable events to be created from email messages. Valid values are:

  • $true: Creating events from email messages is enabled. This is the default value.
  • $false: Creating events from email messages is disabled.

When this setting is enabled, you can enable or disable creating specific types of events from email messages by using the following parameters:

  • DiningEventsFromEmailEnabled
  • EntertainmentEventsFromEmailEnabled
  • FlightEventsFromEmailEnabled
  • HotelEventsFromEmailEnabled
  • PackageDeliveryEventsFromEmailEnabled
  • RentalCarEventsFromEmailEnabled
Type:Boolean
Position:Named
Default value:True
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-FirstWeekOfYear

The FirstWeekOfYear parameter specifies the first week of the year. Valid values are:

  • FirstDay: Week numbers start on the first day of the year. This is the default value.
  • FirstFourDayWeek: Week numbers start on the first week that has at least four days.
  • FirstFullWeek: Week numbers start on the first week that has seven days.
  • LegacyNotSet: You can't set this value. This is a null value that appears only when the mailbox has been moved from an earlier version of Exchange.

You configure the first day of the week by using the WeekStartDay parameter.

Type:FirstWeekRules
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-FlightEventsFromEmailEnabled

This parameter is available only in the cloud-based service.

The FlightEventsFromEmailEnabled parameter specifies whether to create flight reservation events from email messages. Valid values are:

  • $true: Create flight reservation events from email messages. This is the default value.
  • $false: Don't create flight reservation events from email messages.

This parameter is meaningful only when the EventsFromEmailEnabled parameter is set to $true (which is the default value).

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-HotelEventsFromEmailEnabled

This parameter is available only in the cloud-based service.

The HotelEventsFromEmailEnabled parameter specifies whether to create hotel reservation events from email messages. Valid values are:

  • $true: Create hotel reservation events from email messages. This is the default value.
  • $false: Don't create hotel reservation events from email messages.

This parameter is meaningful only when the EventsFromEmailEnabled parameter is set to $true (which is the default value).

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Identity

The Identity parameter specifies the mailbox that you want to modify. You can use any value that uniquely identifies the mailbox. For example:

  • Name
  • Alias
  • Distinguished name (DN)
  • Canonical DN
  • Domain\Username
  • Email address
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • User ID or user principal name (UPN)
Type:MailboxIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-InvoiceEventsFromEmailEnabled

This parameter is available only in the cloud-based service.

The InvoiceEventsFromEmailEnabled parameter specifies whether to allow creating invoices from email messages. Valid values are:

  • $true: Creating invoices from messages is enabled. This is the default value.
  • $false: Creating invoices from messages is disabled.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-LocationDetailsInFreeBusy

This parameter is available only in the cloud-based service.

The LocationDetailsInFreeBusy parameter specifies the level of location details that are returned in user's availability. Valid values are:

  • None
  • Building
  • Desk
Type:LocationDetailsPermissionInFreeBusy
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-MailboxLocation

This parameter is available only in the cloud-based service.

{{ Fill MailboxLocation Description }}

Type:MailboxLocationIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-OnlineMeetingsByDefaultEnabled

This parameter is available only in the cloud-based service.

The OnlineMeetingsByDefaultEnabled parameter specifies whether to set all meetings as Teams or Skype for Business by default during meeting creation. Currently, this parameter sets the default value, so if the user has already directly interacted with this setting from an Outlook client, this default value will be ignored. Eventually, this parameter will override the Outlook-configured setting.

Valid values are:

  • $true: All meetings are online by default.
  • $false: All meetings are not online by default.
  • $null: The value of the OnlineMeetingsByDefaultEnabled parameter on the Set-OrganizationConfig cmdlet (the organizational setting) is used.

Setting this parameter enables the display of the Add online meeting to all meetings option in Calendar options in Outlook for Windows. This setting allows users to enable or disable the option when Teams is used for online meetings. It does not override the organization setting that's configured by the OnlineMeetingsByDefaultEnabled parameter on the Set-OrganizationConfig cmdlet.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-PackageDeliveryEventsFromEmailEnabled

This parameter is available only in the cloud-based service.

The PackageDeliveryEventsFromEmailEnabled parameter specifies whether to create package delivery events from email messages. Valid values are:

  • $true: Create package delivery events from email messages.
  • $false: Don't create package delivery events from email messages. This is the default value.

This parameter is meaningful only when the EventsFromEmailEnabled parameter is set to $true (which is the default value).

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-PreserveDeclinedMeetings

This parameter is available only in the cloud-based service.

{{ Fill PreserveDeclinedMeetings Description }}

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-RemindersEnabled

The RemindersEnabled parameter enables or disables reminders for calendar items. Valid values are:

  • $true: Reminders are enabled. This is the default value.
  • $false: Reminders are disabled.

When the reminder is first displayed is controlled by the DefaultReminderTime parameter.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ReminderSoundEnabled

The ReminderSoundEnabled parameter specifies whether a sound is played along with the reminder. Valid values are:

  • $true: A sound is played with the reminder. This is the default value.
  • $false: No sound is played with the reminder.

This parameter is ignored when the RemindersEnabled parameter is set to $false.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-RentalCarEventsFromEmailEnabled

This parameter is available only in the cloud-based service.

The RentalCarEventsFromEmailEnabled parameter specifies whether to create rental car reservation events from email messages. Valid values are:

  • $true: Create rental car reservation events from email messages. This is the default value.
  • $false: Don't create rental car reservation events from email messages.

This parameter is meaningful only when the EventsFromEmailEnabled parameter is set to $true (which is the default value).

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ServiceAppointmentEventsFromEmailEnabled

This parameter is available only in the cloud-based service.

{{ Fill ServiceAppointmentEventsFromEmailEnabled Description }}

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ShortenEventScopeDefault

This parameter is available only in the cloud-based service.

{{ Fill ShortenEventScopeDefault Description }}

Type:ShortenEventScopeOption
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ShowWeekNumbers

The ShowWeekNumbers parameter specifies whether the week number is displayed in the Outlook on the web calendar. Valid values are:

  • $true: The week number is displayed.
  • $false: The week number isn't displayed. This is the default value.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-SkipAgendaMailOnFreeDays

This parameter is reserved for internal Microsoft use.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-TimeIncrement

The TimeIncrement parameter specifies the scale that the Outlook on the web calendar uses to show time. Valid values are:

  • FifteenMinutes
  • ThirtyMinutes (This is the default value)
Type:HourIncrement
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-UseBrightCalendarColorThemeInOwa

The UseBrightCalendarColorThemeInOwa parameter specifies whether to use light colors or bright colors for the calendar in Outlook on the web. Valid values are:

  • $true: Use bright colors in the calendar.
  • $false: Use light colors in the calendar. This is the default value.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-WeatherEnabled

This parameter is available only in the cloud-based service.

The WeatherEnabled specifies whether weather is displayed in the calendar in Outlook on the web. Valid values are:

  • FirstRun (This is the default value)
  • Disabled: Hide weather on the calendar.
  • Enabled: Show weather on the calendar.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-WeatherLocationBookmark

This parameter is available only in the cloud-based service.

The WeatherLocationBookmark parameter specifies the default weather information that's displayed in the calendar in Outlook on the web. This parameter is based on an index value of the configured weather locations. The first weather location has the index value 0, the second weather location has the index value 1, and so on.

A valid value for this parameter depends on the number of weather locations that are configured for the mailbox. For example, if there are 3 weather locations configured, you can specify the value 0, 1, or 2 for this parameter.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-WeatherLocations

This parameter is available only in the cloud-based service.

The WeatherLocations parameter specifies one or more locations to display the weather for in the calendar in Outlook on the web.

This parameter uses the syntax: LocationId:<LocationID>;Name:<Name>;Latitude:<Latitude>;Longitude:<Longitude>. For example, LocationId:105808079;Name:Redmond, WA;Latitude:47.679;Longitude:-122.132.

To enter multiple values and overwrite any existing entries, use the following syntax: "Value1","Value2",..."ValueN".

To add or remove one or more values without affecting any existing entries, use the following syntax: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

For this parameter, each Value is LocationId:<LocationID>;Name:<Name>;Latitude:<Latitude>;Longitude:<Longitude>.

You can configure a maximum of 5 weather locations.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-WeatherUnit

This parameter is available only in the cloud-based service.

The WeatherUnit parameter specifies the temperature scale that's used to display the weather in the calendar in Outlook on the web. Valid values are:

  • Default (This is the default value)
  • Celsius
  • Fahrenheit
Type:WeatherTemperatureUnit
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-WeekStartDay

The WeekStartDay parameter specifies the first day of the week. Valid values are:

  • Sunday (This is the default value)
  • Monday
  • Tuesday
  • Wednesday
  • Thursday
  • Friday
  • Saturday
Type:DayOfWeek
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-WhatIf

The WhatIf switch simulates the actions of the command. You can use this switch to view the changes that would occur without actually applying those changes. You don't need to specify a value with this switch.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-WorkDays

The WorkDays parameter specifies the work days in the calendar. Valid values are:

  • None
  • AllDays
  • Weekdays (This is the default value)
  • WeekEndDays
  • Sunday
  • Monday
  • Tuesday
  • Wednesday
  • Thursday
  • Friday
  • Saturday

You can specify multiple values separated by commas, but redundant values are ignored. For example, entering Weekdays,Monday results in the value Weekdays.

Type:DaysOfWeek
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-WorkingHoursEndTime

The WorkingHoursEndTime parameter specifies the time that the work day ends.

To specify a value, enter it as a time span: dd.hh:mm:ss where dd = days, hh = hours, mm = minutes, and ss = seconds.

The default value is 17:00:00 (5:00 P.M.).

Type:TimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-WorkingHoursStartTime

The WorkingHoursStartTime parameter specifies the time that the work day starts.

To specify a value, enter it as a time span: dd.hh:mm:ss where dd = days, hh = hours, mm = minutes, and ss = seconds.

The default value is 08:00:00(8:00 A.M.).

Type:TimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-WorkingHoursTimeZone

The WorkingHoursTimeZone parameter specifies the time zone that's used by the WorkingHoursStartTime and WorkingHoursEndTime parameters.

A valid value for this parameter is a supported time zone key name (for example, "Pacific Standard Time").

To see the available values, run the following command: $TimeZone = Get-ChildItem "HKLM:\Software\Microsoft\Windows NT\CurrentVersion\Time zones" | foreach {Get-ItemProperty $_.PSPath}; $TimeZone | sort Display | Format-Table -Auto PSChildname,Display.

If the value contains spaces, enclose the value in quotation marks ("). The default value is the time zone setting of the Exchange server.

Type:ExTimeZoneValue
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-WorkspaceUserEnabled

This parameter is available only in the cloud-based service.

{{ Fill WorkspaceUserEnabled Description }}

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

Inputs

Input types

To see the input types that this cmdlet accepts, see Cmdlet Input and Output Types. If the Input Type field for a cmdlet is blank, the cmdlet doesn't accept input data.

Outputs

Output types

To see the return types, which are also known as output types, that this cmdlet accepts, see Cmdlet Input and Output Types. If the Output Type field is blank, the cmdlet doesn't return data.