Commands › Exchange Online

Remove-DeviceTenantPolicy

Exchange Online ExchangeOnlineManagement Remove-*

For more information, see Security & Compliance PowerShell. Use the Remove-DeviceTenantPolicy cmdlet to remove your organization's mobile device tenant policy from Basic Mobility and Security in Microsoft 365.

Quick start script

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

# 3. Make the change (dry run first)
Remove-DeviceTenantPolicy  -WhatIf
Remove-DeviceTenantPolicy

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

Syntax

Remove-DeviceTenantPolicy [-Identity <PolicyIdParameter>]
 [-Confirm]
 [-WhatIf]
 [<CommonParameters>]

Parameters (3)

Parameter	Type	What it controls
-Identity	PolicyIdParameter	The Identity parameter specifies the name of the mobile device tenant policy that you want to remove, but there's only one in your organization. The name of the policy is a GUID value. 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.
-WhatIf	SwitchParameter	The WhatIf switch doesn't work in Security & Compliance PowerShell.

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