Share via


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:

  1. Identify all moderated recipients who are configured to use the arbitration mailbox.
  2. Configure a different arbitration mailbox for some, all, or none of the moderated recipients.
  3. 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?

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.