Commands › Exchange Online

Remove-EdgeSubscription

Exchange Online ExchangeOnlineManagement Remove-*

Remove Edge Subscription from the Exchange organization and from the subscribed Edge Transport server.

Quick start script

# Remove-EdgeSubscription — 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-EdgeSubscription
$before | Format-List

# 3. Make the change (dry run first)
Remove-EdgeSubscription -Identity <TransportServerIdParameter> -WhatIf
Remove-EdgeSubscription -Identity <TransportServerIdParameter>

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

Syntax

Remove-EdgeSubscription [-Identity] <TransportServerIdParameter>
 [-Confirm]
 [-DomainController <Fqdn>]
 [-Force]
 [-WhatIf]
 [<CommonParameters>]

Parameters (5)

ParameterTypeRequiredWhat it controls
-Identity TransportServerIdParameter yes The Identity parameter specifies the identity of the Edge Transport server for which you want to remove Edge Subscription. The identity is expressed as the host name of the Edge Transport server.
-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...
-Force SwitchParameter The Force switch hides warning or confirmation messages. 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.