Reassign and remove arbitration mailboxes that are used for moderated recipients
Among other things, arbitration mailboxes are used in the approval flow for moderated recipients. Specifically, messages that are waiting for approval by a moderator are temporarily stored in the arbitration mailbox that's specified for the moderated recipient. The original message is kept in the arbitration mailbox until a moderator takes action on the message.
If you try to remove an arbitration mailbox that's configured for the moderated recipient, you'll receive the following error:
Can't remove the arbitration mailbox <mailbox> because it's being used for the approval workflow for existing recipients that have either membership restrictions or moderation enabled. You should either disable the approval features on those recipients or specify a different arbitration mailbox for those recipients before removing this arbitration mailbox.
To remove the arbitration mailbox, you need to do the following steps:
- Identify all moderated recipients who are configured to use the arbitration mailbox.
- Configure a different arbitration mailbox for some, all, or none of the moderated recipients.
- Turn off moderation for some, all, or none of the moderated recipients who are configured to use the arbitration mailbox.
After you complete these steps so that no moderated recipients are configured to use the arbitration mailbox, you can remove the original arbitration mailbox. The rest of this article describes how to do these steps.
What do you need to know before you begin?
Estimated time to complete: 10 minutes
To use Exchange PowerShell, see Open the Exchange Management Shell or Connect to Exchange servers using remote PowerShell.
The ArbitrationMailbox parameter is available to modify the following types of recipients using the corresponding cmdlets:
You need to be assigned permissions before you can perform these procedures. To see what permissions you need, see the "Arbitration" entry in the Feature permissions topic.
For information about keyboard shortcuts that may apply to the procedures in this topic, see Keyboard shortcuts in the Exchange admin center.
Step 1: Use Exchange PowerShell to find all recipients who use the arbitration mailbox
In Exchange PowerShell, use the following syntax:
$AM = Get-Mailbox -Identity "<arbitration mailbox identity>" -Arbitration
$AMDN = $AM.DistinguishedName
Get-Recipient -RecipientPreviewFilter "ArbitrationMailbox -eq '$AMDN'"
This example find all moderated recipients who are configured to use the arbitration mailbox named Arbitration Mailbox01.
$AM = Get-Mailbox "Arbitration Mailbox01" -Arbitration
$AMDN = $AM.DistinguishedName
Get-Recipient -RecipientPreviewFilter "ArbitrationMailbox -eq '$AMDN'"
Note
The arbitration mailbox is specified using the distinguished name (DN). If you know the DN of the arbitration mailbox, you can replace <DN>
with the actual DN value and run this single command: Get-Recipient -RecipientPreviewFilter "ArbitrationMailbox -eq '<DN>'"
.
Step 2: Use Exchange PowerShell to assign a different arbitration mailbox for the moderated recipients
If you choose to specify a different arbitration mailbox for the recipients, use the following syntax in Exchange PowerShell:
Set-<RecipientType> -Identity <Identity> -ArbitrationMailbox <identity of different arbitration mailbox>
This example reconfigures the distribution group named All Employees to use the arbitration mailbox named Arbitration Mailbox02.
Set-DistributionGroup -Identity "All Employees" -ArbitrationMailbox "Arbitration Mailbox02"
Step 3: Use Exchange PowerShell to disable moderation for the moderated recipients who are using the arbitration mailbox
If you choose to disable moderation for the recipients, use the following syntax:
Set-<RecipientType> -Identity <Identity> -ModerationEnabled $false
This example disables moderation for the mailbox named Human Resources.
Set-Mailbox -Identity "Human Resources" -ModerationEnabled $false
How do you know this worked?
The procedure was successful if you can delete the arbitration mailbox without receiving the error that it's being used.