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 |
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:
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
|
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:
By default, this parameter is set to
If you set this parameter to If you set this parameter to |
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 |
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 |
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:
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
|
ExternalPostmasterAddress |
Optional |
Microsoft.Exchange.Data.SmtpAddress |
The ExternalPostmasterAddress parameter specifies the
e-mail address in the |
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:
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:
|
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
|
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 |
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:
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
|
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 |
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:
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:
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 |
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 |
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:
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 |
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:
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:
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 |
VoicemailJournalingEnabled |
Optional |
System.Boolean |
The VoicemailJournalingEnabled parameter specifies
whether Unified Messaging voice mail messages are journaled by the
Journaling agent. The default value is |
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
|
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 |