Set-TransportServer (RTM)
Microsoft Exchange Server 2007 will reach end of support on April 11, 2017. To stay supported, you will need to upgrade. For more information, see Resources to help you upgrade your Office 2007 servers and clients.
Applies to: Exchange Server 2007
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>] [-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 <SmtpAddress>] [-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>]
Set-TransportServer [-AntispamAgentsEnabled <$true | $false>] [-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 <SmtpAddress>] [-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>]
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 Important You set this parameter by using a script. You should not modify this parameter manually. |
ConnectivityLogEnabled |
Optional |
System.Boolean |
This parameter specifies whether the connectivity log is enabled or disabled. The default value is |
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 |
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
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 |
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
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 |
ConnectivityLogPath |
Optional |
Microsoft.Exchange.Data.LocalLongFullPath |
This parameter specifies the default connectivity log directory location. The default value is |
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
|
DelayNotificationTimeout |
Optional |
Microsoft.Exchange.Data.EnhancedTimeSpan |
This parameter specifies how long the server waits before it generates a delayed DSN. The default value is |
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 |
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 |
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 Note If the value of the ExternalDNSAdapterEnabled parameter is set to |
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 |
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 |
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 |
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
Unqualified values are treated as bytes. The valid input range for this parameter is |
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 |
ExternalIPAddress |
Optional |
System.Net.IPAddress |
This parameter specifies the IP address that is used in the |
ExternalPostmasterAddress |
Optional |
System.Nullable |
This parameter specifies the e-mail address in the |
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 |
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 |
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 Note If the value of the InternalDNSAdapterEnabled parameter is set to |
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 The default value is |
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 |
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 |
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
Unqualified values are treated as bytes. The valid input range for this parameter is |
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 |
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:
Valid values for this parameter are |
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 |
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 |
MaxPerDomainOutboundConnections |
Optional |
Microsoft.Exchange.Data.Unlimited |
This parameter specifies the maximum number of concurrent connections to any single domain. The default value is |
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 |
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 |
MessageTrackingLogEnabled |
Optional |
System.Boolean |
This parameter specifies whether message tracking is enabled. The default value is |
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 |
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
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 |
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
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 |
MessageTrackingLogPath |
Optional |
Microsoft.Exchange.Data.LocalLongFullPath |
This parameter specifies the location of the message tracking logs. The default location is |
MessageTrackingLogSubjectLoggingEnabled |
Optional |
System.Boolean |
This parameter specifies if the message subject should be included in the message tracking log. The default value is |
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 is 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 |
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
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 |
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 |
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 |
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 |
PipelineTracingPath |
Optional |
Microsoft.Exchange.Data.LocalLongFullPath |
This parameter specifies the location of the pipeline tracing logs. The default path is
|
PipelineTracingSenderAddress |
Optional |
Microsoft.Exchange.Data.SmtpAddress |
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. |
PoisonMessageDetectionEnabled |
Optional |
System.Boolean |
This parameter specifies whether poison messages should be detected. The default value is |
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 |
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 |
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 |
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
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 |
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
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 |
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 |
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 |
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 |
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 |
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
Unqualified values are treated as bytes. The valid input range for this parameter is |
RoutingTableLogPath |
Optional |
Microsoft.Exchange.Data.LocalLongFullPath |
This parameter specifies the directory location where routing table log files should be stored. The default value is |
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 |
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
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 |
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
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 |
SendProtocolLogPath |
Optional |
Microsoft.Exchange.Data.LocalLongFullPath |
This parameter specifies the location of protocol log storage for the Send connectors. The default location is |
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 |
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 |
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"