Remote Domains

Remote domains define settings for mail flow based on the destination domain of each email message. All organisations have a default remote domain named "Default" that's applied to the domain "*". The default remote domain applies the same settings to all email messages regardless of the destination domain. However, you can configure specific settings for a specific destination domain.

For example, suppose your organisation has a business partnership with a company called Fabrikam, and regulatory compliance rules restrict the types of communication that can occur between Fabrikam and your cloud-based organisation. You can define a remote domain for fabrikam.com and specify the following settings for messages sent from your organisation to the fabrikam.com domain:

You configure or modify the settings of the remote domain with the Set-RemoteDomain cmdlet. The following parameters are available.

Note If you create a remote domain for a specific destination domain, and the default settings for all destination domains conflict with the same setting of the specific remote domain, the setting of the specific remote domain overrides the default settings for all destination domains.

Parameter

Default value

Description

AllowedOOFType

External

In Windows PowerShell, use this parameter to specify the type of automatic replies or OOF notifications that are returned to users in the destination domain. Valid values are External, ExternalLegacy, InternalLegacy, and None.

External allows only external auto-replies to be sent to the destination domain. Internal auto-replies or auto-replies that aren't designated as external aren't delivered.

ExternalLegacy allows the following types of auto-replies to be sent to the destination domain:

Auto-replies that aren't designated as internal or external.

External auto-replies.

InternalLegacy allows the following types of auto-replies to be sent to the destination domain:

Auto-replies that aren't designated as internal or external.

Internal auto-replies.

None allows no auto-replies to be sent to the destination domain.

Only certain email clients, such as Outlook Web App or Microsoft Office Outlook 2007 or later can designate auto-replies as internal or external.

AutoForwardEnabled

True

Use this parameter to allow or suppress messages that are auto-forwarded by client email programs in your organisation. Setting this parameter to $false prevents auto-forwarded messages from being delivered to the destination domain.

Use this parameter to allow or suppress automatic replies that are generated by inbox rules that your users set in their email client. Setting this parameter to $false prevents automatic replies from being generated.

CharacterSet

Iso-8859-1 or blank

Use this parameter to specify a character set of last resort for MIME messages sent to this domain. The character set that you specify will be used only for MIME messages that don't have their own character set specified. Setting this parameter won't overwrite character sets that are already specified in the message. For a list of valid character set names, see Supported Character Sets for Remote Domain Configuration. If you don't want to specify a character set, set the value to $null.

ContentType

MimeHtmlText

Use this parameter to define the outbound message content type and formatting. Valid values for this parameter are MimeHtmlText, MimeText, and MimeHtml.

MimeHtmlText converts messages to MIME messages that use HTML formatting, unless the original message is a text message. If the original message is a text message, the outbound message will be a MIME message that uses text formatting.

MimeText converts all messages to MIME messages that use text formatting.

MimeHtml converts all messages to MIME messages that use HTML formatting.

DeliveryReportEnabled

True

Use this parameter to allow or suppress delivery reports from client email programs in your organisation to the destination domain.

DisplaySenderName

True

This parameter is used for older versions of Microsoft Exchange and should only be changed under direction of Microsoft support.

LineWrapSize

Unlimited

Use this parameter to specify the maximum number of characters permitted on each line of text in outbound messages. Valid values for this parameter are integers up to 132. If you don't want to specify a line wrap size, use the value unlimited.

MeetingForwardNotificationEnabled

False

Use this parameter to enable or disable notifications to the meeting organiser that a meeting request has been forwarded. Valid values for this parameter are $true or $false.

$True: Meeting requests that are forwarded to recipients in the destination domain generate a notification to the meeting organiser.

$False: Meeting requests that are forwarded to recipients in the destination domain don't generate a notification to the meeting organiser.

NDREnabled

True

Use this parameter to allow or suppress non-delivery reports (NDRs) from your organisation. Setting this parameter to $false suppresses NDRs to the destination domain.

NonMimeCharacterSet

Iso-8859-1 or blank

Use this parameter to specify a character set of last resort for plain text messages sent to this domain. The character set that you specify will be used only for plain text messages that don't have their own character set specified. Setting this parameter won't overwrite character sets that are already specified in the outbound mail. For a list of valid character set names, see Supported Character Sets for Remote Domain Configuration. If you don't want to specify a character set, set the value to $null.

TargetDeliveryDomain

False

This parameter specifies the email domain that's used when generating target addresses for new mail users in a cross-premises deployment scenario. In a cross-premises deployment, the remote user mailboxes are represented as mail users.

TNEFEnabled

blank

Use this parameter to control whether Transport Neutral Encapsulation Format (TNEF) message encoding is used on messages that are sent to the destination domain. A TNEF-encoded message contains a plain text version of the message, and a binary attachment that packages parts of the message. The binary attachment may include special Outlook features, such as voting buttons, meeting requests and custom forms. Valid values for this parameter are $true, $false, and $null.

$True: TNEF encoding is used on all messages that are sent to the destination domain.

$False: TNEF encoding isn't used on any messages that are sent to the destination domain.

$Null: TNEF encoding isn't specified for the destination domain. The TNEF settings are controlled by the message sender or the message recipient.

TrustedMailInboundEnabled

False

This parameter trusts messages received from senders in the remote domain. If you set this parameter to $true, all incoming messages from senders in the remote domain are considered safe, so the messages bypass content and recipient filtering.

We recommend that you set this parameter to $true for cross-premises deployment scenarios.

TrustedMailOutboundEnabled

False

This parameter specifies the remote domain as a trusted domain. We recommend that you set this parameter to $true for cross-premises deployment scenarios.

UseSimpleDisplayName

False

This parameter controls whether the sender's simple display name appears in the From field of messages sent to the domain. Setting this parameter to $true displays the sender's simple display name in the From field for messages sent to this remote domain. You can use the simple display name as an alternative to the display name if the display name contains internal information that's inappropriate for external recipients. Note that in the cloud-based service, the simple display name of a mailbox isn't populated by default.