Export (0) Print
Expand All
Expand Minimize

Set-MailboxMessageConfiguration

 

Applies to: Exchange Server 2013, Exchange Online

Topic Last Modified: 2014-03-31

This cmdlet is available in on-premises Exchange Server 2013 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 Microsoft Outlook Web App settings that are applied to specific mailboxes.

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

Set-MailboxMessageConfiguration -Identity <MailboxIdParameter> [-AfterMoveOrDeleteBehavior <OpenPreviousItem | OpenNextItem | ReturnToView>] [-AlwaysShowBcc <$true | $false>] [-AlwaysShowFrom <$true | $false>] [-AutoAddSignature <$true | $false>] [-AutoAddSignatureOnMobile <$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>] [-HideDeletedItems <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-NewItemNotification <None | Sound | EMailToast | VoiceMailToast | FaxToast | All>] [-PreviewMarkAsReadBehavior <Delayed | OnSelectionChange | Never>] [-PreviewMarkAsReadDelaytime <Int32>] [-ReadReceiptResponse <DoNotAutomaticallySend | AlwaysSend | NeverSend>] [-SendAddressDefault <String>] [-ShowConversationAsTree <$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 Web App 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 Web App for Kai's mailbox.

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

The Set-MailboxMessageConfiguration cmdlet configures Outlook Web App 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 Microsoft Outlook, Exchange ActiveSync, or other email clients. These settings are applied in Outlook Web App only. Settings that contain the word Mobile are applied in Microsoft OWA 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. You can use any value that uniquely identifies the mailbox.

For example:

  • Alias

  • Distinguished name (DN)

  • GUID

  • Name

  • Display name

  • LegacyExchangeDN

  • Email address

AfterMoveOrDeleteBehavior

Optional

Microsoft.Exchange.Data.Storage.Management.AfterMoveOrDeleteBehavior

The AfterMoveOrDeleteBehavior parameter specifies the behavior after moving or deleting an email item in Outlook Web App. 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 Web App.

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 Web App.

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 Web App.

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.

CheckForForgottenAttachments

Optional

System.Boolean

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

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 causes the command to pause processing and requires you to acknowledge what the command will do before processing continues. You don't have to specify a value with the Confirm switch.

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 Web App. 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 Web App. 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 Web App. 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 Web App.

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 Web App.

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 Web App. 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 2013.

The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to Active Directory.

EmailComposeMode

Optional

Microsoft.Exchange.Data.Storage.Management.EmailComposeMode

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

  • Inline   New messages and replies are created in a new browser window.

  • SeparateForm   New messages and replies are created in the preview pane.

The default value is Inline.

EmptyDeletedItemsOnLogoff

Optional

System.Boolean

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

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

HideDeletedItems

Optional

System.Boolean

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

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

IgnoreDefaultScope

Optional

System.Management.Automation.SwitchParameter

The IgnoreDefaultScope parameter instructs the command to ignore the default recipient scope setting for the Exchange Management Shell session and use the entire forest as the scope. This allows the command to access Active Directory objects that aren't currently in the default scope. Using the IgnoreDefaultScope parameter 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.

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 Web App. 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 Web App. 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 Web App.

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 Web App. 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 Web App.

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 Web App.

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

SignatureHtml

Optional

System.String

The SignatureHtml parameter specifies the email signature that's available to the user in HTML-formatted messages in Outlook Web App. 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 Web App, 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 Web App. This parameter supports all Unicode characters.

To automatically add the email signature to plain text messages created by the user in Outlook Web App, 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 Microsoft Outlook.

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

WhatIf

Optional

System.Management.Automation.SwitchParameter

The WhatIf switch instructs the command to simulate the actions that it would take on the object. By using the WhatIf switch, you can view what changes would occur without having to apply any of those changes. You don't have to specify a value with the WhatIf 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.

 
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft