Commands › Exchange Online

Update-EmailAddressPolicy

Exchange Online ExchangeOnlineManagement Update-*

Apply new or updated email address policies to the affected recipients in an on-premises Exchange organization.

Quick start script

# Update-EmailAddressPolicy — 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-EmailAddressPolicy
$before | Format-List

# 3. Make the change (dry run first)
Update-EmailAddressPolicy -Identity <EmailAddressPolicyIdParameter> -WhatIf
Update-EmailAddressPolicy -Identity <EmailAddressPolicyIdParameter>

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

Syntax

Update-EmailAddressPolicy [-Identity] <EmailAddressPolicyIdParameter>
 [-Confirm]
 [-DomainController <Fqdn>]
 [-FixMissingAlias]
 [-UpdateSecondaryAddressesOnly]
 [-WhatIf]
 [<CommonParameters>]

Parameters (6)

Parameter	Type	Required	What it controls
-Identity	EmailAddressPolicyIdParameter	yes	The Identity parameter specifies the email address policy that you want to apply to recipients. You can use any value that uniquely identifies the policy. For example:
-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...
-FixMissingAlias	SwitchParameter		The FixMissingAlias switch repairs recipients that don't have an alias. The alias is generated based on the Name property of the recipient. You don't need to specify a value with this switch.
-UpdateSecondaryAddressesOnly	SwitchParameter		The UpdateSecondaryAddressesOnly switch specifies that only the proxy email addresses are updated for the recipients. You don't need to specify a value with this switch.
-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.