Click to Rate and Give Feedback
TechNet
TechNet Library
Exchange Server
Technical Reference
Transport Cmdlets
 Set-TransportConfig

  Switch on low bandwidth view
Set-TransportConfig

Applies to: Exchange Server 2007 SP1 Topic Last Modified: 2008-05-19

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


Set-TransportConfig [-ClearCategories <$true | $false>] [-Confirm [<SwitchParameter>]] [-DSNConversionMode <UseExchangeDSNs | PreserveDSNBody | DoNotConvert>] [-DomainController <Fqdn>] [-GenerateCopyOfDSNFor <MultiValuedProperty>] [-Instance <TransportConfigContainer>] [-InternalSMTPServers <MultiValuedProperty>] [-JournalingReportNdrTo <SmtpAddress>] [-MaxDumpsterSizePerStorageGroup <ByteQuantifiedSize>] [-MaxDumpsterTime <EnhancedTimeSpan>] [-MaxReceiveSize <Unlimited>] [-MaxRecipientEnvelopeLimit <Unlimited>] [-MaxSendSize <Unlimited>] [-TLSReceiveDomainSecureList <MultiValuedProperty>] [-TLSSendDomainSecureList <MultiValuedProperty>] [-VerifySecureSubmitEnabled <$true | $false>] [-VoicemailJournalingEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]] [-Xexch50Enabled <$true | $false>]

Parameter Required Type Description

ClearCategories

Optional

System.Boolean

This 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 parameter 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 parameter.

DSNConversionMode

Optional

Microsoft.Exchange.Data.Transport.DSNConversionOption

The DSNConversionMode parameter controls how Exchange handles 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

If you set this parameter to UseExchangeDSNs, Exchange will convert the DSNs to the Exchange 2007 DSN format. Any customized text or attachments that the original DSN has will be overwritten.

If you set this parameter to PreserveDSNBody, Exchange will convert the DSNs to Exchange 2007 DSN format, but the text in the DSN message body will be retained.

If you set this parameter to DoNotConvert, Exchange will not modify the DSN, and will deliver it as a standard message.

The default value is UseExchangeDSNs.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

To specify the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to the Active Directory directory service, include the DomainController parameter on the command. The DomainController parameter is not supported on computers that run the Edge Transport server role. The Edge Transport server sole reads and writes only to the local ADAM instance.

GenerateCopyOfDSNFor

Optional

Microsoft.Exchange.Data.MultiValuedProperty

This parameter controls the non-delivery reports (NDRs) that are copied to a mailbox by specifying the delivery status notification (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 2007 organization.

On a Hub Transport server, NDRs are copied to the mailbox that is assigned to the Microsoft Exchange Recipient. On Edge Transport servers, NDRs are copied to the mailbox that is assigned to 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 Microsoft Exchange Recipient or to the external postmaster address if no mailbox is assigned to the Microsoft Exchange Recipient or to the external postmaster address. By default, no mailbox is assigned to the Microsoft Exchange Recipient or to the external postmaster address.

To assign a mailbox to the Microsoft Exchange Recipient, use the MicrosoftExchangeRecipientReplyRecipient parameter in the Set-OrganizationConfig cmdlet. To assign a mailbox to the external postmaster address, create a new mailbox that is named "Postmaster". The default e-mail address policy of the Exchange organization should automatically add an SMTP address of postmaster@<Authoritative domain> to the mailbox.

Instance

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.TransportConfigContainer

This parameter enables you to pass an entire object to the cmdlet to be processed. This parameter is useful in scripts where an entire object must be passed to the cmdlet.

InternalSMTPServers

Optional

Microsoft.Exchange.Data.MultiValuedProperty

This parameter specifies a list of internal Simple Mail Transfer Protocol (SMTP) server IP addresses or IP address ranges that should be ignored by Sender ID and connection filtering.

JournalingReportNdrTo

Optional

Microsoft.Exchange.Data.SmtpAddress

This 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.

MaxDumpsterSizePerStorageGroup

Optional

Microsoft.Exchange.Data.ByteQuantifiedSize

This parameter specifies the maximum size of the transport dumpster on a Hub Transport server. The default value is 18 MB. The valid input range for this parameter is 0 to 2147483647 kilobytes.

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 MaxDumpsterSizePerStorageGroup 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

This 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 the value as a time span: dd.hh:mm:ss, where d = days, h = hours, m = minutes, and s = seconds. 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

This 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:

  • KB (kilobytes)
  • MB (megabytes)
  • GB (gigabytes)

Unqualified values are treated as kilobytes. The valid input range for this parameter is 0 to 2097151 kilobytes. 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

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

MaxSendSize

Optional

Microsoft.Exchange.Data.Unlimited

This 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:

  • KB (kilobytes)
  • MB (megabytes)
  • GB (gigabytes)

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

TLSReceiveDomainSecureList

Optional

Microsoft.Exchange.Data.MultiValuedProperty

This 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 (*) is not supported in the domains that are listed in the TLSReceiveDomainSecureList parameter or in TLSSendDomainSecureList parameter. The default value for both parameters is an empty list ({}).

TLSSendDomainSecureList

Optional

Microsoft.Exchange.Data.MultiValuedProperty

This 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 (*) is not supported in the domains that are listed in TLSSendDomainSecureList parameter or in TLSReceiveSecureList parameter. The default values for both parameters an empty list ({}).

VerifySecureSubmitEnabled

Optional

System.Boolean

The valid values for this parameter are $True or $False. The default value is $False. The VerifySecureSubmitEnabled parameter verifies that e-mail clients that are submitting messages from mailboxes on Mailbox servers are using encrypted MAPI submission. By default, Outlook 2007 uses encrypted MAPI submission to send messages from Exchange 2007 mailboxes. By default previous versions of Outlook do not use encrypted MAPI submission to send messages from an Exchange mailbox. If the VerifySecureSubmitEnabled parameter is set to the value of $True, and Outlook 2007 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 is set to the value of false $False, all MAPI message submissions are marked as secure. Messages that are submitted from mailboxes on the Mailbox server by using any MAPI client are not checked for encrypted MAPI submission. If you use previous Outlook versions in your Exchange organization, you should set VerifySecureSubmitEnabled to $False.

VoicemailJournalingEnabled

Optional

System.Boolean

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

Xexch50Enabled

Optional

System.Boolean

This parameter specifies whether Xexch50 authentication should be enabled for backward compatibility with Exchange 2003 servers. The default value is $True.

WhatIf

Optional

System.Management.Automation.SwitchParameter

The WhatIf parameter instructs the command to simulate the actions that it would take on the object. By using the WhatIf parameter, 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 parameter.

The Set-TransportConfig cmdlet is used to modify configuration information for e-mail transport settings that are applied across the Exchange 2007 organization.

To run the Set-TransportConfig cmdlet, the account you use must be delegated the Exchange Organization Administrator role.

To run the Set-TransportConfig cmdlet on a computer that has the Edge Transport server role installed, you must log on by using an account that is a member of the local Administrators group on that computer.

For more information about permissions, delegating roles, and the rights that are required to administer Exchange 2007, see Permission Considerations.

The first example in the following code shows how to configure the Exchange 2007 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.

The second example in the following code shows how to configure the Exchange 2007 organization to redirect all journaling reports that can't be delivered to the journaling mailbox to the e-mail account journalingndr@contoso.com.

Set-TransportConfig -GenerateCopyOfDsnFor 5.7.1,5.7.2,5.7.3
Set-TransportConfig -JournalingReportNdrTo journalingndr@contoso.com
Tags What's this?: Add a tag
Community Content   What is Community Content?
Add new content RSS  Annotations
-DSNConversionMode      mjbnz ... Thomas Lee   |   Edit   |   Show History
The -DSNConversionMode argument to this cmdlet is not present in SP1 RU3
Processing
© 2009 Microsoft Corporation. All rights reserved. Terms of Use  |  Trademarks  |  Privacy Statement
Page view tracker