Set-MailboxMessageConfiguration

The AfterMoveOrDeleteBehavior parameter specifies the behavior after moving or deleting an email item in Outlook on the web. You can use the following values:

• OpenPreviousItem
• OpenNextItem
• ReturnToView

The default value is OpenNextItem.

The AlwaysShowBcc parameter shows or hides the blind carbon copy (Bcc) field when the user creates messages in Outlook on the web.

Valid input for this parameter is $true or $false. The default value is $false.

The AlwaysShowFrom parameter shows or hides the From field when the user creates messages in Outlook on the web.

Valid input for this parameter is $true or $false. The default value is $false.

Note: This parameter doesn't work if the Outlook roaming signatures feature is enabled in your cloud-based organization. Admins can now temporarily disable roaming signatures without opening a support ticket by using the PostponeRoamingSignaturesUntilLater parameter on the Set-OrganizationConfig cmdlet.

The AutoAddSignature parameter specifies whether to automatically add signatures to new email messages created in Outlook on the web. Valid values are:

• $true: Email signatures are automatically added to new messages.
• $false: Email signatures aren't automatically added to new messages.

The email signature specified by the SignatureText parameter is added to plain text messages. The email signature specified by the SignatureHTML parameter is added to HTML-formatted messages.

Note: This parameter doesn't work if the Outlook roaming signatures feature is enabled in your cloud-based organization. Admins can now temporarily disable roaming signatures without opening a support ticket by using the PostponeRoamingSignaturesUntilLater parameter on the Set-OrganizationConfig cmdlet.

The AutoAddSignatureOnMobile parameter automatically adds the signature specified by the SignatureTextOnMobile parameter to messages when the user creates messages in Outlook on the web for devices.

Valid input for this parameter is $true or $false. The default value is $false.

The AutoAddSignature parameter specifies whether to automatically add signatures to reply email messages created in Outlook on the web. Valid values are:

• $true: Email signatures are automatically added to reply messages.
• $false: Email signatures aren't automatically added to reply messages.

The email signature specified by the SignatureText parameter is added to plain text messages. The email signature specified by the SignatureHTML parameter is added to HTML-formatted messages.

The CheckForForgottenAttachments parameter shows or hides the attachment warning prompt when the user creates messages in Outlook on the web.

Valid input for this parameter is $true or $false. The default value is $true.

For example, the user creates a message that includes the text "Please see the attached Word document", but the user doesn't attach a file, and clicks Send. If this value is set to $true, the user gets a warning prompt so they can go back to the message and attach a file. If this value is set to $false, the user doesn't get the warning prompt.

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

{{ Fill CheckForReportJunkDialog Description }}

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.

The ConversationSortOrder parameter specifies the sorting of messages in the reading pane in Conversation view for the user in Outlook on the web. You can use the following values:

• Chronological
• Tree
• NewestOnTop
• NewestOnBottom
• ChronologicalNewestOnTop
• ChronologicalNewestOnBottom
• TreeNewestOnBottom

The default value is ChronologicalNewestOnTop.

The DefaultFontColor parameter specifies the default text color when the user creates messages in Outlook on the web. This parameter accepts a hexadecimal color code value in the format #xxxxxx. The default value is #000000.

If the string value is unrecognized, the browser application uses a default font color to display the text.

The DefaultFontFlags parameter specifies the default text effect when the user creates messages in Outlook on the web. You can use the following values:

• Normal
• Bold
• Italic
• Underline
• All

The default value is Normal.

The DefaultFontName parameter specifies the default font when the user creates messages in Outlook on the web.

The default value is Calibri. If the font name value is unrecognized, the browser application uses a default font to display the text.

The DefaultFontSize parameter specifies the default text size when the user creates messages in Outlook on the web.

Valid input for this parameter is an integer between 1 and 7. The default value is 3, which corresponds to a 12 point font size.

The DefaultFormat parameter specifies the default message format when the user creates messages in Outlook on the web. Accepted values are Html and PlainText. The default value is Html.

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

{{ Fill DefaultSignature Description }}

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

{{ Fill DefaultSignatureOnReply Description }}

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

{{ Fill DeleteSignatureName Description }}

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

{{ Fill DisplayDensityMode Description }}

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.

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

The EchoGroupMessageBackToSubscribedSender parameter controls whether subscribed members of Microsoft 365 Groups receive copies of messages that they send to those Groups. Valid values are:

• $true: If a subscribed member of a Microsoft 365 Group sends a message to that Group, they'll receive a copy of the message in their Inbox.
• $false: Subscribed members of a Microsoft 365 Group don't receive their own copies of messages that they send to the Group. This is the default value.

This parameter is functional only in on-premises Exchange.

The EmailComposeMode parameter specifies how the user creates messages in Outlook on the web. You can use the following values:

• Inline: New messages and replies are created in the preview pane. This is the default value.
• SeparateForm: New messages and replies are created in a new browser window.

The EmptyDeletedItemsOnLogoff parameter specifies whether to delete items from the Deleted Items folder when the user logs out of Outlook on the web.

Valid input for this parameter is $true or $false. The default value is $false.

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

{{ Fill FavoritesBitFlags Description }}

This parameter is functional only in Exchange 2016 or later. It doesn't work in Exchange Online.

The GlobalReadingPanePosition specifies the default location of the reading pane in Outlook on the web. Valid values are:

• Off
• Bottom
• Right (This is the default value)

The HideDeletedItems parameter shows or hides deleted messages in Conversation view for the user in Outlook on the web.

Valid input for this parameter is $true or $false. The default value is $false.

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)

The IgnoreDefaultScope switch tells the command to ignore the default recipient scope setting for the Exchange PowerShell session, and to use the entire forest as the scope. You don't need to specify a value with this switch.

This switch enables the command to access Active Directory objects that aren't currently available in the default scope, but also introduces the following restrictions:

• You can't use the DomainController parameter. The command uses an appropriate global catalog server automatically.
• You can only use the DN for the Identity parameter. Other forms of identification, such as alias or GUID, aren't accepted.

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

{{ Fill IsDarkModeTheme Description }}

The IsFavoritesFolderTreeCollapsed parameter specifies whether to collapse the Favorites folder tree by default in Outlook on the web. Valid values are:

• $true: The Favorites folder tree is collapsed by default.
• $false: The Favorites folder tree isn't collapsed by default. This is the default value

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

{{ Fill IsFocusedInboxEnabled Description }}

The IsMailRootFolderTreeCollapsed parameter specifies whether to collapse the Mail root folder tree by default in Outlook on the web. Valid values are:

• $true: The Mail root folder tree is collapsed by default.
• $false: The Mail root folder tree isn't collapsed by default. This is the default value

The IsReplyAllTheDefaultResponse parameter specifies whether Reply All is the default response for messages in Outlook on the web. Valid values are:

• $true: Reply All is the default response option for messages in the reading pane. This is the default value.
• $false: Reply All isn't the default response option for messages in the reading pane.

The LinkPreviewEnabled parameter specifies whether link preview of URLs in email messages is enabled for the user in Outlook on the web. Valid values are:

• $true: Link preview of URLs in email messages is enabled for the user. This is the default value.
• $false: Link preview of URLs in email messages is disabled for the user.

This parameter depends on the value of the LinkPreviewEnabled parameter on the Set-OrganizationConfig cmdlet, which controls the link preview behavior in Outlook on the web for the entire organization. If link preview is disabled for the organization, users can't enable it for themselves.

The MailFolderPaneExpanded parameter specifies whether the Mail folder pane is expanded by default in Outlook on the web. Valid values are:

• $true: The Mail folder pane is expanded by default. This is the default value.
• $false: The Mail folder pane isn't expanded by default.

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

{{ Fill MailSendUndoInterval Description }}

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

{{ Fill ManuallyPickCertificate Description }}

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

{{ Fill NavigationBarWidth Description }}

The NavigationPaneViewOption parameter specifies the default navigation pane view in Outlook on the web. Valid values are:

• Default: This is the default value
• MailFolders
• PeopleFolders
• Groups
• PinnedMailFolders

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

{{ Fill NewEnabledPonts Description }}

The NewItemNotification parameter specifies how to provide notification for the arrival of new items for the user in Outlook on the web. You can use the following values:

• Sound
• EMailToast
• VoiceMailToast
• FaxToast
• None
• All

The default value is All.

The PreferAccessibleContent parameter specifies whether to prefer accessible content in Outlook on the web. Valid values are:

• $true: Prefer accessible content.
• $false: Don't prefer accessible content. This is the default value.

The PreviewMarkAsReadBehavior parameter specifies the options for marking an item as Read in the reading pane for the user in Outlook on the web. You can use the following values:

• Delayed: This value uses the delay interval specified by the PreviewMarkAsReadDelaytime parameter.
• OnSelectionChange
• Never

The default value is OnSelectionChange.

The PreviewMarkAsReadDelaytime parameter specifies the time in seconds to wait before marking an item as Read for the user in Outlook on the web.

Valid input for this parameter is an integer between 0 and 30. The default value is 5 seconds.

This parameter is meaningful only if you set the PreviewMarkAsReadBehavior parameter to the value Delayed.

The ReadReceiptResponse parameter specifies how to respond to requests for read receipts for the user in Outlook on the web. You can use the following values:

• DoNotAutomaticallySend
• AlwaysSend
• NeverSend

The default value is DoNotAutomaticallySend.

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

{{ Fill ReportJunkSelected Description }}

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

The SendAddressDefault parameter specifies the default From email address when the user has POP, IMAP, or Hotmail subscriptions configured on their mailbox. Users can override the default From address when they create an email message in Outlook on the web.

You can use one of the following values:

• Blank, which is represented by the value $null. This indicates no default From address is specified.
• The user's primary email address. For example, [email protected].
• The GUID of a POP, IMAP, or Hotmail subscription that's configured on the user's mailbox.

By default, no default From address is specified on the mailbox. When no default From address is specified, the default behavior is:

• The primary email address on the mailbox is used for all new messages.
• The To address of the incoming message is used as the From address for all replies or forwarded messages.

You can find the available values for SendAddressDefault on a mailbox by running the command: Get-MailboxMessageConfiguration -Mailbox <MailboxIdentity> | Format-List SendAddressDefault.

The ShowConversationAsTree parameter specifies how to sort messages in the list view in an expanded conversation for the user in Outlook on the web.

Valid input for this parameter is $true or $false. The default value is $false.

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

{{ Fill ShowInlinePreviews Description }}

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

{{ Fill ShowNotificationBar Description }}

The ShowPreviewTextInListView parameter specifies whether to show preview text for messages in list view in Outlook on the web. Valid values are:

• $true: Show preview text for messages in list view. This is the default value.
• $false: Don't show preview text for messages in list view.

The ShowReadingPaneOnFirstLoad parameter specifies whether to show the reading pane when the user opens in Outlook on the web for the first time. Valid values are:

• $true: Show the reading pane when the user opens Outlook on the web for the first time.
• $false: Don't show the reading pane when the user opens Outlook on the web for the first time. This is the default value.

The ShowSenderOnTopInListView parameter specifies whether to show the message sender on top in list view in Outlook on the web. Valid values are:

• $true: Show the message sender on top in list view. This is the default value.
• $false: Don't show the message sender on top in list view.

The ShowUpNext parameter specifies whether the next upcoming event should be shown above the mail list view in Outlook on the web. Valid values are:

• $true: Show the next upcoming event above the mail list view. This is the default value.
• $false: Don't show the next upcoming event above the mail list view.

Note: This parameter doesn't work if the Outlook roaming signatures feature is enabled in your cloud-based organization. Admins can now temporarily disable roaming signatures without opening a support ticket by using the PostponeRoamingSignaturesUntilLater parameter on the Set-OrganizationConfig cmdlet.

The SignatureHtml parameter specifies the email signature that's available to the user in HTML-formatted messages in Outlook on the web. You can use plain text or text with HTML tags. However, any JavaScript code is removed.

To automatically add this email signature to HTML-formatted messages created by the user in Outlook on the web, the AutoAddSignature parameter must be set to $true.

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

{{ Fill SignatureHtmlBody Description }}

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

{{ Fill SignatureName Description }}

Note: This parameter doesn't work if the Outlook roaming signatures feature is enabled in your cloud-based organization. Admins can now temporarily disable roaming signatures without opening a support ticket by using the PostponeRoamingSignaturesUntilLater parameter on the Set-OrganizationConfig cmdlet.

The SignatureText parameter specifies the email signature that's available to the user in plain text messages in Outlook on the web. This parameter supports all Unicode characters.

To automatically add the email signature to plain text messages created by the user in Outlook on the web, the AutoAddSignature parameter must be set to the value $true.

Note: This parameter doesn't work if the Outlook roaming signatures feature is enabled in your cloud-based organization. Admins can now temporarily disable roaming signatures without opening a support ticket by using the PostponeRoamingSignaturesUntilLater parameter on the Set-OrganizationConfig cmdlet.

The SignatureTextOnMobile parameter specifies the email signature that's available in messages created by the user in Outlook on the web for devices. This parameter supports all Unicode characters.

To automatically add the email signature to messages created by the user in Outlook on the web for devices, the AutoAddSignatureOnMobile parameter must be set to the value $true.

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

{{ Fill SigningCertificateId Description }}

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

{{ Fill SigningCertificateSubject Description }}

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

{{ Fill SmimeEncrypt Description }}

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

{{ Fill SmimeSign Description }}

The UseDefaultSignatureOnMobile parameter specifies whether to add the default email signature to messages created by the user in Outlook on the web for devices. The user configures the default signature in Outlook.

Valid input for this parameter is $true or $false. The default value is $false.

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

{{ Fill WebSuggestedRepliesEnabledForUser Description }}

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.