Applies to: Exchange Server 2007
Topic Last Modified: 2007-06-11
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>]
|
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
|
||
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
|
||
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 ({}).
|
||
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
|
||
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 ({}).
|
||
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 |
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.
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.
Copy Code | |
---|---|
Set-TransportServer -DelayNotificationTimeout 13:00:00 Set-TransportServer -TransientFailureRetryCount 3 -TransientFailureRetryInterval 00:00:30 Set-TransportServer -ReceiveProtocolLogPath "C:\SMTP Protocol Logs\Receive.log" |