Any suggestions? Export (0) Print
Expand All

Set-MailboxMessageConfiguration

 

Applies to: Exchange Online, Exchange Server 2016

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

Use the Set-MailboxMessageConfiguration cmdlet to configure the Outlook on the web settings that are applied to specific mailboxes.

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

Set-MailboxMessageConfiguration -Identity <MailboxIdParameter> [-AfterMoveOrDeleteBehavior <OpenPreviousItem | OpenNextItem | ReturnToView>] [-AlwaysShowBcc <$true | $false>] [-AlwaysShowFrom <$true | $false>] [-AutoAddSignature <$true | $false>] [-AutoAddSignatureOnMobile <$true | $false>] [-AutoAddSignatureOnReply <$true | $false>] [-CheckForForgottenAttachments <$true | $false>] [-Confirm [<SwitchParameter>]] [-ConversationSortOrder <Chronological | Tree | NewestOnTop | NewestOnBottom | ChronologicalNewestOnTop | ChronologicalNewestOnBottom | TreeNewestOnBottom>] [-DefaultFontColor <String>] [-DefaultFontFlags <Normal | Bold | Italic | Underline | All>] [-DefaultFontName <String>] [-DefaultFontSize <Int32>] [-DefaultFormat <Html | PlainText>] [-DomainController <Fqdn>] [-EmailComposeMode <Inline | SeparateForm>] [-EmptyDeletedItemsOnLogoff <$true | $false>] [-GlobalReadingPanePosition <Off | Right | Bottom>] [-HideDeletedItems <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-IsFavoritesFolderTreeCollapsed <$true | $false>] [-IsMailRootFolderTreeCollapsed <$true | $false>] [-IsReplyAllTheDefaultResponse <$true | $false>] [-LinkPreviewEnabled <$true | $false>] [-MailFolderPaneExpanded <$true | $false>] [-NavigationPaneViewOption <Default | MailFolders | PeopleFolders | Groups | PinnedMailFolders>] [-NewItemNotification <None | Sound | EMailToast | VoiceMailToast | FaxToast | All>] [-PreviewMarkAsReadBehavior <Delayed | OnSelectionChange | Never>] [-PreviewMarkAsReadDelaytime <Int32>] [-ReadReceiptResponse <DoNotAutomaticallySend | AlwaysSend | NeverSend>] [-SendAddressDefault <String>] [-ShowConversationAsTree <$true | $false>] [-ShowPreviewTextInListView <$true | $false>] [-ShowReadingPaneOnFirstLoad <$true | $false>] [-ShowSenderOnTopInListView <$true | $false>] [-SignatureHtml <String>] [-SignatureText <String>] [-SignatureTextOnMobile <String>] [-UseDefaultSignatureOnMobile <$true | $false>] [-WhatIf [<SwitchParameter>]]

This example sets items deleted from a conversation thread to not show in the list view of the conversation in Outlook on the web for Kai's mailbox.

Set-MailboxMessageConfiguration kai@contoso.com -HideDeletedItems $true

This example sets the compose email message form to always show the Bcc field in Outlook on the web for Kai's mailbox.

Set-MailboxMessageConfiguration kai@contoso.com -AlwaysShowBcc $true

The Set-MailboxMessageConfiguration cmdlet configures Outlook on the web settings for the specified mailbox. These settings include email signature, message format, message options, read receipts, reading pane, and conversations. These settings are not used in MicrosoftOutlook, Exchange ActiveSync, or other email clients. These settings are applied in Outlook on the web only. Settings that contain the word Mobile are applied in MicrosoftOWA for Devices only.

You need to be assigned permissions before you can run this cmdlet. Although all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they're not included in the permissions assigned to you. To see what permissions you need, see the "User options" entry in the Clients and mobile devices permissions topic.

 

Parameter Required Type Description

Identity

Required

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

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

For example:

  • Name

  • Display name

  • Alias

  • Distinguished name (DN)

  • Canonical DN

  • <domain name>\<account name>

  • Email address

  • GUID

  • LegacyExchangeDN

  • SamAccountName

  • User ID or user principal name (UPN)

AfterMoveOrDeleteBehavior

Optional

Microsoft.Exchange.Data.Storage.Management.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:

  • OpenPreviousItem

  • OpenNextItem

  • ReturnToView

The default value is OpenNextItem.

AlwaysShowBcc

Optional

System.Boolean

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.

AlwaysShowFrom

Optional

System.Boolean

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.

AutoAddSignature

Optional

System.Boolean

The AutoAddSignature parameter automatically adds the email signature specified by the SignatureText or SignatureHTML parameters to messages 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 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.

AutoAddSignatureOnMobile

Optional

System.Boolean

The AutoAddSignatureOnMobile parameter automatically adds the signature specified by the SignatureTextOnMobile parameter to messages when the user creates messages in OWA for Devices.

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

AutoAddSignatureOnReply

Optional

System.Boolean

PARAMVALUE: $true | $false

CheckForForgottenAttachments

Optional

System.Boolean

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.

Confirm

Optional

System.Management.Automation.SwitchParameter

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.

ConversationSortOrder

Optional

Microsoft.Exchange.Data.Storage.Management.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:

  • Chronological

  • Tree

  • NewestOnTop

  • NewestOnBottom

  • ChronologicalNewestOnTop

  • ChronologicalNewestOnBottom

  • TreeNewestOnBottom

The default value is ChronologicalNewestOnTop.

DefaultFontColor

Optional

System.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.

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

DefaultFontFlags

Optional

Microsoft.Exchange.Data.Storage.Management.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:

  • Normal

  • Bold

  • Italic

  • Underline

  • All

The default value is Normal.

DefaultFontName

Optional

System.String

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.

DefaultFontSize

Optional

System.Int32

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.

DefaultFormat

Optional

Microsoft.Exchange.Data.Storage.Management.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.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

This parameter is available only in on-premises Exchange 2016.

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.

EmailComposeMode

Optional

Microsoft.Exchange.Data.Storage.Management.EmailComposeMode

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.

EmptyDeletedItemsOnLogoff

Optional

System.Boolean

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.

GlobalReadingPanePosition

Optional

Microsoft.Exchange.Data.Storage.Management.MailReadingPanePosition

PARAMVALUE: Off | Right | Bottom

HideDeletedItems

Optional

System.Boolean

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.

IgnoreDefaultScope

Optional

System.Management.Automation.SwitchParameter

The IgnoreDefaultScope switch tells the command to ignore the default recipient scope setting for the Exchange Management Shell session, and to use the entire forest as the scope. This allows the command to access Active Directory objects that aren't currently available in the default scope.

Using the IgnoreDefaultScope switch 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.

IsFavoritesFolderTreeCollapsed

Optional

System.Boolean

PARAMVALUE: $true | $false

IsMailRootFolderTreeCollapsed

Optional

System.Boolean

PARAMVALUE: $true | $false

IsReplyAllTheDefaultResponse

Optional

System.Boolean

PARAMVALUE: $true | $false

LinkPreviewEnabled

Optional

System.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:

  • $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.

MailFolderPaneExpanded

Optional

System.Boolean

PARAMVALUE: $true | $false

NavigationPaneViewOption

Optional

Microsoft.Exchange.Data.Storage.Management.NavigationPaneView

PARAMVALUE: Default | MailFolders | PeopleFolders | Groups | PinnedMailFolders

NewItemNotification

Optional

Microsoft.Exchange.Data.Storage.Management.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:

  • Sound

  • EMailToast

  • VoiceMailToast

  • FaxToast

  • None

  • All

The default value is All.

PreviewMarkAsReadBehavior

Optional

Microsoft.Exchange.Data.Storage.Management.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:

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

  • OnSelectionChange

  • Never

The default value is OnSelectionChange.

PreviewMarkAsReadDelaytime

Optional

System.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.

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.

ReadReceiptResponse

Optional

Microsoft.Exchange.Data.Storage.Management.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:

  • DoNotAutomaticallySend

  • AlwaysSend

  • NeverSend

The default value is DoNotAutomaticallySend.

SendAddressDefault

Optional

System.String

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, bob@contoso.com.

  • 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-SendAddress -Mailbox <mailbox>.

ShowConversationAsTree

Optional

System.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.

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

ShowPreviewTextInListView

Optional

System.Boolean

PARAMVALUE: $true | $false

ShowReadingPaneOnFirstLoad

Optional

System.Boolean

PARAMVALUE: $true | $false

ShowSenderOnTopInListView

Optional

System.Boolean

PARAMVALUE: $true | $false

SignatureHtml

Optional

System.String

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.

SignatureText

Optional

System.String

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.

SignatureTextOnMobile

Optional

System.String

The SignatureTextOnMobile parameter specifies the email signature that's available in messages created by the user in OWA for Devices. This parameter supports all Unicode characters.

To automatically add the email signature to messages created by the user in OWA for Devices, the AutoAddSignatureOnMobile parameter must be set to the value $true.

UseDefaultSignatureOnMobile

Optional

System.Boolean

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

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

WhatIf

Optional

System.Management.Automation.SwitchParameter

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.

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.

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.

 
Show:
© 2016 Microsoft