Commands › Exchange Online

Remove-DeviceTenantRule

Exchange Online ExchangeOnlineManagement Remove-*

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

Quick start script

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

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

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

Syntax

Remove-DeviceTenantRule [-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 rule that you want to remove, but there's only one in your organization. The name of the rule is a GUID. 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.