Commands › Exchange Online

Set-HybridConfiguration

Exchange Online ExchangeOnlineManagement Set-*

Modify the hybrid deployment between your on-premises Exchange organization and Exchange Online in Microsoft 365 for enterprises.

Quick start script

# Set-HybridConfiguration — 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-HybridConfiguration
$before | Format-List

# 3. Make the change (dry run first)
Set-HybridConfiguration  -WhatIf
Set-HybridConfiguration

# 4. Verify and diff
$after = Get-HybridConfiguration
Compare-Object ($before | Out-String) ($after | Out-String)

Syntax

Set-HybridConfiguration
 [-ClientAccessServers <MultiValuedProperty>]
 [-Confirm]
 [-DomainController <Fqdn>]
 [-Domains <MultiValuedProperty>]
 [-EdgeTransportServers <MultiValuedProperty>]
 [-ExternalIPAddresses <MultiValuedProperty>]
 [-Features <MultiValuedProperty>]
 [-Name <String>]
 [-OnPremisesSmartHost <SmtpDomain>]
 [-ReceivingTransportServers <MultiValuedProperty>]
 [-SecureMailCertificateThumbprint <String>]
 [-SendingTransportServers <MultiValuedProperty>]
 [-ServiceInstance <Int32>]
 [-TlsCertificateName <SmtpX509Identifier>]
 [-TransportServers <MultiValuedProperty>]
 [-WhatIf]
 [<CommonParameters>]

Parameters (16)

ParameterTypeRequiredWhat it controls
-ClientAccessServers MultiValuedProperty This parameter is available only in Exchange Server 2010.
-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.
-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...
-Domains MultiValuedProperty The Domains parameter specifies the domain namespaces used in the hybrid deployment. These domains must be configured as accepted domains in either on-premises Exchange or Exchange Online. The domains are used in...
-ExternalIPAddresses MultiValuedProperty The ExternalIPAddresses parameter is a legacy parameter that specifies the publicly accessible inbound IP address of Microsoft Exchange Server 2010 Hub Transport servers.
-Features MultiValuedProperty The Features parameter specifies the features that are enabled for the hybrid configuration. Valid values are:
-Name String This parameter is deprecated and no longer used.
-OnPremisesSmartHost SmtpDomain The OnPremisesSmartHost parameter specifies the FQDN of the on-premises Exchange Mailbox server used for secure mail transport between on-premises Exchange and Exchange Online.
-ReceivingTransportServers MultiValuedProperty The ReceivingTransportServers parameter specifies the Mailbox servers defined in the outbound connector configuration in Exchange Online. Valid values are:
-SecureMailCertificateThumbprint String The SecureMailCertificateThumbprint parameter specifies the thumbprint of the X.509 certificate to be used as the certificate for hybrid deployment secure message transport. This certificate can't be self-signed,...
-SendingTransportServers MultiValuedProperty The SendingTransportServers parameter specifies the Mailbox servers defined in the inbound connector configuration in Exchange Online. Valid values are:
-ServiceInstance Int32 This parameter is meaningful only in Office 365 operated by 21Vianet in China.
-TlsCertificateName SmtpX509Identifier The TlsCertificateName parameter specifies the X.509 certificate to use for TLS encryption. Valid syntax for this parameter is `"<I>X.500Issuer<S>X.500Subject"`:
-TransportServers MultiValuedProperty The TransportServers parameter specifies the Hub Transport servers in Exchange Server 2010 SP2 or later that are configured to support hybrid deployment features.
-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.
-EdgeTransportServers MultiValuedProperty The EdgeTransportServers parameter specifies the Edge Transport servers that are configured to support the hybrid deployment features. The Edge Transport server must be externally accessible from the Internet on port...

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.