[This topic is in progress.]

Applies to: Exchange Server 2010 SP3, Exchange Server 2010 SP2

Topic Last Modified: 2011-08-30

Use the Set-TransportConfig cmdlet to modify the transport configuration settings for the whole Microsoft Exchange Server 2010 organization.

Syntax

Set-TransportConfig [-Identity <OrganizationIdParameter>] [-ClearCategories <$true | $false>] [-Confirm [<SwitchParameter>]] [-ConvertDisclaimerWrapperToEml <$true | $false>] [-DomainController <Fqdn>] [-DSNConversionMode <UseExchangeDSNs | PreserveDSNBody | DoNotConvert>] [-ExternalDelayDsnEnabled <$true | $false>] [-ExternalDsnDefaultLanguage <CultureInfo>] [-ExternalDsnLanguageDetectionEnabled <$true | $false>] [-ExternalDsnMaxMessageAttachSize <ByteQuantifiedSize>] [-ExternalDsnReportingAuthority <SmtpDomain>] [-ExternalDsnSendHtml <$true | $false>] [-ExternalPostmasterAddress <SmtpAddress>] [-GenerateCopyOfDSNFor <MultiValuedProperty>] [-HeaderPromotionModeSetting <NoCreate | MayCreate | MustCreate>] [-HygieneSuite <Standard | Premium>] [-InternalDelayDsnEnabled <$true | $false>] [-InternalDsnDefaultLanguage <CultureInfo>] [-InternalDsnLanguageDetectionEnabled <$true | $false>] [-InternalDsnMaxMessageAttachSize <ByteQuantifiedSize>] [-InternalDsnReportingAuthority <SmtpDomain>] [-InternalDsnSendHtml <$true | $false>] [-InternalSMTPServers <MultiValuedProperty>] [-JournalingReportNdrTo <SmtpAddress>] [-LegacyJournalingMigrationEnabled <$true | $false>] [-MaxDumpsterSizePerDatabase <ByteQuantifiedSize>] [-MaxDumpsterTime <EnhancedTimeSpan>] [-MaxReceiveSize <Unlimited>] [-MaxRecipientEnvelopeLimit <Unlimited>] [-MaxSendSize <Unlimited>] [-MigrationEnabled <$true | $false>] [-OpenDomainRoutingEnabled <$true | $false>] [-OrganizationFederatedMailbox <SmtpAddress>] [-Rfc2231EncodingEnabled <$true | $false>] [-ShadowHeartbeatRetryCount <Int32>] [-ShadowHeartbeatTimeoutInterval <EnhancedTimeSpan>] [-ShadowMessageAutoDiscardInterval <EnhancedTimeSpan>] [-ShadowRedundancyEnabled <$true | $false>] [-SupervisionTags <MultiValuedProperty>] [-TLSReceiveDomainSecureList <MultiValuedProperty>] [-TLSSendDomainSecureList <MultiValuedProperty>] [-VerifySecureSubmitEnabled <$true | $false>] [-VoicemailJournalingEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]] [-Xexch50Enabled <$true | $false>]

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

Parameters

Parameter Required Type Description

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter

This parameter is available for multi-tenant deployments. It isn't available for on-premises deployments. For more information about multi-tenant deployments, see Multi-Tenant Support.

The Identity parameter specifies the identity of the tenant organization.

ClearCategories

Optional

System.Boolean

The ClearCategories parameter specifies whether to clear Microsoft Office Outlook categories during content conversion. The default value is $true.

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.

ConvertDisclaimerWrapperToEml

Optional

System.Boolean

The ConvertDisclaimerWrapperToEml parameter specifies whether the original message will be added as a TNEF attachment or a regular EML attachment to a disclaimer when all of the following are true:

  • Message is sent to an external user.

  • The sender has signed the message.

  • The message is processed by a Transport rule that adds a disclaimer.

When a Transport rule that adds disclaimers to outbound messages encounters a message signed by the sender, the Transport rule can't add the disclaimer directly to the message. As a result, the disclaimer is sent to the intended recipient with the original message as an attachment. If you set this parameter to $true, the original message is sent as an EML attachment. Otherwise, it is sent as a TNEF attachment. The default value is $false.

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. The DomainController parameter isn't supported on the Edge Transport server role. The Edge Transport server role writes only to the Active Directory Lightweight Directory Services (AD LDS) instance.

DSNConversionMode

Optional

Microsoft.Exchange.Data.DSNConversionOption

The DSNConversionMode parameter controls how Exchange handles delivery status notifications (DSNs) that are generated by earlier versions of Exchange or non-Exchange messaging systems. You can specify one of the following values for this parameter:

  • UseExchangeDSNs

  • PreserveDSNBody

  • DoNotConvert

By default, this parameter is set to UseExchangeDSNs and Exchange converts the DSNs to the Exchange 2010 DSN format. Any customized text or attachments that were associated with the original DSN are overwritten.

If you set this parameter to PreserveDSNBody, Exchange converts the DSNs to Exchange 2010 DSN format. However, the text in the body of the DSN message is retained.

If you set this parameter to DoNotConvert, Exchange does not modify the DSN message. Instead, Exchange 2010 delivers the message as a standard message.

ExternalDelayDsnEnabled

Optional

System.Boolean

The ExternalDelayDsnEnabled parameter specifies whether a delay delivery status notification (DSN) message should be created for external messages that couldn't be immediately delivered. The default value is $true.

ExternalDsnDefaultLanguage

Optional

System.Globalization.CultureInfo

The ExternalDsnDefaultLanguage parameter specifies which Exchange server language should be used by default when you create external DSN messages. The default value is the default Microsoft Windows server language.

ExternalDsnLanguageDetectionEnabled

Optional

System.Boolean

The ExternalDsnLanguageDetectionEnabled parameter specifies whether the server should try to send an external DSN message in the same language as the original message that generated the notification. The default value is $true.

ExternalDsnMaxMessageAttachSize

Optional

Microsoft.Exchange.Data.ByteQuantifiedSize

The ExternalDsnMaxMessageAttachSize parameter specifies the maximum size of the original message attached to an external DSN message. If the original message exceeds this size, only the headers of the original message are included in the DSN message. The default value is 10 megabytes (MB). When you enter a value, qualify the value with one of the following units:

  • B (bytes)

  • KB (kilobytes)

  • MB (megabytes)

  • GB (gigabytes)

Unqualified values are treated as bytes. The valid input range for this parameter is from 0 through 2147483647 bytes. If you specify a value of 0, only the original message headers are included in the external DSN message.

ExternalDsnReportingAuthority

Optional

Microsoft.Exchange.Data.SmtpDomain

The ExternalDsnReportingAuthority parameter specifies what the server name should be in the machine-readable part of the external DSN message. The default value is the authoritative domain specified during installation.

ExternalDsnSendHtml

Optional

System.Boolean

The ExternalDsnSendHtml parameter specifies whether external DSN messages should be sent by using HTML or whether messages should be sent in plain text. The default value is $true.

ExternalPostmasterAddress

Optional

Microsoft.Exchange.Data.SmtpAddress

The ExternalPostmasterAddress parameter specifies the e-mail address in the From header field of an external DSN message. The default value is $null. On a Hub Transport server, the value of the external postmaster e-mail address is postmaster@<defaultaccepteddomain>. If an Edge Transport server hasn't yet been through the EdgeSync process, and the ExternalPostmasterAddress parameter is set to $null, the external postmaster e-mail address on the Edge Transport server is postmaster@<edgetransportserverfqdn>. If an Edge Transport server has completed the EdgeSync process, and the ExternalPostmasterAddress parameter is set to $null, the external postmaster e-mail address on the Edge Transport server is postmaster@<defaultaccepteddomain>. To override the default behavior, you can specify an e-mail address for the ExternalPostMasterAddress parameter.

GenerateCopyOfDSNFor

Optional

Microsoft.Exchange.Data.MultiValuedProperty

The GenerateCopyOfDSNFor parameter controls the non-delivery reports (NDRs) that are copied to a mailbox by specifying the DSN codes that you want to monitor. You must configure the list of monitored DSNs on one Hub Transport server and locally on each Edge Transport server in your Exchange 2010 organization.

On a Hub Transport server, NDRs are copied to the mailbox assigned to the Exchange recipient. On Edge Transport servers, NDRs are copied to the mailbox assigned to the external postmaster address.

DSN codes are entered as x.y.z and are separated by commas. By default, the following DSN codes are monitored:

  • 5.4.8

  • 5.4.6

  • 5.4.4

  • 5.2.4

  • 5.2.0

  • 5.1.4

Although these DSN codes are monitored by default, the associated NDRs aren't copied to the Exchange recipient or to the external postmaster address if no mailbox is assigned to the Exchange recipient or to the external postmaster address. By default, no mailbox is assigned to the Exchange recipient or to the external postmaster address.

To assign a mailbox to the Exchange recipient, use the Set-OrganizationConfig cmdlet with the MicrosoftExchangeRecipientReplyRecipient parameter. To assign a mailbox to the external postmaster address, create a new mailbox postmaster. The default e-mail address policy of the Exchange organization should automatically add an SMTP address of postmaster@<Authoritative domain> to the mailbox.

HeaderPromotionModeSetting

Optional

Microsoft.Exchange.Data.HeaderPromotionMode

The HeaderPromotionModeSetting parameter specifies whether named properties are created for custom X-headers on messages received from outside the Exchange organization. You can use one of the following values:

  • MustCreate   Exchange creates a named property for each new custom X-header.

  • MayCreate   Exchange creates a named property for each new custom X-header on messages received from authenticated senders. No named properties are created for custom X-headers on messages received from unauthenticated senders.

  • NoCreate   Exchange won't create any named properties based on custom X-headers on incoming messages.

HygieneSuite

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.HygieneSuiteEnum

The HygieneSuite parameter is reserved for internal Microsoft use.

InternalDelayDsnEnabled

Optional

System.Boolean

The InternalDelayDsnEnabled parameter specifies whether a delay DSN message should be created for messages sent to or from recipients or senders in the same Exchange organization that couldn't be immediately delivered. The default value is $true.

InternalDsnDefaultLanguage

Optional

System.Globalization.CultureInfo

The InternalDsnDefaultLanguage parameter specifies which Exchange server language should be used by default when you create internal DSN messages. The default value is the default Windows server language.

InternalDsnLanguageDetectionEnabled

Optional

System.Boolean

The InternalDsnLanguageDetectionEnabled parameter specifies whether the server should try to send an internal DSN message in the same language as the original message that generated the notification. The default value is $true.

InternalDsnMaxMessageAttachSize

Optional

Microsoft.Exchange.Data.ByteQuantifiedSize

The InternalDsnMaxMessageAttachSize parameter specifies the maximum size of the original message that generated an internal DSN message. If the original message exceeds this size, only the headers of the original message are included in the DSN message. The default value is 10 MB. When you enter a value, qualify the value with one of the following units:

  • B (bytes)

  • KB (kilobytes)

  • MB (megabytes)

  • GB (gigabytes)

Unqualified values are treated as bytes. The valid input range for this parameter is from 0 through 2147483647 bytes. If you specify a value of 0, only the original message headers are included in the internal DSN message.

InternalDsnReportingAuthority

Optional

Microsoft.Exchange.Data.SmtpDomain

The InternalDsnReportingAuthority parameter specifies what the server name should be in the internal DSN message. The default value is the authoritative domain specified during installation.

InternalDsnSendHtml

Optional

System.Boolean

The InternalDsnSendHtml parameter specifies whether internal DSN messages should be sent by using HTML or whether messages should be sent in plain text. The default is $true.

InternalSMTPServers

Optional

Microsoft.Exchange.Data.MultiValuedProperty

The InternalSMTPServers parameter specifies a list of internal SMTP server IP addresses or IP address ranges that should be ignored by Sender ID and connection filtering.

JournalingReportNdrTo

Optional

Microsoft.Exchange.Data.SmtpAddress

The JournalingReportNdrTo parameter specifies the e-mail address to which journal reports are sent if the journaling mailbox is unavailable. By default, if this parameter is left empty, Exchange continues to try to deliver the journal report to the journaling mailbox.

LegacyJournalingMigrationEnabled

Optional

System.Boolean

The LegacyJournalingMigrationEnabled parameter specifies whether journal messages generated in Microsoft Exchange Server 2003 will be reformatted by Exchange 2010.

The default value is $false.

MaxDumpsterSizePerDatabase

Optional

Microsoft.Exchange.Data.ByteQuantifiedSize

The MaxDumpsterSizePerDatabase parameter specifies the maximum size of the transport dumpster on a Hub Transport server for each database. The default value is 18 MB. The valid input range for this parameter is from 0 through 2147483647 KB.

When you enter a value, qualify the value with one of the following units:

  • KB (kilobytes)

  • MB (megabytes)

  • GB (gigabytes)

  • TB (terabytes)

Unqualified values are treated as kilobytes.

To enable the transport dumpster, the value of the MaxDumpsterSizePerDatabase parameter must be greater than 0, and the value of the MaxDumpsterTime parameter must be greater than 00:00:00.

MaxDumpsterTime

Optional

Microsoft.Exchange.Data.EnhancedTimeSpan

The MaxDumpsterTime parameter specifies how long an e-mail message should remain in the transport dumpster on a Hub Transport server. The default value is seven days.

To specify a value, enter it as a time span: dd.hh:mm:ss where d = days, h = hours, m = minutes, and s = seconds.

For example, to specify 10 days for this parameter, use 10.00:00:00. The valid input range for this parameter is 00:00:00 to 24855.03:14:07.

To enable the transport dumpster, the value of the MaxDumpsterSizePerStorageGroup parameter must be greater than 0, and the value of the MaxDumpsterTime parameter must be greater than 00:00:00.

MaxReceiveSize

Optional

Microsoft.Exchange.Data.Unlimited

The MaxReceiveSize parameter specifies the maximum message size that can be received by recipients in the organization. The default value is 10 MB. When you enter a value, qualify the value with one of the following units:

  • KB (kilobytes)

  • MB (megabytes)

  • GB (gigabytes)

Unqualified values are treated as kilobytes. The valid input range for this parameter is from 0 through 2097151 KB. If you enter a value of Unlimited, no limit is imposed on the message size that can be received by recipients in the organization.

MaxRecipientEnvelopeLimit

Optional

Microsoft.Exchange.Data.Unlimited

The MaxRecipientEnvelopeLimit parameter specifies the maximum number of recipients in a message. The default value is 5000. The valid input range for this parameter is from 0 through 2147483647. If you enter a value of Unlimited, no limit is imposed on the number of recipients in a message. Exchange 2010 treats an unexpanded distribution group as one recipient.

MaxSendSize

Optional

Microsoft.Exchange.Data.Unlimited

The MaxSendSize parameter specifies the maximum message size that can be sent by senders in the organization. The default value is 10 MB. When you enter a value, qualify the value with one of the following units:

  • KB (kilobytes)

  • MB (megabytes)

  • GB (gigabytes)

Unqualified values are treated as kilobytes. The valid input range for this parameter is from 0 through 2097151 KB. If you enter a value of Unlimited, no limit is imposed on the message size that can be sent by senders in the organization.

MigrationEnabled

Optional

System.Boolean

The MigrationEnabled parameter is reserved for internal Microsoft use.

OpenDomainRoutingEnabled

Optional

System.Boolean

The OpenDomainRoutingEnabled parameter is reserved for internal Microsoft use.

OrganizationFederatedMailbox

Optional

Microsoft.Exchange.Data.SmtpAddress

The OrganizationFederatedMailbox parameter specifies the SMTP address of the federated mailbox used for federated delivery with other organizations.

Rfc2231EncodingEnabled

Optional

System.Boolean

The Rfc2231EncodingEnabled parameter specifies whether the RFC 2231 encoding of MIME parameters for outbound messages is enabled in your organization.

ShadowHeartbeatRetryCount

Optional

System.Int32

The ShadowHeartbeatRetryCount parameter specifies the number of time-outs a server waits before deciding that a primary server has failed and assumes ownership of shadow messages in the shadow queue for the primary server that's unreachable.

The default value is 3 in Exchange 2010 RTM. The default value is 12 in Exchange 2010 SP1 or later.

ShadowHeartbeatTimeoutInterval

Optional

Microsoft.Exchange.Data.EnhancedTimeSpan

The ShadowHeartbeatTimeoutInterval parameter specifies the amount of time a server waits before establishing a connection to a primary server to query the discard status of shadow messages.

The default value is 300 seconds in Exchange 2010 RTM. The default value is 900 seconds in Exchange 2010 SP1 or later.

ShadowMessageAutoDiscardInterval

Optional

Microsoft.Exchange.Data.EnhancedTimeSpan

The ShadowMessageAutoDiscardInterval specifies how long a server retains discard events for shadow messages. A primary server queues discard events until queried by the shadow server. However, if the shadow server doesn't query the primary server for the duration specified in this parameter, the primary server deletes the queued discard events.

The default value is 2 days.

ShadowRedundancyEnabled

Optional

System.Boolean

The ShadowRedundancyEnabled parameter specifies whether shadow redundancy is enabled in the organization.

SupervisionTags

Optional

Microsoft.Exchange.Data.MultiValuedProperty

The SupervisionTags parameter specifies the various tags that are used for transport supervision in the organization.

When you install Exchange 2010, two tags, Allow and Reject, are created by default.

TLSReceiveDomainSecureList

Optional

Microsoft.Exchange.Data.MultiValuedProperty

The TLSReceiveDomainSecureList parameter specifies the domains from which you want to receive domain secured e-mail by using mutual Transport Layer Security (TLS) authentication. To fully support mutual TLS authentication, you must also perform the following steps:

  • Enable Domain Security (Mutual Auth TLS) and the TLS authentication method on the Receive connectors that receive messages from the domains that you specified with the TLSReceiveDomainSecureList parameter.

  • Specify the domains to which you want to send domain secured e-mail by using the TLSSendDomainSecureList parameter.

  • Enable Domain Security (Mutual Auth TLS) on the Send connectors that send messages to the domains that you specified in the TLSSendDomainSecureList parameter.

Multiple domains may be separated by commas. The wildcard character (*) isn't supported in the domains listed in the TLSReceiveDomainSecureList parameter or in the TLSSendDomainSecureList parameter. The default value for both parameters is an empty list ({}).

TLSSendDomainSecureList

Optional

Microsoft.Exchange.Data.MultiValuedProperty

The TLSSendDomainSecureList parameter specifies the domains from which you want to send domain secured e-mail by using mutual TLS authentication. To fully support mutual TLS authentication, you must also perform the following steps:

  • Enable Domain Security (Mutual Auth TLS) on the Send connectors that send messages to the domains that you specified in the TLSSendDomainSecureList parameter.

  • Specify the domains from which you want to receive domain secured e-mail by using the TLSReceiveDomainSecureList parameter.

  • Enable Domain Security (Mutual Auth TLS) and the TLS authentication method on the Receive connectors that receive messages from the domains that you specified in the TLSReceiveDomainSecureList parameter.

Multiple domains may be separated by commas. The wildcard character (*) isn't supported in the domains listed in the TLSSendDomainSecureList parameter or in the TLSReceiveSecureList parameter. The default values for both parameters are an empty list ({}).

VerifySecureSubmitEnabled

Optional

System.Boolean

The VerifySecureSubmitEnabled parameter verifies that e-mail clients submitting messages from mailboxes on Mailbox servers are using encrypted MAPI submission. The valid values for this parameter are $true or $false. The default value is $false. By default, Microsoft Office Outlook 2007 uses encrypted MAPI submission to send messages from Exchange 2010 mailboxes. By default, previous versions of Outlook don't use encrypted MAPI submission to send messages from an Exchange mailbox. If the VerifySecureSubmitEnabled parameter is set to the value of $true, and Outlook 2010 is used to submit the message, the message is marked as secure. If a previous version of Outlook is used to submit the message, the message is marked as anonymous. If the VerifySecureSubmitEnabled parameter is set to the value of $false, all MAPI message submissions are marked as secure. Messages submitted from mailboxes on the Mailbox server by using any MAPI client aren't checked for encrypted MAPI submission. If you use previous Outlook versions in your Exchange organization, you should set the VerifySecureSubmitEnabled parameter to $false.

VoicemailJournalingEnabled

Optional

System.Boolean

The VoicemailJournalingEnabled parameter specifies whether Unified Messaging voice mail messages are journaled by the Journaling agent. The default value is $true.

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.

Xexch50Enabled

Optional

System.Boolean

The Xexch50Enabled parameter specifies whether Xexch50 authentication should be enabled for backward compatibility with computers running Exchange 2003. The default value is $true.

Input Types

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.

Return Types

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.

Examples

EXAMPLE 1

This example configures the Exchange 2010 organization to forward all DSN messages that have the DSN codes 5.7.1, 5.7.2, and 5.7.3 to the postmaster e-mail account.

Copy Code
Set-TransportConfig -GenerateCopyOfDSNFor 5.7.1,5.7.2,5.7.3

EXAMPLE 2

This example configures the Exchange 2010 organization to redirect all journaling reports that can't be delivered to the journaling mailbox to the e-mail account journalingndr@contoso.com.

Copy Code
Set-TransportConfig -JournalingReportNdrTo journalingndr@contoso.com