Commands › Exchange Online
Set-TransportConfig
Modify the transport configuration settings for the whole Exchange organization.
Quick start script
# Set-TransportConfig — 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-TransportConfig
$before | Format-List
# 3. Make the change (dry run first)
Set-TransportConfig -WhatIf
Set-TransportConfig
# 4. Verify and diff
$after = Get-TransportConfig
Compare-Object ($before | Out-String) ($after | Out-String)Syntax
Set-TransportConfig [[-Identity] <OrganizationIdParameter>]
[-AddressBookPolicyRoutingEnabled <Boolean>]
[-AgentGeneratedMessageLoopDetectionInSmtpEnabled <Boolean>]
[-AgentGeneratedMessageLoopDetectionInSubmissionEnabled <Boolean>]
[-AllowLegacyTLSClients <System.Boolean>]
[-ClearCategories <Boolean>]
[-Confirm]
[-ConvertDisclaimerWrapperToEml <Boolean>]
[-DiagnosticsAggregationServicePort <Int32>]
[-DomainController <Fqdn>]
[-DSNConversionMode <DSNConversionOption>]
[-ExternalDelayDsnEnabled <Boolean>]
[-ExternalDsnDefaultLanguage <CultureInfo>]
[-ExternalDsnLanguageDetectionEnabled <Boolean>]
[-ExternalDsnMaxMessageAttachSize <ByteQuantifiedSize>]
[-ExternalDsnReportingAuthority <SmtpDomain>]
[-ExternalDsnSendHtml <Boolean>]
[-ExternalPostmasterAddress <SmtpAddress>]
[-Force]
[-GenerateCopyOfDSNFor <MultiValuedProperty>]
[-HeaderPromotionModeSetting <HeaderPromotionMode>]
[-InternalDelayDsnEnabled <Boolean>]
[-InternalDsnDefaultLanguage <CultureInfo>]
[-InternalDsnLanguageDetectionEnabled <Boolean>]
[-InternalDsnMaxMessageAttachSize <ByteQuantifiedSize>]
[-InternalDsnReportingAuthority <SmtpDomain>]
[-InternalDsnSendHtml <Boolean>]
[-InternalSMTPServers <MultiValuedProperty>]
[-JournalMessageExpirationDays <Int32>]
[-JournalingReportNdrTo <SmtpAddress>]
[-LegacyJournalingMigrationEnabled <Boolean>]
[-MaxAllowedAgentGeneratedMessageDepth <UInt32>]
[-MaxAllowedAgentGeneratedMessageDepthPerAgent <UInt32>]
[-MaxDumpsterSizePerDatabase <ByteQuantifiedSize>]
[-MaxDumpsterTime <EnhancedTimeSpan>]
[-MaxReceiveSize <Unlimited>]
[-MaxRecipientEnvelopeLimit <Unlimited>]
[-MaxRetriesForLocalSiteShadow <Int32>]
[-MaxRetriesForRemoteSiteShadow <Int32>]
[-MaxSendSize <Unlimited>]
[-MessageExpiration <EnhancedTimeSpan>]
[-PreventDuplicateJournalingEnabled <Boolean>]
[-QueueDiagnosticsAggregationInterval <EnhancedTimeSpan>]
[-RejectMessageOnShadowFailure <Boolean>]
[-ReplyAllStormBlockDurationHours <Int32>]
[-ReplyAllStormDetectionMinimumRecipients <Int32>]
[-ReplyAllStormDetectionMinimumReplies <Int32>]
[-ReplyAllStormProtectionEnabled <Boolean>]
[-Rfc2231EncodingEnabled <Boolean>]
[-SafetyNetHoldTime <EnhancedTimeSpan>]
[-ShadowHeartbeatFrequency <EnhancedTimeSpan>]
[-ShadowHeartbeatRetryCount <Int32>]
[-ShadowHeartbeatTimeoutInterval <EnhancedTimeSpan>]
[-ShadowMessageAutoDiscardInterval <EnhancedTimeSpan>]
[-ShadowMessagePreferenceSetting <ShadowMessagePreference>]
[-ShadowRedundancyEnabled <Boolean>]
[-ShadowResubmitTimeSpan <EnhancedTimeSpan>]
[-SmtpClientAuthenticationDisabled <Boolean>]
[-SupervisionTags <MultiValuedProperty>]
[-TLSReceiveDomainSecureList <MultiValuedProperty>]
[-TLSSendDomainSecureList <MultiValuedProperty>]
[-TransportRuleAttachmentTextScanLimit <ByteQuantifiedSize>]
[-VerifySecureSubmitEnabled <Boolean>]
[-VoicemailJournalingEnabled <Boolean>]
[-WhatIf]
[-Xexch50Enabled <Boolean>]
[<CommonParameters>]Parameters (66)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -Identity | OrganizationIdParameter | This parameter is available only in on-premises Exchange. | |
| -AddressBookPolicyRoutingEnabled | Boolean | The AddressBookPolicyRoutingEnabled parameter controls how recipients are resolved in an organization that uses address book policies to create separate virtual organizations within the same Exchange organization.... | |
| -AgentGeneratedMessageLoopDetectionInSubmissionEnabled | Boolean | This parameter is available only in on-premises Exchange. | |
| -AgentGeneratedMessageLoopDetectionInSmtpEnabled | Boolean | This parameter is available only in on-premises Exchange. | |
| -AllowLegacyTLSClients | Boolean | This parameter is available only in the cloud-based service. | |
| -ClearCategories | Boolean | The ClearCategories parameter keeps or removes Microsoft Outlook message categories during content conversion. Valid input for this parameter is $true or $false. The default value is $true. This means that by... | |
| -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. | |
| -ConvertDisclaimerWrapperToEml | Boolean | The ConvertDisclaimerWrapperToEml parameter specifies whether the original message is added as a TNEF attachment or a regular EML attachment to a disclaimer when all of the following are true: | |
| -DiagnosticsAggregationServicePort | Int32 | This parameter is available only in on-premises Exchange. | |
| -DomainController | Fqdn | This parameter is available only in on-premises Exchange. | |
| -DSNConversionMode | DSNConversionOption | The DSNConversionMode parameter controls how Exchange handles delivery status notifications (also known as DSNs, non-delivery reports, NDRs, or bounce messages) that are generated by earlier versions of Exchange or... | |
| -ExternalDelayDsnEnabled | Boolean | The ExternalDelayDsnEnabled parameter specifies whether a delay delivery status notification (DSN) message should be created for external messages that couldn't be immediately delivered. Valid input for this... | |
| -ExternalDsnDefaultLanguage | CultureInfo | The ExternalDsnDefaultLanguage parameter specifies which Exchange server language should be used by default when you create external DSN messages. The default value is the default Windows server language. | |
| -ExternalDsnLanguageDetectionEnabled | Boolean | The ExternalDsnLanguageDetectionEnabled parameter specifies whether the server should try to send an external DSN message in the same language as the original message that generated the notification. Valid input for... | |
| -ExternalDsnMaxMessageAttachSize | ByteQuantifiedSize | This parameter is available only in on-premises Exchange. | |
| -ExternalDsnReportingAuthority | SmtpDomain | The ExternalDsnReportingAuthority parameter specifies the domain in the machine-readable part of external DSN messages. The default value is blank ($null), which means the value is the authoritative domain that you... | |
| -ExternalDsnSendHtml | Boolean | The ExternalDsnSendHtml parameter specifies whether external DSN messages should be HTML or plain text. Valid values are: | |
| -ExternalPostmasterAddress | SmtpAddress | The ExternalPostmasterAddress parameter specifies the email address in the From header field of an external DSN message. The default value is blank ($null). | |
| -Force | SwitchParameter | The Force switch hides warning or confirmation messages. You don't need to specify a value with this switch. | |
| -GenerateCopyOfDSNFor | MultiValuedProperty | This parameter is available only in on-premises Exchange. | |
| -HeaderPromotionModeSetting | HeaderPromotionMode | The HeaderPromotionModeSetting parameter specifies whether named properties are created for custom X-headers on messages received. Valid values are: | |
| -InternalDelayDsnEnabled | Boolean | The InternalDelayDsnEnabled parameter specifies whether a delay DSN message should be created for messages sent to or from recipients or senders in the same Exchange organization that couldn't be immediately... | |
| -InternalDsnDefaultLanguage | CultureInfo | The InternalDsnDefaultLanguage parameter specifies which Exchange server language should be used by default when you create internal DSN messages. The default value is the default Windows server language. | |
| -InternalDsnLanguageDetectionEnabled | Boolean | The InternalDsnLanguageDetectionEnabled parameter specifies whether the server should try to send an internal DSN message in the same language as the original message that generated the notification. Valid input for... | |
| -InternalDsnMaxMessageAttachSize | ByteQuantifiedSize | This parameter is available only in on-premises Exchange. | |
| -InternalDsnReportingAuthority | SmtpDomain | The InternalDsnReportingAuthority parameter specifies the domain in the machine-readable part of internal DSN messages. The default value is blank ($null), which means the value is the authoritative domain that you... | |
| -InternalDsnSendHtml | Boolean | The InternalDsnSendHtml parameter specifies whether internal DSN messages should be HTML or plain text. Valid values are: | |
| -InternalSMTPServers | MultiValuedProperty | This parameter is available only in on-premises Exchange. | |
| -JournalMessageExpirationDays | Int32 | This parameter is available only in the cloud-based service. | |
| -JournalingReportNdrTo | SmtpAddress | The JournalingReportNdrTo parameter specifies the email address to which journal reports are sent if the journaling mailbox is unavailable. By default, if this parameter is left empty, Exchange continues to try to... | |
| -LegacyJournalingMigrationEnabled | Boolean | The LegacyJournalingMigrationEnabled parameter specifies whether journal messages generated in Microsoft Exchange Server 2003 is reformatted by Exchange 2010. | |
| -MaxAllowedAgentGeneratedMessageDepth | UInt32 | This parameter is available only in on-premises Exchange. | |
| -MaxAllowedAgentGeneratedMessageDepthPerAgent | UInt32 | This parameter is available only in on-premises Exchange. | |
| -MaxDumpsterSizePerDatabase | ByteQuantifiedSize | This parameter is available only in on-premises Exchange. | |
| -MaxDumpsterTime | EnhancedTimeSpan | This parameter is available only in on-premises Exchange. | |
| -MaxReceiveSize | Unlimited | This parameter is available only in on-premises Exchange. | |
| -MaxRecipientEnvelopeLimit | Unlimited | The MaxRecipientEnvelopeLimit parameter specifies the maximum number of recipients in a message. Exchange treats an unexpanded distribution group as one recipient. | |
| -MaxRetriesForLocalSiteShadow | Int32 | This parameter is available only in on-premises Exchange. | |
| -MaxRetriesForRemoteSiteShadow | Int32 | This parameter is available only in on-premises Exchange. | |
| -MaxSendSize | Unlimited | This parameter is available only in on-premises Exchange. | |
| -MessageExpiration | EnhancedTimeSpan | This parameter is available only in the cloud-based service. | |
| -PreventDuplicateJournalingEnabled | Boolean | This parameter is available only in the cloud-based service. | |
| -QueueDiagnosticsAggregationInterval | EnhancedTimeSpan | This parameter is available only in on-premises Exchange. | |
| -RejectMessageOnShadowFailure | Boolean | This parameter is available only in on-premises Exchange. | |
| -ReplyAllStormBlockDurationHours | Int32 | This parameter is available only in the cloud-based service. | |
| -ReplyAllStormDetectionMinimumRecipients | Int32 | This parameter is available only in the cloud-based service. | |
| -ReplyAllStormDetectionMinimumReplies | Int32 | This parameter is available only in the cloud-based service. | |
| -ReplyAllStormProtectionEnabled | Boolean | This parameter is available only in the cloud-based service. | |
| -Rfc2231EncodingEnabled | Boolean | The Rfc2231EncodingEnabled parameter specifies whether the RFC 2231 encoding of MIME parameters for outbound messages is enabled in your organization. Valid input for this parameter is $true or $false. The default... | |
| -SafetyNetHoldTime | EnhancedTimeSpan | This parameter is available only in on-premises Exchange. | |
| -ShadowHeartbeatFrequency | EnhancedTimeSpan | This parameter is available only in on-premises Exchange. | |
| -ShadowHeartbeatRetryCount | Int32 | This parameter is available only in on-premises Exchange. | |
| -ShadowHeartbeatTimeoutInterval | EnhancedTimeSpan | This parameter is available only in on-premises Exchange. | |
| -ShadowMessageAutoDiscardInterval | EnhancedTimeSpan | This parameter is available only in on-premises Exchange. | |
| -ShadowMessagePreferenceSetting | ShadowMessagePreference | This parameter is available only in on-premises Exchange. | |
| -ShadowRedundancyEnabled | Boolean | This parameter is available only in on-premises Exchange. | |
| -ShadowResubmitTimeSpan | EnhancedTimeSpan | This parameter is available only in on-premises Exchange. | |
| -SmtpClientAuthenticationDisabled | Boolean | This parameter is available only in the cloud-based service. | |
| -SupervisionTags | MultiValuedProperty | This parameter is available only in on-premises Exchange. | |
| -TLSReceiveDomainSecureList | MultiValuedProperty | This parameter is available only in on-premises Exchange. | |
| -TLSSendDomainSecureList | MultiValuedProperty | This parameter is available only in on-premises Exchange. | |
| -TransportRuleAttachmentTextScanLimit | ByteQuantifiedSize | This parameter is available only in on-premises Exchange. | |
| -VerifySecureSubmitEnabled | Boolean | This parameter is available only in on-premises Exchange. | |
| -VoicemailJournalingEnabled | Boolean | This parameter is functional only in on-premises Exchange. | |
| -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. | |
| -Xexch50Enabled | Boolean | This parameter is available only in on-premises Exchange. |
Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.