Commands › Exchange Online
Set-MailboxTransportService
Modify the configuration of the Mailbox Transport service on Exchange 2013 or later Mailbox servers.
Quick start script
# Set-MailboxTransportService — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-ExchangeOnline -CertificateThumbprint $thumb -AppId $appId -Organization $org
# 2. Capture the current state first — you cannot roll back what you never recorded
$before = Get-MailboxTransportService
$before | Format-List
# 3. Make the change (dry run first)
Set-MailboxTransportService -Identity <MailboxTransportServerIdParameter> -WhatIf
Set-MailboxTransportService -Identity <MailboxTransportServerIdParameter>
# 4. Verify and diff
$after = Get-MailboxTransportService
Compare-Object ($before | Out-String) ($after | Out-String)Syntax
Set-MailboxTransportService [-Identity] <MailboxTransportServerIdParameter>
[-Confirm]
[-ConnectivityLogEnabled <Boolean>]
[-ConnectivityLogMaxAge <EnhancedTimeSpan>]
[-ConnectivityLogMaxDirectorySize <Unlimited>]
[-ConnectivityLogMaxFileSize <Unlimited>]
[-ConnectivityLogPath <LocalLongFullPath>]
[-ContentConversionTracingEnabled <Boolean>]
[-DomainController <Fqdn>]
[-MailboxDeliveryAgentLogEnabled <Boolean>]
[-MailboxDeliveryAgentLogMaxAge <EnhancedTimeSpan>]
[-MailboxDeliveryAgentLogMaxDirectorySize <Unlimited>]
[-MailboxDeliveryAgentLogMaxFileSize <Unlimited>]
[-MailboxDeliveryAgentLogPath <LocalLongFullPath>]
[-MailboxDeliveryConnectorMaxInboundConnection <Unlimited>]
[-MailboxDeliveryConnectorProtocolLoggingLevel <ProtocolLoggingLevel>]
[-MailboxDeliveryConnectorSMTPUtf8Enabled <Boolean>]
[-MailboxDeliveryThrottlingLogEnabled <Boolean>]
[-MailboxDeliveryThrottlingLogMaxAge <EnhancedTimeSpan>]
[-MailboxDeliveryThrottlingLogMaxDirectorySize <Unlimited>]
[-MailboxDeliveryThrottlingLogMaxFileSize <Unlimited>]
[-MailboxDeliveryThrottlingLogPath <LocalLongFullPath>]
[-MailboxSubmissionAgentLogEnabled <Boolean>]
[-MailboxSubmissionAgentLogMaxAge <EnhancedTimeSpan>]
[-MailboxSubmissionAgentLogMaxDirectorySize <Unlimited>]
[-MailboxSubmissionAgentLogMaxFileSize <Unlimited>]
[-MailboxSubmissionAgentLogPath <LocalLongFullPath>]
[-MaxConcurrentMailboxDeliveries <Int32>]
[-MaxConcurrentMailboxSubmissions <Int32>]
[-PipelineTracingEnabled <Boolean>]
[-PipelineTracingPath <LocalLongFullPath>]
[-PipelineTracingSenderAddress <SmtpAddress>]
[-ReceiveProtocolLogMaxAge <EnhancedTimeSpan>]
[-ReceiveProtocolLogMaxDirectorySize <Unlimited>]
[-ReceiveProtocolLogMaxFileSize <Unlimited>]
[-ReceiveProtocolLogPath <LocalLongFullPath>]
[-RoutingTableLogMaxAge <EnhancedTimeSpan>]
[-RoutingTableLogMaxDirectorySize <Unlimited>]
[-RoutingTableLogPath <LocalLongFullPath>]
[-SendProtocolLogMaxAge <EnhancedTimeSpan>]
[-SendProtocolLogMaxDirectorySize <Unlimited>]
[-SendProtocolLogMaxFileSize <Unlimited>]
[-SendProtocolLogPath <LocalLongFullPath>]
[-WhatIf]
[<CommonParameters>]Parameters (44)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -Identity | MailboxTransportServerIdParameter | yes | The Identity parameter specifies the server that you want to modify. |
| -Confirm | SwitchParameter | The Confirm switch specifies whether to show or hide the confirmation prompt. How this switch affects the cmdlet depends on whether the cmdlet requires confirmation before proceeding. | |
| -ConnectivityLogEnabled | Boolean | The ConnectivityLogEnabled parameter specifies whether the connectivity log is enabled. The default value is $true. | |
| -ConnectivityLogMaxAge | 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. | |
| -ConnectivityLogMaxDirectorySize | 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... | |
| -ConnectivityLogMaxFileSize | 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. | |
| -ConnectivityLogPath | LocalLongFullPath | The ConnectivityLogPath parameter specifies the default connectivity log directory location. The default location is %ExchangeInstallPath%TransportRoles\\Logs\\Mailbox\\Connectivity. Setting the value of this... | |
| -ContentConversionTracingEnabled | 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... | |
| -DomainController | Fqdn | The DomainController parameter specifies the domain controller that's used by this cmdlet to read data from or write data to Active Directory. You identify the domain controller by its fully qualified domain name... | |
| -MailboxDeliveryAgentLogEnabled | Boolean | The MailboxDeliveryAgentLogEnabled parameter specifies whether the agent log for the Mailbox Transport Delivery service is enabled. The default value is $true. | |
| -MailboxDeliveryAgentLogMaxAge | 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... | |
| -MailboxDeliveryAgentLogMaxDirectorySize | 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... | |
| -MailboxDeliveryAgentLogMaxFileSize | 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.... | |
| -MailboxDeliveryAgentLogPath | LocalLongFullPath | The MailboxDeliveryAgentLogPath parameter specifies the default agent log directory location for the Mailbox Transport Delivery service. The default location is... | |
| -MailboxDeliveryConnectorMaxInboundConnection | Unlimited | The MailboxDeliveryConnectorMaxInboundConnection parameter specifies the maximum number of inbound connections for the implicit and invisible mailbox delivery Receive connector in the Mailbox Transport Delivery... | |
| -MailboxDeliveryConnectorProtocolLoggingLevel | ProtocolLoggingLevel | The MailboxDeliveryConnectorProtocolLoggingLevel parameter enables or disables SMTP protocol logging for the implicit and invisible mailbox delivery Receive connector in the Mailbox Transport Delivery service. Valid... | |
| -MailboxDeliveryConnectorSmtpUtf8Enabled | Boolean | The MailboxDeliveryConnectorSmtpUtf8Enabled parameters or disables email address internationalization (EAI) support for the implicit and invisible mailbox delivery Receive connector in the Mailbox Transport Delivery... | |
| -MailboxDeliveryThrottlingLogEnabled | Boolean | The MailboxDeliveryThrottlingLogEnabled parameter specifies whether the mailbox delivery throttling log is enabled. The default value is $true. | |
| -MailboxDeliveryThrottlingLogMaxAge | EnhancedTimeSpan | The MailboxDeliveryThrottlingLogMaxAge parameter specifies the maximum age for the mailbox delivery throttling log file. Log files older than the specified value are deleted. The default value is 7.00:00:00 or 7 days. | |
| -MailboxDeliveryThrottlingLogMaxDirectorySize | Unlimited | The MailboxDeliveryThrottlingLogMaxDirectorySize parameter specifies the maximum size of all mailbox delivery throttling logs in the mailbox delivery throttling log directory. When a directory reaches its maximum... | |
| -MailboxDeliveryThrottlingLogMaxFileSize | Unlimited | The MailboxDeliveryThrottlingLogMaxFileSize parameter specifies the maximum size of each mailbox delivery throttling log file. When a log file reaches its maximum file size, a new log file is created. The default... | |
| -MailboxDeliveryThrottlingLogPath | LocalLongFullPath | The MailboxDeliveryThrottlingLogPath parameter specifies the default mailbox delivery throttling log directory location. The default location is %ExchangeInstallPath%TransportRoles\\Logs\\Throttling\\Delivery.... | |
| -MailboxSubmissionAgentLogEnabled | Boolean | The MailboxSubmissionAgentLogEnabled parameter specifies whether the agent log is enabled for the Mailbox Transport Submission service. The default value is $true. | |
| -MailboxSubmissionAgentLogMaxAge | 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... | |
| -MailboxSubmissionAgentLogMaxDirectorySize | 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,... | |
| -MailboxSubmissionAgentLogMaxFileSize | 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... | |
| -MailboxSubmissionAgentLogPath | LocalLongFullPath | The MailboxSubmissionAgentLogPath parameter specifies the default agent log directory location for the Mailbox Transport Submission service. The default location is... | |
| -MaxConcurrentMailboxDeliveries | 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... | |
| -MaxConcurrentMailboxSubmissions | 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... | |
| -PipelineTracingEnabled | 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... | |
| -PipelineTracingPath | LocalLongFullPath | The PipelineTracingPath parameter specifies the location of the pipeline tracing logs. The default location is %ExchangeInstallPath%TransportRoles\\Logs\\Mailbox\\PipelineTracing. The path must be local to the... | |
| -PipelineTracingSenderAddress | 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... | |
| -ReceiveProtocolLogMaxAge | EnhancedTimeSpan | The ReceiveProtocolLogMaxAge parameter specifies the maximum age of a protocol log file for the implicit and invisible mailbox delivery Receive connector in the Mailbox Transport Delivery service. Log files that are... | |
| -ReceiveProtocolLogMaxDirectorySize | Unlimited | The ReceiveProtocolLogMaxDirectorySize parameter specifies the maximum size of the protocol log directory for the implicit and invisible mailbox delivery Receive connector in the Mailbox Transport Delivery service.... | |
| -ReceiveProtocolLogMaxFileSize | Unlimited | The ReceiveProtocolLogMaxFileSize parameter specifies the maximum size of a protocol log file for the implicit and invisible mailbox delivery Receive connector in the Mailbox Transport Delivery service. When a log... | |
| -ReceiveProtocolLogPath | LocalLongFullPath | The ReceiveProtocolLogPath parameter specifies the location of the protocol log directory for the implicit and invisible mailbox delivery Receive connector in the Mailbox Transport Delivery service. The default... | |
| -RoutingTableLogMaxAge | EnhancedTimeSpan | The RoutingTableLogMaxAge parameter specifies the maximum routing table log age. Log files older than the specified value are deleted. The default value is 7 days. | |
| -RoutingTableLogMaxDirectorySize | Unlimited | The RoutingTableLogMaxDirectorySize 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... | |
| -RoutingTableLogPath | LocalLongFullPath | The RoutingTableLogPath parameter specifies the directory location where routing table log files should be stored. The default location is %ExchangeInstallPath%TransportRoles\\Logs\\Mailbox\\Routing. Setting this... | |
| -SendProtocolLogMaxAge | EnhancedTimeSpan | The SendProtocolLogMaxAge parameter specifies the maximum age of a protocol log file for the implicit and invisible intra-organization Send connector in the Mailbox Transport Submission service. Log files that are... | |
| -SendProtocolLogMaxDirectorySize | Unlimited | The SendProtocolLogMaxDirectorySize parameter specifies the maximum size of the protocol log directory for the implicit and invisible intra-organization Send connector in the Mailbox Transport Submission service.... | |
| -SendProtocolLogMaxFileSize | Unlimited | The SendProtocolLogMaxFileSize parameter specifies the maximum size of a protocol log file for the implicit and invisible intra-organization Send connector in the Mailbox Transport Submission service. When a log file... | |
| -SendProtocolLogPath | LocalLongFullPath | The SendProtocolLogPath parameter specifies the location of the protocol log directory for the implicit and invisible intra-organization Send connector in the Mailbox Transport Submission service. The default... | |
| -WhatIf | SwitchParameter | The WhatIf switch shows what the command does without making any changes. You don't need to specify a value with this switch. |
Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.