Commands › Exchange Online

Set-FederatedOrganizationIdentifier

Exchange Online ExchangeOnlineManagement Set-*

Configure the federated organization identifier for the Exchange organization. For more details, see Federation.

Quick start script

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

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

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

Syntax

Set-FederatedOrganizationIdentifier [[-Identity] <OrganizationIdParameter>]
 [-AccountNamespace <SmtpDomain>]
 [-Confirm]
 [-DefaultDomain <SmtpDomain>]
 [-DelegationFederationTrust <FederationTrustIdParameter>]
 [-DomainController <Fqdn>]
 [-Enabled <Boolean>]
 [-OrganizationContact <SmtpAddress>]
 [-WhatIf]
 [<CommonParameters>]

Parameters (9)

Parameter	Type	What it controls
-Identity	OrganizationIdParameter	The Identity parameter specifies the federated organization identifier.
-AccountNamespace	SmtpDomain	The AccountNamespace parameter specifies the federated domain to be used to establish the organization identifier with the Microsoft Federation Gateway.
-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.
-DefaultDomain	SmtpDomain	The DefaultDomain parameter specifies the federated domain used for delegation tokens issued by the Microsoft Federation Gateway for user accounts in the Exchange organization. If the DefaultDomain parameter isn't...
-DelegationFederationTrust	FederationTrustIdParameter	The DelegationFederationTrust parameter specifies the identity of the federation trust to be used by the organization identifier.
-DomainController	Fqdn	This parameter is available only in on-premises Exchange.
-Enabled	Boolean	The Enabled parameter specifies whether the organization identifier is enabled. Valid values include $true or $false.
-OrganizationContact	SmtpAddress	The OrganizationContact parameter specifies the SMTP address of the federation contact.
-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.