Share via


Set-TransportServer

 

Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3

Use the Set-TransportServer cmdlet to set the transport configuration options for computers that have the Hub Transport server role or Edge Transport server role installed.

Syntax

Set-TransportServer -Identity <ServerIdParameter> [-AntispamAgentsEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-ConnectivityLogEnabled <$true | $false>] [-ConnectivityLogMaxAge <EnhancedTimeSpan>] [-ConnectivityLogMaxDirectorySize <Unlimited>] [-ConnectivityLogMaxFileSize <Unlimited>] [-ConnectivityLogPath <LocalLongFullPath>] [-ContentConversionTracingEnabled <$true | $false>] [-DelayNotificationTimeout <EnhancedTimeSpan>] [-DomainController <Fqdn>] [-ExternalDelayDsnEnabled <$true | $false>] [-ExternalDNSAdapterEnabled <$true | $false>] [-ExternalDNSAdapterGuid <Guid>] [-ExternalDNSProtocolOption <Any | UseUdpOnly | UseTcpOnly>] [-ExternalDNSServers <MultiValuedProperty>] [-ExternalDsnDefaultLanguage <CultureInfo>] [-ExternalDsnLanguageDetectionEnabled <$true | $false>] [-ExternalDsnMaxMessageAttachSize <ByteQuantifiedSize>] [-ExternalDsnReportingAuthority <SmtpDomain>] [-ExternalDsnSendHtml <$true | $false>] [-ExternalIPAddress <IPAddress>] [-ExternalPostmasterAddress <Nullable>] [-InternalDelayDsnEnabled <$true | $false>] [-InternalDNSAdapterEnabled <$true | $false>] [-InternalDNSAdapterGuid <Guid>] [-InternalDNSProtocolOption <Any | UseUdpOnly | UseTcpOnly>] [-InternalDNSServers <MultiValuedProperty>] [-InternalDsnDefaultLanguage <CultureInfo>] [-InternalDsnLanguageDetectionEnabled <$true | $false>] [-InternalDsnMaxMessageAttachSize <ByteQuantifiedSize>] [-InternalDsnReportingAuthority <SmtpDomain>] [-InternalDsnSendHtml <$true | $false>] [-IntraOrgConnectorProtocolLoggingLevel <None | Verbose>] [-MaxConcurrentMailboxDeliveries <Int32>] [-MaxConcurrentMailboxSubmissions <Int32>] [-MaxConnectionRatePerMinute <Int32>] [-MaxOutboundConnections <Unlimited>] [-MaxPerDomainOutboundConnections <Unlimited>] [-MessageExpirationTimeout <EnhancedTimeSpan>] [-MessageRetryInterval <EnhancedTimeSpan>] [-MessageTrackingLogEnabled <$true | $false>] [-MessageTrackingLogMaxAge <EnhancedTimeSpan>] [-MessageTrackingLogMaxDirectorySize <Unlimited>] [-MessageTrackingLogMaxFileSize <Unlimited>] [-MessageTrackingLogPath <LocalLongFullPath>] [-MessageTrackingLogSubjectLoggingEnabled <$true | $false>] [-OutboundConnectionFailureRetryInterval <EnhancedTimeSpan>] [-PickupDirectoryMaxHeaderSize <ByteQuantifiedSize>] [-PickupDirectoryMaxMessagesPerMinute <Int32>] [-PickupDirectoryMaxRecipientsPerMessage <Int32>] [-PickupDirectoryPath <LocalLongFullPath>] [-PipelineTracingEnabled <$true | $false>] [-PipelineTracingPath <LocalLongFullPath>] [-PipelineTracingSenderAddress <Nullable>] [-PoisonMessageDetectionEnabled <$true | $false>] [-PoisonThreshold <Int32>] [-QueueMaxIdleTime <EnhancedTimeSpan>] [-ReceiveProtocolLogMaxAge <EnhancedTimeSpan>] [-ReceiveProtocolLogMaxDirectorySize <Unlimited>] [-ReceiveProtocolLogMaxFileSize <Unlimited>] [-ReceiveProtocolLogPath <LocalLongFullPath>] [-RecipientValidationCacheEnabled <$true | $false>] [-ReplayDirectoryPath <LocalLongFullPath>] [-RootDropDirectoryPath <String>] [-RoutingTableLogMaxAge <EnhancedTimeSpan>] [-RoutingTableLogMaxDirectorySize <Unlimited>] [-RoutingTableLogPath <LocalLongFullPath>] [-SendProtocolLogMaxAge <EnhancedTimeSpan>] [-SendProtocolLogMaxDirectorySize <Unlimited>] [-SendProtocolLogMaxFileSize <Unlimited>] [-SendProtocolLogPath <LocalLongFullPath>] [-TransientFailureRetryCount <Int32>] [-TransientFailureRetryInterval <EnhancedTimeSpan>] [-WhatIf [<SwitchParameter>]]

Set-TransportServer [-AntispamAgentsEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-ConnectivityLogEnabled <$true | $false>] [-ConnectivityLogMaxAge <EnhancedTimeSpan>] [-ConnectivityLogMaxDirectorySize <Unlimited>] [-ConnectivityLogMaxFileSize <Unlimited>] [-ConnectivityLogPath <LocalLongFullPath>] [-ContentConversionTracingEnabled <$true | $false>] [-DelayNotificationTimeout <EnhancedTimeSpan>] [-DomainController <Fqdn>] [-ExternalDelayDsnEnabled <$true | $false>] [-ExternalDNSAdapterEnabled <$true | $false>] [-ExternalDNSAdapterGuid <Guid>] [-ExternalDNSProtocolOption <Any | UseUdpOnly | UseTcpOnly>] [-ExternalDNSServers <MultiValuedProperty>] [-ExternalDsnDefaultLanguage <CultureInfo>] [-ExternalDsnLanguageDetectionEnabled <$true | $false>] [-ExternalDsnMaxMessageAttachSize <ByteQuantifiedSize>] [-ExternalDsnReportingAuthority <SmtpDomain>] [-ExternalDsnSendHtml <$true | $false>] [-ExternalIPAddress <IPAddress>] [-ExternalPostmasterAddress <Nullable>] [-Instance <TransportServer>] [-InternalDelayDsnEnabled <$true | $false>] [-InternalDNSAdapterEnabled <$true | $false>] [-InternalDNSAdapterGuid <Guid>] [-InternalDNSProtocolOption <Any | UseUdpOnly | UseTcpOnly>] [-InternalDNSServers <MultiValuedProperty>] [-InternalDsnDefaultLanguage <CultureInfo>] [-InternalDsnLanguageDetectionEnabled <$true | $false>] [-InternalDsnMaxMessageAttachSize <ByteQuantifiedSize>] [-InternalDsnReportingAuthority <SmtpDomain>] [-InternalDsnSendHtml <$true | $false>] [-IntraOrgConnectorProtocolLoggingLevel <None | Verbose>] [-MaxConcurrentMailboxDeliveries <Int32>] [-MaxConcurrentMailboxSubmissions <Int32>] [-MaxConnectionRatePerMinute <Int32>] [-MaxOutboundConnections <Unlimited>] [-MaxPerDomainOutboundConnections <Unlimited>] [-MessageExpirationTimeout <EnhancedTimeSpan>] [-MessageRetryInterval <EnhancedTimeSpan>] [-MessageTrackingLogEnabled <$true | $false>] [-MessageTrackingLogMaxAge <EnhancedTimeSpan>] [-MessageTrackingLogMaxDirectorySize <Unlimited>] [-MessageTrackingLogMaxFileSize <Unlimited>] [-MessageTrackingLogPath <LocalLongFullPath>] [-MessageTrackingLogSubjectLoggingEnabled <$true | $false>] [-OutboundConnectionFailureRetryInterval <EnhancedTimeSpan>] [-PickupDirectoryMaxHeaderSize <ByteQuantifiedSize>] [-PickupDirectoryMaxMessagesPerMinute <Int32>] [-PickupDirectoryMaxRecipientsPerMessage <Int32>] [-PickupDirectoryPath <LocalLongFullPath>] [-PipelineTracingEnabled <$true | $false>] [-PipelineTracingPath <LocalLongFullPath>] [-PipelineTracingSenderAddress <Nullable>] [-PoisonMessageDetectionEnabled <$true | $false>] [-PoisonThreshold <Int32>] [-QueueMaxIdleTime <EnhancedTimeSpan>] [-ReceiveProtocolLogMaxAge <EnhancedTimeSpan>] [-ReceiveProtocolLogMaxDirectorySize <Unlimited>] [-ReceiveProtocolLogMaxFileSize <Unlimited>] [-ReceiveProtocolLogPath <LocalLongFullPath>] [-RecipientValidationCacheEnabled <$true | $false>] [-ReplayDirectoryPath <LocalLongFullPath>] [-RootDropDirectoryPath <String>] [-RoutingTableLogMaxAge <EnhancedTimeSpan>] [-RoutingTableLogMaxDirectorySize <Unlimited>] [-RoutingTableLogPath <LocalLongFullPath>] [-SendProtocolLogMaxAge <EnhancedTimeSpan>] [-SendProtocolLogMaxDirectorySize <Unlimited>] [-SendProtocolLogMaxFileSize <Unlimited>] [-SendProtocolLogPath <LocalLongFullPath>] [-TransientFailureRetryCount <Int32>] [-TransientFailureRetryInterval <EnhancedTimeSpan>] [-WhatIf [<SwitchParameter>]]

Detailed Description

The Set-TransportServer cmdlet lets you configure any transport configuration parameter on a Microsoft Exchange Server 2007 Hub Transport or Edge transport server. Changes to the Hub Transport server object are saved in the Active Directory directory service. Changes to the Edge Transport server object are saved on the local server by using Active Directory Application Mode (ADAM). In Exchange 2007, because the Edge Transport server exists in the perimeter network, the server has no access to the production Active Directory forest. Therefore, ADAM is used to provide a directory service for the Edge Transport server.

The Set-TransportServer cmdlet manipulates the following groups of parameters:

  • Domain identity

  • Connection limiting

  • Failed message retry intervals and time-outs

  • Delivery status notification (DSN) messages, intervals, and time-outs

  • Domain Name System (DNS) sources

  • Protocol, undeliverable mail (badmail), and pickup storage location and file size

  • Message tracking location, age, and log size

Note

The Set-TransportServer cmdlet does not require the Identity parameter to be specified when you run the command.

To run the Set-TransportServer cmdlet, the account you use must be delegated the following:

  • Exchange Server Administrator role and local Administrators group for the target server

To run the Set-TransportServer 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.

Parameters

Parameter Required Type Description

Identity

Required

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

This parameter specifies the server that you want to modify.

AntispamAgentsEnabled

Optional

System.Boolean

This parameter specifies whether anti-spam agents are installed on the server that is specified with the Identity parameter. The default value is $False on Hub Transport servers and $True on Edge Transport servers.

Important

You set this parameter by using a script. You should not modify this parameter manually.

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.

ConnectivityLogEnabled

Optional

System.Boolean

This parameter specifies whether the connectivity log is enabled or disabled. The default value is $False.

ConnectivityLogMaxAge

Optional

Microsoft.Exchange.Data.EnhancedTimeSpan

This parameter specifies the maximum age for the connectivity log file. Log files that are older than the specified value are deleted. The default value is 30 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. Setting the value of the ConnectivityLogMaxAge parameter to 00:00:00 prevents the automatic removal of connectivity log of files because of their age.

ConnectivityLogMaxDirectorySize

Optional

Microsoft.Exchange.Data.Unlimited

This parameter specifies the maximum size of all connectivity logs in the connectivity log directory. When a directory reaches its maximum file size, the server deletes the oldest log files first. The default value is 250 MB. When you enter a value, qualify the value with one of the following units:

  • B (bytes)

  • KB (kilobytes)

  • MB (megabytes)

  • GB (gigabytes)

  • TB (terabytes)

Unqualified values are treated as bytes. The value of the ConnectivityLogMaxFileSize parameter must be less than or equal to the value of the ConnectivityLogMaxDirectorySize parameter. The valid input range for either parameter is 1 to 9223372036854775807 bytes. If you enter a value of unlimited, no size limit is imposed on the connectivity log directory.

ConnectivityLogMaxFileSize

Optional

Microsoft.Exchange.Data.Unlimited

This parameter specifies the maximum size of each connectivity log file. When a log file reaches its maximum file size, a new log file is created. 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)

  • TB (terabytes)

Unqualified values are treated as bytes. The value of the ConnectivityLogMaxFileSize parameter must be less than or equal to the value of the ConnectivityLogMaxDirectorySize parameter. The valid input range for either parameter is 1 to 9223372036854775807 bytes. If you enter a value of unlimited, no size limit is imposed on the connectivity log files.

ConnectivityLogPath

Optional

Microsoft.Exchange.Data.LocalLongFullPath

This parameter specifies the default connectivity log directory location. The default value is C:\Program Files\Microsoft\Exchange Server\TransportRoles\Logs\Connectivity. If you set the value of the ConnectivityLogPath parameter to $Null, you effectively disable connectivity logging. However, if you set the value of the ConnectivityLogPath parameter to $Null when the value of the ConnectivityLogEnabled attribute is $True, you will generate event log errors.

ContentConversionTracingEnabled

Optional

System.Boolean

This parameter specifies whether content conversion tracing is enabled or disabled. Content conversion tracing captures content conversion failures that occur on the Hub Transport server or Edge Transport server. The default value is $False. Content conversion tracing captures a maximum of 128 MB of content conversion failures. When the 128 MB limit is reached, no more content conversion failures are captured. Content conversion tracing captures the complete contents of e-mail messages to the path that is specified by the PipelineTracingPath parameter. Make sure that you restrict access to this directory. The permissions that are required on the directory that is specified by the PipelineTracingPath parameter are as follows:

  • Administrators: Full Control

  • Network Service: Full Control

  • System: Full Control

DelayNotificationTimeout

Optional

Microsoft.Exchange.Data.EnhancedTimeSpan

This parameter specifies how long the server waits before it generates a delayed DSN. The default value is 4 hours. 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:01 to 30.00:00:00. The value of the DelayNotificationTimeout parameter should always be greater than the value of the TransientFailureRetryCount parameter multiplied by the value of the TransientFailureRetryInterval parameter.

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 have the Edge Transport server role installed. The Edge Transport server role reads and writes only to the local Active Directory Application Mode (ADAM) instance.

ExternalDelayDSNEnabled

Optional

System.Boolean

This parameter specifies whether a delay DSN should be created for external messages that could not be immediately delivered. The default value is $True.

ExternalDNSAdapterEnabled

Optional

System.Boolean

This parameter specifies one or more DNS servers that Exchange 2007 uses for external DNS lookups. When the ExternalDNSAdapterEnabled parameter is set to $True, DNS lookups of destinations that are outside the Exchange organization are performed by using the DNS settings of the external network adapter specified by the value of the ExternalDNSAdapterGUID parameter. If you want to specify a custom list of DNS servers that are only used for external Exchange 2007 DNS lookups, you must specify the DNS servers by using the ExternalDNSServers parameter, and you must also set the value of the ExternalDNSAdapterEnabled parameter to $False. The default value of the ExternalDNSAdapterEnabled is $True.

ExternalDNSAdapterGUID

Optional

System.Guid

This parameter specifies the network adapter that has the DNS settings that are used for DNS lookups of destinations that exist outside the Exchange organization. The concept of an external network adapter and an internal network adapter is only applicable in a multi-homed Exchange 2007 server environment. Typically, a multi-homed Exchange 2007 server is only used with the Edge Transport server role in a perimeter network. When no particular network adapter is specified as the network adapter for external DNS lookups, the value of the ExternalDNSAdapterGUID parameter is 00000000-0000-0000-0000-000000000000, and external DNS lookups are performed by using the DNS settings of any available network adapter. You may enter the GUID of a specific network adapter to use for external DNS lookups. The default value of the ExternalDNSAdapterGUID parameter is 00000000-0000-0000-0000-000000000000.

Note

If the value of the ExternalDNSAdapterEnabled parameter is set to $False, the value of the ExtermalDNSAdapterGUID parameter is ignored, and the list of DNS servers from the ExternalDNSServers parameter is used.

ExternalDNSProtocolOption

Optional

Microsoft.Exchange.Data.ProtocolOption

This parameter specifies which protocol to use when querying external DNS servers. The valid options for this parameter are Any, UseTCPOnly, and UseUDPOnly. The default value is Any.

ExternalDNSServers

Optional

Microsoft.Exchange.Data.MultiValuedProperty

This parameter specifies the list of external DNS servers that the server queries when resolving a remote domain. You must separate IP addresses by using commas. The default value is an empty list ({}).

Note

If the value of the ExternalDNSAdapterEnabled parameter is set to $True, the ExternalDNSServers parameter and its list of DNS servers is not used.

ExternalDsnDefaultLanguage

Optional

System.Globalization.CultureInfo

This 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

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

ExternalDsnMaxMessageAttachSize

Optional

Microsoft.Exchange.Data.ByteQuantifiedSize

This parameter specifies the maximum size of the original message that is attached to an external DSN. If the original message exceeds this size, only the headers of the original message are included in the DSN. 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 0 to 2147483647 bytes. If you specify a value of 0, only the original message headers are included in the external DSN.

ExternalDSNReportingAuthority

Optional

Microsoft.Exchange.Data.SmtpDomain

This 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 that is specified during installation.

ExternalDsnSendHtml

Optional

System.Boolean

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

ExternalIPAddress

Optional

System.Net.IPAddress

This parameter specifies the IP address that is used in the Received: message header field for every message that travels through the Edge Transport server or Hub Transport server. The IP address in the Received: header field is used for hop count and routing loop detection. When an Edge Transport server is protected by a router or firewall that uses Network Address Translation (NAT), NAT disrupts the Edge Transport server's hop count and routing loop calculations. When the Edge Transport server is protected by NAT, the RFC 1918 private, non-routable IP addresses that are typically used by the server's network adapters do not match the public, routable IP addresses that are defined in the domain's public DNS MX records. The IP addresses that are assigned to the internal or external network adapters of the Edge Transport server can be determined by using the Get-NetworkConnectionInfo cmdlet. The IP address specified by the ExternalIPAddress parameter overrides the external network adapter's actual IP address. Typically, you would want to set the value of the ExternalIPAddress parameter to match the value of your domain's public MX record. The default value of the ExternalIPAddress parameter is blank. This means the actual IP address of the external network adapter is used in the Received: header field.

ExternalPostmasterAddress

Optional

System.Nullable

This 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 has not yet been through the EdgeSync process, and ExternalPostmasterAddress 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 ExternalPostmasterAddress 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.

Instance

Optional

Microsoft.Exchange.Data.Directory.Management.TransportServer

This parameter enables you to pass an entire object to the command to be processed. It is mainly used in scripts where an entire object must be passed to the command.

InternalDelayDSNEnabled

Optional

System.Boolean

This parameter specifies whether a delay DSN should be created for messages that were sent to and from recipients and senders in the same Exchange organization and could not be immediately delivered. The default value is $True.

InternalDNSAdapterEnabled

Optional

System.Boolean

This parameter specifies one or more DNS servers that Exchange 2007 uses for internal DNS lookups. When the InternalDNSAdapterEnabled parameter is set to $True, DNS lookups of destinations that are inside the Exchange organization are performed by using the DNS settings of the internal network adapter specified by the value of the InternalDNSAdapterGUID parameter. If you want to specify a custom list of DNS servers that are only used for internal Exchange 2007 DNS lookups, you must specify the DNS servers by using the InternalDNSServers parameter, and you must also set the value of the InternalDNSAdapterEnabled parameter to $False. The default value of the InternalDNSAdapterEnabled parameter is $True.

InternalDNSAdapterGUID

Optional

System.Guid

This parameter specifies the network adapter that has the DNS settings that are used for DNS lookups of servers that exist inside the Exchange organization. The concept of an internal network adapter and an external network adapter is only applicable in a multi-homed Exchange 2007 server environment. Typically, a multi-homed Exchange 2007 server is only used with the Edge Transport server role in a perimeter network. When no particular network adapter is specified as the network adapter for external DNS lookups, the value of the InternalDNSAdapterGUID parameter is 00000000-0000-0000-0000-000000000000 and internal DNS lookups are performed by using the DNS settings of any available network adapter. You may enter the GUID of a specific network adapter to use for internal DNS lookups. The default value of the InternalDNSAdapterGUID parameter is 00000000-0000-0000-0000-000000000000.

Note

If the value of the InternalDNSAdapterEnabled parameter is set to $False, the value of the IntermalDNSAdapterGUID parameter is ignored, and the list of DNS servers from the InternalDNSServers parameter is used.

InternalDNSProtocolOption

Optional

Microsoft.Exchange.Data.ProtocolOption

This parameter specifies which protocol to use when you query internal DNS servers. Valid options for this parameter are Any, UseTcpOnly, or UseUdpOnly.

The default value is Any.

InternalDNSServers

Optional

Microsoft.Exchange.Data.MultiValuedProperty

This parameter specifies the list of DNS servers that should be used when resolving a domain name. DNS servers are specified by IP address and are separated by commas. The default value is any empty list ({}).

Note

If the InternalDNSAdapterGUID parameter is set, and the value of the ExternalDNSAdapterEnabled parameter is set to $True, the InternalDNSServers parameter and its list of DNS servers is not used.

InternalDsnDefaultLanguage

Optional

System.Globalization.CultureInfo

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

InternalDsnLanguageDetectionEnabled

Optional

System.Boolean

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

InternalDsnMaxMessageAttachSize

Optional

Microsoft.Exchange.Data.ByteQuantifiedSize

This parameter specifies the maximum size of the original message that generated an internal DSN. If the original message exceeds this size, only the headers of the original message are included in the DSN. 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 0 to 2147483647 bytes. If you specify a value of 0, only the original message headers are included in the internal DSN.

InternalDSNReportingAuthority

Optional

Microsoft.Exchange.Data.SmtpDomain

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

InternalDsnSendHtml

Optional

System.Boolean

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

IntraOrgConnectorProtocolLoggingLevel

Optional

Microsoft.Exchange.Data.ProtocolLoggingLevel

This parameter enables or disables SMTP protocol logging on the implicit and invisible intra-organization Send connector that is created on every Hub Transport server. This implicit Send connector is used to relay messages to the following destinations:

  • To other Hub Transport servers within the Exchange organization

  • To Exchange Server 2003 servers within the Exchange organization

  • To Edge Transport servers within the Exchange organization

Valid values for this parameter are None and Verbose. The value Verbose enables protocol logging for the connector. The value None disables protocol logging for the connector. The default value is None. When the IntraOrgConnectorProtocolLoggingLevel is set to Verbose, the information is written to the Send connector protocol log specified by the SendProtocolLog parameters.

MaxConcurrentMailboxDeliveries

Optional

System.Int32

This parameter specifies the maximum number of delivery threads that the server can have open at the same time to deliver messages to mailboxes. The default value is 30. The valid input range for this parameter is 1 to 256. We recommend that you don't modify the default value unless Microsoft Support Services advises you to do this.

MaxConcurrentMailboxSubmissions

Optional

System.Int32

This parameter specifies the maximum number of submission threads that the server can have open at the same time to send messages from mailboxes. The default value is 20. The valid input range for this parameter is 1 to 256.

MaxConnectionRatePerMinute

Optional

System.Int32

This parameter specifies the maximum rate that connections are allowed to be opened with the server. If many connections are attempted with the server at the same time, the MaxConnectionRatePerMinute parameter limits the rate that the connections are opened so that the server's resources are not overwhelmed. The default value is 1200 connections per minute. If the maximum connection rate is reached, the valid input range for this parameter is 1 to 2147483647.

MaxOutboundConnections

Optional

Microsoft.Exchange.Data.Unlimited

This parameter specifies the maximum number of outbound connections that can be open at a time. The default value is 1000. The valid input range for this parameter is 1 to 2147483647. If you enter a value of unlimited, no limit is imposed on the number of outbound connections. The value of the MaxOutboundConnections parameter must be greater than or equal to the value of the MaxPerDomainOutboundConnections parameter.

MaxPerDomainOutboundConnections

Optional

Microsoft.Exchange.Data.Unlimited

This parameter specifies the maximum number of concurrent connections to any single domain. The default value is 20. The valid input range for this parameter is 1 to 2147483647. If you enter a value of unlimited, no limit is imposed on the number of outbound connections per domain. The value of the MaxPerDomainOutboundConnections parameter must be less than or equal to the value of the MaxOutboundConnections parameter.

MessageExpirationTimeout

Optional

Microsoft.Exchange.Data.EnhancedTimeSpan

This parameter specifies the maximum time that a particular message can remain in a queue. If a message remains in the queue for longer than this period of time, the message is returned to the sender as a hard failure. The default value is 2 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:05 to 90.00:00:00.

MessageRetryInterval

Optional

Microsoft.Exchange.Data.EnhancedTimeSpan

This parameter specifies the retry interval for individual messages after a connection failure with a remote server. The default value is 1 minute. 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:01 to 1.00:00:00. We recommend that you don't modify the default value unless Microsoft Support Services advises you to do this.

MessageTrackingLogEnabled

Optional

System.Boolean

This parameter specifies whether message tracking is enabled. The default value is $True.

MessageTrackingLogMaxAge

Optional

Microsoft.Exchange.Data.EnhancedTimeSpan

This parameter specifies the message tracking log maximum file age. Log files that are older than the specified value are deleted. The default value is 30 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. Setting the value of the MessageTrackingLogMaxAge parameter to 00:00:00 prevents the automatic removal of message tracking log of files because of their age.

MessageTrackingLogMaxDirectorySize

Optional

Microsoft.Exchange.Data.Unlimited

This parameter specifies the maximum size of the message tracking log directory. When the maximum directory size is reached, the server deletes the oldest log files first.

The maximum size of the message tracking log directory is calculated as the total size of all log files that have the same name prefix. Other files that do not follow the name prefix convention are not counted in the total directory size calculation. Renaming old log files or copying other files into the message tracking log directory could cause the directory to exceed its specified maximum size.

When the Hub Transport server role and the Mailbox server role are installed on the same server, the maximum size of the message tracking log directory is not the specified maximum size because the message tracking log files that are generated by the different server roles have different name prefixes. Message tracking log files for the Hub Transport server role or Edge Transport server role begin with the name prefix MSGTRK. Message tracking log files for the Mailbox server role begin with the name prefix MSGTRKM. When the Hub Transport server role and the Mailbox server role are installed on the same server, the maximum size of the message tracking log directory is two times the specified value.

The default value is 250 MB. When you enter a value, qualify the value with one of the following units:

  • B (bytes)

  • KB (kilobytes)

  • MB (megabytes)

  • GB (gigabytes)

  • TB (terabytes)

Unqualified values are treated as bytes. The value of the MessageTrackingLogMaxFileSize parameter must be less than or equal to the value of the MessageTrackingLogMaxDirectorySize parameter. The valid input range for either parameter is 1 to 9223372036854775807 bytes. If you enter a value of unlimited, no size limit is imposed on the message tracking log directory.

MessageTrackingLogMaxFileSize

Optional

Microsoft.Exchange.Data.Unlimited

This parameter specifies the maximum size of the message tracking log files. When a log file reaches its maximum file size, a new log file is created. 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)

  • TB (terabytes)

Unqualified values are treated as bytes. The value of the MessageTrackingLogMaxFileSize parameter must be less than or equal to the value of the MessageTrackingLogMaxDirectorySize parameter. The valid input range for either parameter is 1 to 9223372036854775807 bytes. If you enter a value of unlimited, no size limit is imposed on the message tracking log files.

MessageTrackingLogPath

Optional

Microsoft.Exchange.Data.LocalLongFullPath

This parameter specifies the location of the message tracking logs. The default location is C:\Program Files\Microsoft\Exchange Server TransportRoles\Logs\MessageTracking. In a single copy cluster (SCC) environment, move the message tracking log directory to a physical disk resource that is located on the shared storage resource. This enables searches of message tracking logs to continue to function if a failover occurs. If you set the value of the MessageTrackingLogPath parameter to $Null, you effectively disable message tracking. However, if you set the value of the MessageTrackingLogPath parameter to $Null when the value of the MessageTrackingLogEnabled attribute is $True, you will generate event log errors. The preferred method to disable message tracking is to use the MessageTrackingLogEnabled parameter.

MessageTrackingLogSubjectLoggingEnabled

Optional

System.Boolean

This parameter specifies if the message subject should be included in the message tracking log. The default value is $True.

OutboundConnectionFailureRetryInterval

Optional

Microsoft.Exchange.Data.EnhancedTimeSpan

This parameter specifies the retry interval for subsequent connection attempts to a remote server where previous connection attempts have failed. The previously failed connection attempts are controlled by the TransientFailureRetryCount and TransientFailureRetryInterval parameters. On a Hub Transport server, the default value of the OutboundConnectionFailureRetryInterval parameter is 10 minutes. On an Edge Transport server, the default value is 30 minutes. 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:01 to 20.00:00:00.

PickupDirectoryMaxHeaderSize

Optional

Microsoft.Exchange.Data.ByteQuantifiedSize

This parameter specifies the maximum message header size that can be submitted to the Pickup directory. The default value is 64 KB. 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 32768 to 2147483647 bytes.

PickupDirectoryMaxMessagesPerMinute

Optional

System.Int32

This parameter specifies the maximum number of messages that will be processed per minute by the Pickup directory and by the Replay directory. Each directory can independently process message files at the rate specified by the PickupDirectoryMaxMessagesPerMinute parameter. The default value is 100. The valid input range for this parameter is 1 to 20000.

PickupDirectoryMaxRecipientsPerMessage

Optional

System.Int32

This parameter specifies the maximum number of recipients that can be included on an e-mail message. The default value is 100. The valid input range for this parameter is 1 to 10000.

PickupDirectoryPath

Optional

Microsoft.Exchange.Data.LocalLongFullPath

This parameter specifies the location of the Pickup directory. The Pickup directory is used by administrators and third-party applications to create and submit messages. The default value is C:\Program Files\Microsoft\Exchange Server\TransportRoles\Pickup. If the value of PickupDirectoryPath is set to $Null, the Pickup directory is disabled.

PipelineTracingEnabled

Optional

System.Boolean

This parameter enables or disables pipeline tracing. Pipeline tracing captures message snapshot files that record the changes that are made to the message by each transport agent that is configured on the Hub Transport or Edge Transport server. Pipeline tracing creates verbose log files that accumulate quickly. Pipeline tracing should only be enabled for a short time to provide in-depth diagnostic information that enables you to troubleshoot problems. In addition to troubleshooting, you can use pipeline tracing to validate changes that you make to the configuration of the server on which you enable pipeline tracing. The default value is $False.

PipelineTracingPath

Optional

Microsoft.Exchange.Data.LocalLongFullPath

This parameter specifies the location of the pipeline tracing logs. The default path is C:\Program Files\Microsoft\Exchange Server\TransportRoles\Logs\PipelineTracing. The path must be local to the Exchange 2007 computer. If you set the value of the PipelineTracingPath parameter to $Null, you effectively disable pipeline tracing. However, if you set the value of the PipelineTracingPath parameter to $Null when the value of the PipelineTracingEnabled attribute is $True, you will generate event log errors. The preferred method to disable pipeline tracing is to use the PipelineTracingEnabled parameter. Pipeline tracing captures the complete contents of e-mail messages to the path that is specified by the PipelineTracingPath parameter. Make sure that you restrict access to this directory. The permissions that are required on the directory that is specified by the PipelineTracingPath parameter are as follows:

  • Administrators: Full Control

  • Network Service: Full Control

  • System: Full Control

PipelineTracingSenderAddress

Optional

System.Nullable

This parameter specifies the sender e-mail address that invokes pipeline tracing. Only messages from this address generate pipeline tracing output. The address can be either inside or outside the Exchange organization. Depending on your requirements, you may have to set this parameter to different sender addresses and send new messages to start the transport agents or routes that you want to test. The default value of this parameter is $null.

PoisonMessageDetectionEnabled

Optional

System.Boolean

This parameter specifies whether poison messages should be detected. The default value is $True. Poison messages are messages that are determined to be potentially harmful to the Exchange 2007 system after a server failure. Poison messages are put in the poison message queue. We recommend that you don't modify the default value unless Microsoft Support Services advises you to do this.

PoisonThreshold

Optional

System.Int32

This parameter specifies the number of times a message can be rejected before it is classified as a poison message. The default value is 2. We recommend that you don't modify the default value unless Microsoft Support Services advises you to do this. The valid input range for this parameter is 1 to 10.

QueueMaxIdleTime

Optional

Microsoft.Exchange.Data.EnhancedTimeSpan

This parameter specifies the period of time an empty mailbox delivery queue or remote delivery queue will remain before the queue is removed. The default value is 3 minutes. To specify a value, enter the value as a time span: hh:mm:ss, where h = hours, m = minutes, and s = seconds. The valid input range for this parameter is 00:00:05 to 01:00:00. We recommend that you don't modify the default value unless Microsoft Support Services advises you to do this.

ReceiveProtocolLogMaxAge

Optional

Microsoft.Exchange.Data.EnhancedTimeSpan

This parameter specifies the maximum age of the Receive connector protocol log file. Log files that are older than the specified value are deleted. The default value is 30 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. Setting the value of the ReceiveProtocolLogMaxAge parameter to 00:00:00 prevents the automatic removal of Receive connector protocol log files because of their age.

ReceiveProtocolLogMaxDirectorySize

Optional

Microsoft.Exchange.Data.Unlimited

This parameter specifies the maximum size of the Receive connector protocol log directory that is shared by all the Receive connectors that exist on the server. When the maximum directory size is reached, the server deletes the oldest log files first. The default value is 250 MB. When you enter a value, qualify the value with one of the following units:

  • B (bytes)

  • KB (kilobytes)

  • MB (megabytes)

  • GB (gigabytes)

  • TB (terabytes)

Unqualified values are treated as bytes. The value of the ReceiveProtocolLogMaxFileSize parameter must be less than or equal to the value of the ReceiveProtocolLogMaxDirectorySize parameter. The valid input range for either parameter is 1 to 9223372036854775807 bytes. If you enter a value of unlimited, no size limit is imposed on the Receive connector protocol log directory.

ReceiveProtocolLogMaxFileSize

Optional

Microsoft.Exchange.Data.Unlimited

This parameter specifies the maximum size of the Receive connector protocol log files that are shared by all the Receive connectors that exist on the server. When a log file reaches its maximum file size, a new log file is created. 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)

  • TB (terabytes)

Unqualified values are treated as bytes. The value of the ReceiveProtocolLogMaxFileSize parameter must be less than or equal to the value of the ReceiveProtocolLogMaxDirectorySize parameter. The valid input range for either parameter is 1 to 9223372036854775807 bytes. If you enter a value of unlimited, no size limit is imposed on the Receive connector protocol log files.

ReceiveProtocolLogPath

Optional

Microsoft.Exchange.Data.LocalLongFullPath

This parameter specifies the path of the protocol log directory for all the Receive connectors that exist on the server. The default location is C:\Program Files\Microsoft Exchange\TransportRoles\Logs\ProtocolLog\SmtpReceive. Setting the value of this parameter to $Null disables protocol logging for all Receive connectors on the server. However, setting this parameter to $Null when the value of the ProtocolLoggingLevel attribute for any Receive connector on the server is Verbose generates event log errors. The preferred method of disabling protocol logging is to use the Set-ReceiveConnector cmdlet to set the ProtocolLoggingLevel to None on each Receive connector.

RecipientValidationCacheEnabled

Optional

System.Boolean

This parameter specifies whether the recipient addresses that are used by transport agents such as Recipient Filtering are cached. The default value is $True on Edge Transport servers and $False on Hub Transport servers.

ReplayDirectoryPath

Optional

Microsoft.Exchange.Data.LocalLongFullPath

This parameter specifies the path of the Replay directory. The Replay directory is used to resubmit exported messages and to receive messages from foreign gateway servers. The default location is C:\Program Files\Microsoft\Exchange Server\TransportRoles\Replay. If the value of ReplayDirectoryPath is set to $Null, the Replay directory is disabled.

RootDropDirectoryPath

Optional

System.String

This parameter specifies the top-level location of the Drop directory that is used by all Foreign connectors that are defined on a Hub Transport server. The value of the RootDropDirectoryPath parameter may be a local path, or a Universal Naming Convention (UNC) path to a remote server. By default, the RootDropDirectoryPath parameter is blank. This indicates the value of RootDropDirectoryPath is the Exchange 2007 installation folder. The default Exchange 2007 installation folder is C:\Program Files\Microsoft\Exchange Server\. The RootDropDirectoryPath parameter is used with the DropDirectory parameter in the Set-ForeignConnector cmdlet to specify the location for outgoing messages that are going to the address spaces that are defined on the Foreign connector.

RoutingTableLogMaxAge

Optional

Microsoft.Exchange.Data.EnhancedTimeSpan

This parameter specifies the maximum routing table log age. Log files that are older than the specified value are deleted. The default value is 7 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. Setting the value of the RoutingTableLogMaxAge parameter to 00:00:00 prevents the automatic removal of routing table log files because of their age.

RoutingTableLogMaxDirectorySize

Optional

Microsoft.Exchange.Data.Unlimited

This parameter specifies the maximum size of the routing table log directory. When the maximum directory size is reached, the server deletes the oldest log files first. The default value is 50 MB. When you enter a value, qualify the value with one of the following units:

  • B (bytes)

  • KB (kilobytes)

  • MB (megabytes)

  • GB (gigabytes)

  • TB (terabytes)

Unqualified values are treated as bytes. The valid input range for this parameter is 1 to 9223372036854775807 bytes. If you enter a value of unlimited, no size limit is imposed on the routing table log directory.

RoutingTableLogPath

Optional

Microsoft.Exchange.Data.LocalLongFullPath

This parameter specifies the directory location where routing table log files should be stored. The default value is C:\Program Files\Microsoft\Exchange Server\TransportRoles\Logs\Routing. Setting the value of the RoutingTableLogPath parameter to $Null disables routing table logging.

SendProtocolLogMaxAge

Optional

Microsoft.Exchange.Data.EnhancedTimeSpan

This parameter specifies the Send connector protocol log file maximum age. Log files that are older than the specified value are deleted. The default value is 30 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. Setting the value of the SendProtocolLogMaxAge parameter to 00:00:00 prevents the automatic removal of Send connector protocol log files because of their age.

SendProtocolLogMaxDirectorySize

Optional

Microsoft.Exchange.Data.Unlimited

This parameter specifies the maximum size of the Send Connector Protocol Log directory. When the maximum directory size is reached, the server deletes the oldest log files first. The minimum value is 1 MB. The default value is 250 MB. When you enter a value, qualify the value with one of the following:

  • B (bytes)

  • KB (kilobytes)

  • MB (megabytes)

  • GB (gigabytes)

  • TB (terabytes)

Unqualified values are treated as bytes. The value of the SendProtocolLogMaxFileSize parameter must be less than or equal to the value of the SendProtocolLogMaxDirectorySize parameter. The valid input range for either parameter is 1 to 9223372036854775807 bytes. If you enter a value of unlimited, no size limit is imposed on the Send connector protocol log directory.

SendProtocolLogMaxFileSize

Optional

Microsoft.Exchange.Data.Unlimited

This parameter specifies the maximum size of the Send connector protocol log files that are shared by all the Send connectors that exist on a server. When a log file reaches its maximum file size, a new log file is created. The default value is 10 MB. When you enter a value, qualify the value with one of the following:

  • B (bytes)

  • KB (kilobytes)

  • MB (megabytes)

  • GB (gigabytes)

  • TB (terabytes)

Unqualified values are treated as bytes. The value of the SendProtocolLogMaxFileSize parameter must be less than or equal to the value of the SendProtocolLogMaxDirectorySize parameter. The valid input range for either parameter is 1 to 9223372036854775807 bytes. If you enter a value of unlimited, no size limit is imposed on the Send connector protocol log files.

SendProtocolLogPath

Optional

Microsoft.Exchange.Data.LocalLongFullPath

This parameter specifies the location of protocol log storage for the Send connectors. The default location is "C:\Program Files\Microsoft Exchange\TransportRoles\Logs\ProtocolLog\SmtpSend". Setting the value of this parameter to $Null disables protocol logging for all Send connectors on the server. However, setting this parameter to $Null when logging the value of the ProtocolLoggingLevel attribute for any Send connector on the server is Verbose or if the IntraOrgConnectorProtocolLoggingLevel parameter is set to Verbose generates event log errors. The preferred method of disabling protocol logging is to use the Set-SendConnector cmdlet to set the ProtocolLoggingLevel parameter to None on each Send connector and to set the IntraOrgConnectorProtocolLoggingLevel parameter to None.

TransientFailureRetryCount

Optional

System.Int32

This parameter specifies the maximum number of immediate connection retries that are attempted when the server encounters a connection failure with a remote server. The default value is 6. The valid input range for this parameter is 0 to 15. When the value of this parameter is set to 0, the server does not immediately attempt to retry an unsuccessful connection, and the next connection attempt is controlled by the OutboundConnectionFailureRetryInterval parameter.

TransientFailureRetryInterval

Optional

Microsoft.Exchange.Data.EnhancedTimeSpan

This parameter controls the connection interval between each connection attempt that is specified by the TransientFailureRetryCount parameter. On a Hub Transport server, the default value of the TransientFailureRetryInterval is 5 minutes. On an Edge Transport server, the default value is 10 minutes. To specify a value, enter the value as a time span: hh:mm:ss, where h = hours, m = minutes, and s = seconds. The valid input range for this parameter is 00:00:01 to 12:00:00.

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.

Example

When you use the Set-TransportServer command, you can set any number of parameters at the same time. The following examples show the command syntax.

The first example sets the DelayNotificationTimeout parameter to 13 hours.

The second example sets the TransientFailureRetryCount parameter to 3, and sets the TransientFailureRetryInterval parameter to 30 seconds.

The third example sets the ReceiveProtocolLogPath parameter to C:\SMTP Protocol Logs\Receive.log.

Set-TransportServer -DelayNotificationTimeout 13:00:00
Set-TransportServer -TransientFailureRetryCount 3 -TransientFailureRetryInterval 00:00:30
Set-TransportServer -ReceiveProtocolLogPath "C:\SMTP Protocol Logs\Receive.log"