Remove an address book policy

You can only remove an address book policy (ABP) in Exchange Online PowerShell. To connect to Exchange Online PowerShell, see Connect to Exchange Online PowerShell.

For more information about address book policies, see Address book policies.

What do you need to know before you begin?

Tip

Having problems? Ask for help in the Exchange forums. Visit the forums at Exchange Online or Exchange Online Protection.

Use Exchange Online PowerShell to remove an ABP

Step 1: Verify the ABP isn't assigned to a mailbox

You can't remove an ABP if it's assigned to a mailbox.

To see if the ABP is assigned to an active mailbox, replace <AddressBookPolicyName> with the name of the ABP and run the following command:

Get-Mailbox | Where $._AddressBookPolicy -eq "<AddressBookPolicyName>"

To see if the ABP is assigned to a soft-deleted mailbox, replace <AddressBookPolicyName> with the name of the ABP and run the following command:

Get-Mailbox -SoftDeletedMailbox | Where $._AddressBookPolicy -eq "<AddressBookPolicyName>"

To remove the ABP assignment from mailboxes, replace <AddressBookPolicyName> with the name of the ABP and run one or both of the following commands:

Get-Mailbox | Where $._AddressBookPolicy -eq "<AddressBookPolicyName>" | Set-Mailbox -AddressBookPolicy $null
Get-Mailbox -SoftDeletedMailbox | Where $._AddressBookPolicy -eq "<AddressBookPolicyName>" | Set-Mailbox -AddressBookPolicy $null

Step 2: Remove the ABP

This example removes the ABP named ABP TailspinToys.

Remove-AddressBookPolicy -Identity "ABP TailspinToys"

For detailed syntax and parameter information, see Remove-AddressBookPolicy.