Applies to: Exchange Server 2013
Topic Last Modified: 2012-09-13
Use the Set-MailboxTransportService cmdlet to view the transport configuration information for the Mailbox Transport service on Mailbox servers.
For information about the parameter sets in the Syntax section below, see Syntax.
Syntax
Set-MailboxTransportService -Identity
<MailboxTransportServerIdParameter> [-Confirm
[<SwitchParameter>]] [-ConnectivityLogEnabled <$true |
$false>] [-ConnectivityLogMaxAge <EnhancedTimeSpan>]
[-ConnectivityLogMaxDirectorySize <Unlimited>]
[-ConnectivityLogMaxFileSize <Unlimited>]
[-ConnectivityLogPath <LocalLongFullPath>]
[-ContentConversionTracingEnabled <$true | $false>]
[-DomainController <Fqdn>] [-MailboxDeliveryAgentLogEnabled
<$true | $false>] [-MailboxDeliveryAgentLogMaxAge
<EnhancedTimeSpan>] [-MailboxDeliveryAgentLogMaxDirectorySize
<Unlimited>] [-MailboxDeliveryAgentLogMaxFileSize
<Unlimited>] [-MailboxDeliveryAgentLogPath
<LocalLongFullPath>]
[-MailboxDeliveryConnectorProtocolLoggingLevel <None |
Verbose>] [-MailboxSubmissionAgentLogEnabled <$true |
$false>] [-MailboxSubmissionAgentLogMaxAge
<EnhancedTimeSpan>]
[-MailboxSubmissionAgentLogMaxDirectorySize <Unlimited>]
[-MailboxSubmissionAgentLogMaxFileSize <Unlimited>]
[-MailboxSubmissionAgentLogPath <LocalLongFullPath>]
[-MaxConcurrentMailboxDeliveries <Int32>]
[-MaxConcurrentMailboxSubmissions <Int32>]
[-PipelineTracingEnabled <$true | $false>]
[-PipelineTracingPath <LocalLongFullPath>]
[-PipelineTracingSenderAddress <SmtpAddress>]
[-ReceiveProtocolLogMaxAge <EnhancedTimeSpan>]
[-ReceiveProtocolLogMaxDirectorySize <Unlimited>]
[-ReceiveProtocolLogMaxFileSize <Unlimited>]
[-ReceiveProtocolLogPath <LocalLongFullPath>]
[-SendProtocolLogMaxAge <EnhancedTimeSpan>]
[-SendProtocolLogMaxDirectorySize <Unlimited>]
[-SendProtocolLogMaxFileSize <Unlimited>]
[-SendProtocolLogPath <LocalLongFullPath>] [-WhatIf
[<SwitchParameter>]]
|
Examples
Example 1
This example sets the ReceiveProtocolLogPath parameter to C:\SMTP Protocol Logs\Receive.log for the Mailbox Transport service on server Mailbox01.
Copy Code | |
---|---|
Set-MailboxTransportService Mailbox01 -ReceiveProtocolLogPath "C:\SMTP Protocol Logs\Receive.log" |
Detailed Description
The Mailbox Transport service runs on all Mailbox servers and is responsible for delivering messages to and accepting messages from local mailbox databases using a remote procedure call (RPC). The Mailbox Transport service also uses SMTP to send messages to and from the Transport service that runs on all Mailbox servers for routing messages to their ultimate destinations.
You need to be assigned permissions before you can run this cmdlet. Although all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they're not included in the permissions assigned to you. To see what permissions you need, see the "Mailbox Transport service" entries in the Mail Flow Permissions topic.
Parameters
Parameter | Required | Type | Description |
---|---|---|---|
Identity |
Required |
Microsoft.Exchange.Configuration.Tasks.MailboxTransportServerIdParameter |
The Identity parameter specifies the server that you want to modify. |
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
The Confirm switch causes the command to pause processing and requires you to acknowledge what the command will do before processing continues. You don't have to specify a value with the Confirm switch. |
ConnectivityLogEnabled |
Optional |
System.Boolean |
The ConnectivityLogEnabled parameter specifies whether
the connectivity log is enabled. The default value is
|
ConnectivityLogMaxAge |
Optional |
Microsoft.Exchange.Data.EnhancedTimeSpan |
The ConnectivityLogMaxAge parameter specifies the maximum age for the connectivity log file. Log files older than the specified value are deleted. The default value is 30 days. To specify a value, enter it as a time span: dd.hh:mm:ss where d = days, h = hours, m = minutes, and s = seconds. For example, to specify 25 days for this parameter, use 25.00:00:00. The valid input range for this parameter is from 00:00:00 through 24855.03:14:07. Setting the value of the ConnectivityLogMaxAge parameter to 00:00:00 prevents the automatic removal of connectivity log files because of their age. |
ConnectivityLogMaxDirectorySize |
Optional |
Microsoft.Exchange.Data.Unlimited |
The ConnectivityLogMaxDirectorySize 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 1000 MB. When you enter a value, qualify the value with one of the following units:
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 from 1 through
9223372036854775807 bytes. If you enter a value of
|
ConnectivityLogMaxFileSize |
Optional |
Microsoft.Exchange.Data.Unlimited |
The ConnectivityLogMaxFileSize 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:
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 from 1 through
9223372036854775807 bytes. If you enter a value of
|
ConnectivityLogPath |
Optional |
Microsoft.Exchange.Data.LocalLongFullPath |
The ConnectivityLogPath parameter specifies the default
connectivity log directory location. The default location is
|
ContentConversionTracingEnabled |
Optional |
System.Boolean |
The ContentConversionTracingEnabled parameter specifies
whether content conversion tracing is enabled. Content conversion
tracing captures content conversion failures that occur in the
Transport service or in the Mailbox Transport service on the
Mailbox server. The default value is
|
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to Active Directory. |
MailboxDeliveryAgentLogEnabled |
Optional |
System.Boolean |
The MailboxDeliveryAgentLogEnabled parameter specifies
whether the agent log for the Mailbox Transport Delivery service is
enabled. The default value is |
MailboxDeliveryAgentLogMaxAge |
Optional |
Microsoft.Exchange.Data.EnhancedTimeSpan |
The MailboxDeliveryAgentLogMaxAge parameter specifies the
maximum age for the agent log file of the Mailbox Transport
Delivery service. Log files older than the specified value are
deleted. The default value is To specify a value, enter it as a time span: dd.hh:mm:ss where d = days, h = hours, m = minutes, and s = seconds. Setting the value of the MailboxDeliveryAgentLogMaxAge parameter to 00:00:00 prevents the automatic removal of agent log files because of their age. |
MailboxDeliveryAgentLogMaxDirectorySize |
Optional |
Microsoft.Exchange.Data.Unlimited |
The MailboxDeliveryAgentLogMaxDirectorySize parameter specifies the maximum size of all Mailbox Transport Delivery service agent logs in the agent 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:
Unqualified values are treated as bytes. The value of the MailboxDeliveryAgentLogMaxFileSize
parameter must be less than or equal to the value of the
MailboxDeliveryAgentLogMaxDirectorySize parameter. If you
enter a value of |
MailboxDeliveryAgentLogMaxFileSize |
Optional |
Microsoft.Exchange.Data.Unlimited |
The MailboxDeliveryAgentLogMaxFileSize parameter specifies the maximum size of each agent log file for the Mailbox Transport Delivery service. 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:
Unqualified values are treated as bytes. The value of the MailboxDeliveryAgentLogMaxFileSize
parameter must be less than or equal to the value of the
MailboxDeliveryAgentLogMaxDirectorySize parameter. If you
enter a value of |
MailboxDeliveryAgentLogPath |
Optional |
Microsoft.Exchange.Data.LocalLongFullPath |
The MailboxDeliveryAgentLogPath parameter specifies the
default agent log directory location for the Mailbox Transport
Delivery service. The default location is
|
MailboxDeliveryConnectorProtocolLoggingLevel |
Optional |
Microsoft.Exchange.Data.ProtocolLoggingLevel |
The MailboxDeliveryConnectorProtocolLoggingLevel
parameter sets the protocol logging level for messages transferred
from the Transport service to the Mailbox Transport Delivery
service on Mailbox servers using SMTP. Valid values for this
parameter are |
MailboxSubmissionAgentLogEnabled |
Optional |
System.Boolean |
The MailboxSubmissionAgentLogEnabled parameter specifies
whether the agent log is enabled for the Mailbox Transport
Submission service. The default value is |
MailboxSubmissionAgentLogMaxAge |
Optional |
Microsoft.Exchange.Data.EnhancedTimeSpan |
The MailboxSubmissionAgentLogMaxAge parameter specifies
the maximum age for the agent log file of the Mailbox Transport
Submission service. Log files older than the specified value are
deleted. The default value is To specify a value, enter it as a time span: dd.hh:mm:ss where d = days, h = hours, m = minutes, and s = seconds. Setting the value of the MailboxSubmissionAgentLogMaxAge parameter to 00:00:00 prevents the automatic removal of agent log files because of their age. |
MailboxSubmissionAgentLogMaxDirectorySize |
Optional |
Microsoft.Exchange.Data.Unlimited |
The MailboxSubmissionAgentLogMaxDirectorySize parameter specifies the maximum size of all Mailbox Transport Submission service agent logs in the agent 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:
Unqualified values are treated as bytes. The value of the MailboxSubmissionAgentLogMaxFileSize
parameter must be less than or equal to the value of the
MailboxSubmissionAgentLogMaxDirectorySize parameter. If you
enter a value of |
MailboxSubmissionAgentLogMaxFileSize |
Optional |
Microsoft.Exchange.Data.Unlimited |
The MailboxSubmissionAgentLogMaxFileSize parameter specifies the maximum size of each agent log file for the Mailbox Transport Submission service. 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:
Unqualified values are treated as bytes. The value of the MailboxSubmissionAgentLogMaxFileSize
parameter must be less than or equal to the value of the
MailboxSubmissionAgentLogMaxDirectorySize parameter. If you
enter a value of |
MailboxSubmissionAgentLogPath |
Optional |
Microsoft.Exchange.Data.LocalLongFullPath |
The MailboxSubmissionAgentLogPath parameter specifies the
default agent log directory location for the Mailbox Transport
Submission service. The default location is
|
MaxConcurrentMailboxDeliveries |
Optional |
System.Int32 |
The MaxConcurrentMailboxDeliveries parameter specifies the maximum number of delivery threads that the transport service can have open at the same time to deliver messages to mailboxes. The default value is 20. The valid input range for this parameter is from 1 through 256. We recommend that you don't modify the default value unless Microsoft Customer Service and Support advises you to do this. |
MaxConcurrentMailboxSubmissions |
Optional |
System.Int32 |
The MaxConcurrentMailboxSubmissions parameter specifies the maximum number of submission threads that the transport service 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 from 1 through 256. |
PipelineTracingEnabled |
Optional |
System.Boolean |
The PipelineTracingEnabled parameter specifies whether to
enable pipeline tracing. Pipeline tracing captures message snapshot
files that record the changes made to the message by each transport
agent configured in the transport service on the 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
transport service where you enable pipeline tracing. The default
value is |
PipelineTracingPath |
Optional |
Microsoft.Exchange.Data.LocalLongFullPath |
The PipelineTracingPath parameter specifies the location
of the pipeline tracing logs. The default location is
|
PipelineTracingSenderAddress |
Optional |
Microsoft.Exchange.Data.SmtpAddress |
The PipelineTracingSenderAddress parameter specifies the
sender email 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 |
ReceiveProtocolLogMaxAge |
Optional |
Microsoft.Exchange.Data.EnhancedTimeSpan |
The ReceiveProtocolLogMaxAge 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 it as a time span: dd.hh:mm:ss where d = days, h = hours, m = minutes, and s = seconds. For example, to specify 20 days for this parameter, use 20.00:00:00. The valid input range for this parameter is from 00:00:00 through 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 |
The ReceiveProtocolLogMaxDirectorySize parameter specifies the maximum size of the Receive connector protocol log directory 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:
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 from 1 through
9223372036854775807 bytes. If you enter a value of
|
ReceiveProtocolLogMaxFileSize |
Optional |
Microsoft.Exchange.Data.Unlimited |
The ReceiveProtocolLogMaxFileSize parameter specifies the maximum size of the Receive connector protocol log files 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:
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 from 1 through
9223372036854775807 bytes. If you enter a value of
|
ReceiveProtocolLogPath |
Optional |
Microsoft.Exchange.Data.LocalLongFullPath |
The ReceiveProtocolLogPath parameter specifies the path
of the protocol log directory for all the Receive connectors that
exist on the server. The default location is
|
SendProtocolLogMaxAge |
Optional |
Microsoft.Exchange.Data.EnhancedTimeSpan |
The SendProtocolLogMaxAge parameter specifies the Send connector protocol log file maximum age. Log files older than the specified value are deleted. The default value is 30 days. To specify a value, enter it as a time span: dd.hh:mm:ss where d = days, h = hours, m = minutes, and s = seconds. For example, to specify 25 days for this parameter, use 25.00:00:00. The valid input range for this parameter is from 00:00:00 through 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 |
The SendProtocolLogMaxDirectorySize 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 units:
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 from 1 through 9223372036854775807
bytes. If you enter a value of |
SendProtocolLogMaxFileSize |
Optional |
Microsoft.Exchange.Data.Unlimited |
The SendProtocolLogMaxFileSize parameter specifies the maximum size of the Send connector protocol log files 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: When you enter a value, qualify the value with one of the following units:
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 from 1 through 9223372036854775807
bytes. If you enter a value of |
SendProtocolLogPath |
Optional |
Microsoft.Exchange.Data.LocalLongFullPath |
The SendProtocolLogPath parameter specifies the location
of protocol log storage for the Send connectors. The default
location is
|
WhatIf |
Optional |
System.Management.Automation.SwitchParameter |
The WhatIf switch instructs the command to simulate the actions that it would take on the object. By using the WhatIf switch, you can view what changes would occur without having to apply any of those changes. You don't have to specify a value with the WhatIf switch. |
Input Types
To see the input types that this cmdlet accepts, see Cmdlet Input and Output Types. If the Input Type field for a cmdlet is blank, the cmdlet doesn’t accept input data.
Return Types
To see the return types, which are also known as output types, that this cmdlet accepts, see Cmdlet Input and Output Types. If the Output Type field is blank, the cmdlet doesn’t return data.