Commands › Exchange Online
Update-HybridConfiguration
Define the credentials that are used to update the hybrid configuration object.
Quick start script
# Update-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)
Update-HybridConfiguration -OnPremisesCredentials <PSCredential> -TenantCredentials <PSCredential> -WhatIf
Update-HybridConfiguration -OnPremisesCredentials <PSCredential> -TenantCredentials <PSCredential>
# 4. Verify and diff
$after = Get-HybridConfiguration
Compare-Object ($before | Out-String) ($after | Out-String)Syntax
Update-HybridConfiguration -OnPremisesCredentials <PSCredential> -TenantCredentials <PSCredential>
[-Confirm]
[-DomainController <Fqdn>]
[-ForceUpgrade]
[-SuppressOAuthWarning]
[-WhatIf]
[<CommonParameters>]Parameters (7)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -OnPremisesCredentials | PSCredential | yes | The OnPremisesCredentials parameter specifies the on-premises Active Directory account and password that's used to configure the hybrid configuration object. This account must be a member of the Organization... |
| -TenantCredentials | PSCredential | yes | The TenantCredentials parameter specifies the Microsoft 365 organization account and password that's used to configure the hybrid configuration object. This is often the administrator account that's assigned when the... |
| -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 | This parameter is available only in on-premises Exchange. | |
| -ForceUpgrade | SwitchParameter | The ForceUpgrade switch suppresses the confirmation message that appears if the object was created in a previous version of Exchange. You don't need to specify a value with this switch. | |
| -SuppressOAuthWarning | SwitchParameter | This parameter is reserved for internal Microsoft use. | |
| -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.