Commands › Exchange Online

Set-MailboxMessageConfiguration

Exchange Online ExchangeOnlineManagement Set-*

Configure the Outlook on the web settings that are applied to specific mailboxes.

Quick start script

# Set-MailboxMessageConfiguration — 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-MailboxMessageConfiguration
$before | Format-List

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

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

Syntax

Set-MailboxMessageConfiguration [-Identity] <MailboxIdParameter>
 [-AfterMoveOrDeleteBehavior <AfterMoveOrDeleteBehavior>]
 [-AlwaysShowBcc <Boolean>]
 [-AlwaysShowFrom <Boolean>]
 [-AutoAddSignature <Boolean>]
 [-AutoAddSignatureOnMobile <Boolean>]
 [-AutoAddSignatureOnReply <Boolean>]
 [-CheckForForgottenAttachments <Boolean>]
 [-CheckForReportJunkDialog <Boolean>]
 [-Confirm]
 [-ConversationSortOrder <ConversationSortOrder>]
 [-DefaultFontColor <String>]
 [-DefaultFontFlags <FontFlags>]
 [-DefaultFontName <String>]
 [-DefaultFontSize <Int32>]
 [-DefaultFormat <MailFormat>]
 [-DefaultSignature <String>]
 [-DefaultSignatureOnReply <String>]
 [-DeleteSignatureName <String>]
 [-DisplayDensityMode <DisplayDensityMode>]
 [-DomainController <Fqdn>]
 [-EchoGroupMessageBackToSubscribedSender <Boolean>]
 [-EmailComposeMode <EmailComposeMode>]
 [-EmptyDeletedItemsOnLogoff <Boolean>]
 [-FavoritesBitFlags <Int32>]
 [-GlobalReadingPanePosition <MailReadingPanePosition>]
 [-HideDeletedItems <Boolean>]
 [-IgnoreDefaultScope]
 [-IsDarkModeTheme <Boolean>]
 [-IsFavoritesFolderTreeCollapsed <Boolean>]
 [-IsFocusedInboxEnabled <Boolean>]
 [-IsMailRootFolderTreeCollapsed <Boolean>]
 [-IsReplyAllTheDefaultResponse <Boolean>]
 [-LinkPreviewEnabled <Boolean>]
 [-MailFolderPaneExpanded <Boolean>]
 [-MailSendUndoInterval <Int32>]
 [-ManuallyPickCertificate <Boolean>]
 [-NavigationBarWidth <Int32>]
 [-NavigationPaneViewOption <NavigationPaneView>]
 [-NewEnabledPonts <PontType>]
 [-NewItemNotification <NewItemNotification>]
 [-PreferAccessibleContent <Boolean>]
 [-PreviewMarkAsReadBehavior <PreviewMarkAsReadBehavior>]
 [-PreviewMarkAsReadDelaytime <Int32>]
 [-ReadReceiptResponse <ReadReceiptResponse>]
 [-ReportJunkSelected <Boolean>]
 [-SendAddressDefault <String>]
 [-ShowConversationAsTree <Boolean>]
 [-ShowInlinePreviews <Boolean>]
 [-ShowNotificationBar <Boolean>]
 [-ShowPreviewTextInListView <Boolean>]
 [-ShowReadingPaneOnFirstLoad <Boolean>]
 [-ShowSenderOnTopInListView <Boolean>]
 [-ShowUpNext <Boolean>]
 [-SignatureHtml <String>]
 [-SignatureHtmlBody <String>]
 [-SignatureName <String>]
 [-SignatureText <String>]
 [-SignatureTextOnMobile <String>]
 [-SigningCertificateId <String>]
 [-SigningCertificateSubject <String>]
 [-SmimeEncrypt <Boolean>]
 [-SmimeSign <Boolean>]
 [-UseDefaultSignatureOnMobile <Boolean>]
 [-WebSuggestedRepliesEnabledForUser <Boolean>]
 [-WhatIf]
 [<CommonParameters>]

Parameters (66)

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:
-AfterMoveOrDeleteBehavior	AfterMoveOrDeleteBehavior		The AfterMoveOrDeleteBehavior parameter specifies the behavior after moving or deleting an email item in Outlook on the web. You can use the following values:
-AlwaysShowBcc	Boolean		The AlwaysShowBcc parameter shows or hides the blind carbon copy (Bcc) field when the user creates messages in Outlook on the web.
-AlwaysShowFrom	Boolean		The AlwaysShowFrom parameter shows or hides the From field when the user creates messages in Outlook on the web.
-AutoAddSignature	Boolean		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...
-AutoAddSignatureOnMobile	Boolean		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...
-AutoAddSignatureOnReply	Boolean		The AutoAddSignature parameter specifies whether to automatically add signatures to reply email messages created in Outlook on the web. Valid values are:
-CheckForForgottenAttachments	Boolean		The CheckForForgottenAttachments parameter shows or hides the attachment warning prompt when the user creates messages in Outlook on the web.
-CheckForReportJunkDialog	Boolean		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.
-ConversationSortOrder	ConversationSortOrder		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:
-DefaultFontColor	String		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.
-DefaultFontFlags	FontFlags		The DefaultFontFlags parameter specifies the default text effect when the user creates messages in Outlook on the web. You can use the following values:
-DefaultFontName	String		The DefaultFontName parameter specifies the default font when the user creates messages in Outlook on the web.
-DefaultFontSize	Int32		The DefaultFontSize parameter specifies the default text size when the user creates messages in Outlook on the web.
-DefaultFormat	MailFormat		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.
-DefaultSignature	String		This parameter is available only in the cloud-based service.
-DefaultSignatureOnReply	String		This parameter is available only in the cloud-based service.
-DeleteSignatureName	String		This parameter is available only in the cloud-based service.
-DisplayDensityMode	DisplayDensityMode		This parameter is available only in the cloud-based service.
-DomainController	Fqdn		This parameter is available only in on-premises Exchange.
-EchoGroupMessageBackToSubscribedSender	Boolean		This parameter is available only in the cloud-based service.
-EmailComposeMode	EmailComposeMode		This parameter is functional only in on-premises Exchange.
-EmptyDeletedItemsOnLogoff	Boolean		The EmptyDeletedItemsOnLogoff parameter specifies whether to delete items from the Deleted Items folder when the user logs out of Outlook on the web.
-FavoritesBitFlags	Int32		This parameter is available only in the cloud-based service.
-GlobalReadingPanePosition	MailReadingPanePosition		This parameter is functional only in Exchange 2016 or later. It doesn't work in Exchange Online.
-HideDeletedItems	Boolean		The HideDeletedItems parameter shows or hides deleted messages in Conversation view for the user in Outlook on the web.
-IgnoreDefaultScope	SwitchParameter		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.
-IsDarkModeTheme	Boolean		This parameter is available only in the cloud-based service.
-IsFavoritesFolderTreeCollapsed	Boolean		The IsFavoritesFolderTreeCollapsed parameter specifies whether to collapse the Favorites folder tree by default in Outlook on the web. Valid values are:
-IsFocusedInboxEnabled	Boolean		This parameter is available only in the cloud-based service.
-IsMailRootFolderTreeCollapsed	Boolean		The IsMailRootFolderTreeCollapsed parameter specifies whether to collapse the Mail root folder tree by default in Outlook on the web. Valid values are:
-IsReplyAllTheDefaultResponse	Boolean		The IsReplyAllTheDefaultResponse parameter specifies whether Reply All is the default response for messages in Outlook on the web. Valid values are:
-LinkPreviewEnabled	Boolean		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:
-MailFolderPaneExpanded	Boolean		The MailFolderPaneExpanded parameter specifies whether the Mail folder pane is expanded by default in Outlook on the web. Valid values are:
-MailSendUndoInterval	Int32		This parameter is available only in the cloud-based service.
-ManuallyPickCertificate	Boolean		This parameter is available only in the cloud-based service.
-NavigationBarWidth	Int32		This parameter is available only in the cloud-based service.
-NavigationPaneViewOption	NavigationPaneView		The NavigationPaneViewOption parameter specifies the default navigation pane view in Outlook on the web. Valid values are:
-NewEnabledPonts	PontType		This parameter is available only in the cloud-based service.
-NewItemNotification	NewItemNotification		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:
-PreferAccessibleContent	Boolean		The PreferAccessibleContent parameter specifies whether to prefer accessible content in Outlook on the web. Valid values are:
-PreviewMarkAsReadBehavior	PreviewMarkAsReadBehavior		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:
-PreviewMarkAsReadDelaytime	Int32		The PreviewMarkAsReadDelaytime parameter specifies the time in seconds to wait before marking an item as Read for the user in Outlook on the web.
-ReadReceiptResponse	ReadReceiptResponse		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:
-ReportJunkSelected	Boolean		This parameter is available only in the cloud-based service.
-SendAddressDefault	String		This parameter is available only in the cloud-based service.
-ShowConversationAsTree	Boolean		The ShowConversationAsTree parameter specifies how to sort messages in the list view in an expanded conversation for the user in Outlook on the web.
-ShowInlinePreviews	Boolean		This parameter is available only in the cloud-based service.
-ShowNotificationBar	Boolean		This parameter is available only in the cloud-based service.
-ShowPreviewTextInListView	Boolean		The ShowPreviewTextInListView parameter specifies whether to show preview text for messages in list view in Outlook on the web. Valid values are:
-ShowReadingPaneOnFirstLoad	Boolean		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:
-ShowSenderOnTopInListView	Boolean		The ShowSenderOnTopInListView parameter specifies whether to show the message sender on top in list view in Outlook on the web. Valid values are:
-ShowUpNext	Boolean		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:
-SignatureHtml	String		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...
-SignatureHtmlBody	String		This parameter is available only in the cloud-based service.
-SignatureName	String		This parameter is available only in the cloud-based service.
-SignatureText	String		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...
-SignatureTextOnMobile	String		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...
-SigningCertificateId	String		This parameter is available only in the cloud-based service.
-SigningCertificateSubject	String		This parameter is available only in the cloud-based service.
-SmimeEncrypt	Boolean		This parameter is available only in the cloud-based service.
-SmimeSign	Boolean		This parameter is available only in the cloud-based service.
-UseDefaultSignatureOnMobile	Boolean		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.
-WebSuggestedRepliesEnabledForUser	Boolean		This parameter is available only in the cloud-based service.
-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.

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