This topic has not yet been rated - Rate this topic

Set-RemoteDomain

Exchange 2010

Applies to: Exchange Server 2010

Topic Last Modified: 2011-03-19

Use the Set-RemoteDomain cmdlet to configure a managed connection for a remote domain. When you set a remote domain, you can control mail flow with more precision, specify message formatting and policy, and specify acceptable character sets for messages sent to or received from the remote domain.

Syntax


Set-RemoteDomain -Identity <RemoteDomainIdParameter> [-AllowedOOFType <External | InternalLegacy | ExternalLegacy | None>] [-AutoForwardEnabled <$true | $false>] [-AutoReplyEnabled <$true | $false>] [-CharacterSet <String>] [-Confirm [<SwitchParameter>]] [-ContentType <MimeHtmlText | MimeText | MimeHtml>] [-DeliveryReportEnabled <$true | $false>] [-DisplaySenderName <$true | $false>] [-DomainController <Fqdn>] [-LineWrapSize <Unlimited>] [-MeetingForwardNotificationEnabled <$true | $false>] [-Name <String>] [-NDREnabled <$true | $false>] [-NonMimeCharacterSet <String>] [-TNEFEnabled <Nullable>] [-WhatIf [<SwitchParameter>]]

Parameters

Parameter	Required	Type	Description
Identity	Required	Microsoft.Exchange.Configuration.Tasks.RemoteDomainIdParameter	The Identity parameter specifies the display name of the remote domain. The length of the name can't exceed 64 characters.
AllowedOOFType	Optional	Microsoft.Exchange.Data.Directory.SystemConfiguration.AllowedOOFType	The AllowedOOFType parameter specifies the type of out-of-office notification returned to users at the remote domain. Valid values are `External`, `ExternalLegacy`, `None`, and `InternalLegacy`. The default value is `External`.
AutoForwardEnabled	Optional	System.Boolean	The AutoForwardEnabled parameter specifies whether to allow messages that are auto-forwarded by client e-mail programs in your organization. Setting this parameter to `$true` enables auto-forwarded messages to be delivered to the remote domain. The default value is `$false`.
AutoReplyEnabled	Optional	System.Boolean	The AutoReplyEnabled parameter specifies whether to allow messages that are automatic replies from client e-mail programs in your organization. Setting this parameter to `$true` enables automatic replies to be delivered to the remote domain. The default value is `$false`.
CharacterSet	Optional	System.String	The CharacterSet parameter specifies a character set for this remote domain. The character set that you specify is only used for MIME messages that don't have their own character set specified. Setting this parameter doesn't overwrite character sets already specified in the outbound mail. For a list of valid character set names, see Supported Character Sets for Remote Domain Configuration. To remove the character set value, set the value to `$null`.
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.
ContentType	Optional	Microsoft.Exchange.Data.Directory.SystemConfiguration.ContentType	The ContentType parameter specifies the outbound message content type and formatting. Valid values for this parameter are `MimeHtmlText`, `MimeText`, or `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 is 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. The default value is `MimeHtmlText`.
DeliveryReportEnabled	Optional	System.Boolean	The DeliveryReportEnabled parameter specifies whether to allow delivery reports from client software in your organization to the remote domain. The default value is `$true`.
DisplaySenderName	Optional	System.Boolean	The DisplaySenderName parameter specifies whether to display the sender name. Valid values for this parameter are `$true` or `$false`. The default value is `$true`. This parameter is used for older versions of Exchange and should only be set under the direction of Microsoft Customer Service and Support.
DomainController	Optional	Microsoft.Exchange.Data.Fqdn	The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to Active Directory.
LineWrapSize	Optional	Microsoft.Exchange.Data.Unlimited	The LineWrapSize parameter specifies the line-wrap size for outbound messages. The parameter takes an integer from 0 through 132, or you can overload the parameter by setting the value to `unlimited`. The default value is `unlimited`.
MeetingForwardNotificationEnabled	Optional	System.Boolean	The MeetingForwardNotificationEnabled parameter specifies whether to enable meeting forward notifications. When this parameter is enabled, meeting requests forwarded to recipients in the remote domain generate a meeting forward notification to the meeting organizer. When this parameter is disabled, meeting requests forwarded to recipients in the remote domain won't generate a meeting forward notification to the meeting organizer. Valid values for this parameter are `$true` or `$false`. The default value is `$true`.
Name	Optional	System.String	The Name parameter specifies a unique name for a remote domain object.
NDREnabled	Optional	System.Boolean	The NDREnabled parameter specifies whether to allow non-delivery reports (NDRs) from your organization. Setting this parameter to `$false` suppresses NDRs to the remote domain. The default value is `$true`.
NonMimeCharacterSet	Optional	System.String	The NonMimeCharacterSet parameter specifies a character set for this remote domain. The character set that you specify is only used for non-MIME (RFC 822 text) messages that don't have their own character set specified. Setting this parameter doesn't overwrite character sets already specified in the outbound mail. For a list of valid character set names, see Supported Character Sets for Remote Domain Configuration. To remove the character set value, set the value to `$null`.
TNEFEnabled	Optional	System.Nullable	The TNEFEnabled parameter specifies whether Transport Neutral Encapsulation Format (TNEF) message encoding is used on messages sent to the remote domain. Valid values for this parameter are `$true`, `$false`, or `$null`. The action associated with each value is as follows: `$true` TNEF encoding is used on all messages sent to the remote domain. `$false` TNEF encoding isn't used on any messages sent to the remote domain. `$null` TNEF encoding isn't specified for the remote domain. TNEF encoding for recipients in the remote domain may be specified by the following: Value of the UseMapiRichTextFormat parameter for any mail user or mail contact objects Sender's per-recipient settings in Microsoft Office Outlook Sender's default Internet message settings in Outlook The default value is `$null`.
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.

Detailed Description

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 "Remote domains" entry in the Transport Permissions topic.

Examples

EXAMPLE 1

This example performs the following actions:

It disables out-of-office notifications to the remote domain.
It suppresses read receipts sent from clients in your organization to the remote domain.
It enables TNEF message data on messages sent to the remote domain.

Set-RemoteDomain -Identity Contoso -AllowedOOFType None -DeliveryReportEnabled $false -TNEFEnabled $true

EXAMPLE 2

This example queries Active Directory for all remote domains for which auto replies are disabled. Using the pipelining feature, it also disables auto forwards and NDRs to those domains.

Get-RemoteDomain | Where {$_.AutoReplyEnabled -eq $false} | Set-RemoteDomain -AutoForwardEnabled $false -NDREnabled $false

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)