Change the assignment policy on a mailbox


Applies to: Exchange Server 2016

Topic Last Modified: 2016-04-29

Learn how to change the management role assignment policy assigned to a mailbox.

When you change a mailbox's assignment policy, the change takes effect as soon as the user refreshes the connection, such as the next time they log into their mailbox or open the mailbox options page. For more information about assignment policies in Exchange Server 2016, see Understanding management role assignment policies.

Looking for other management tasks related to permissions? Check out Permissions.

  • Estimated time to complete each procedure: 5 minutes

  • You need to be assigned permissions before you can perform this procedure or procedures. To see what permissions you need, see the "Role groups" entry in the Role management permissions topic.

  • For information about keyboard shortcuts that may apply to the procedures in this topic, see Keyboard shortcuts in the Exchange admin center.

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

  1. In the Exchange admin center (EAC), navigate to Recipients > Mailboxes.

  2. Select the user or resource mailbox you want to change the assignment policy on and then click Edit Edit icon.

  3. Select Mailbox Features.

  4. In the Role assignment policy list, select the assignment policy you want to assign to the mailbox and then click Save.

To change the assignment policy that's assigned to a mailbox, use the following syntax.

Set-Mailbox <mailbox alias or name> -RoleAssignmentPolicy <assignment policy>

This example sets the assignment policy to Unified Messaging Users on the mailbox Brian.

Set-Mailbox Brian -RoleAssignmentPolicy "Unified Messaging Users"

You can't use the EAC to change the assignment policy on a group of mailboxes all at once.

This procedure makes use of pipelining, the Where cmdlet, and the WhatIf parameter. For more information about these concepts, see the following topics:

If you want to change the assignment policy for a group of mailboxes that are assigned a specific policy, use the following syntax.

Get-Mailbox | Where { $_.RoleAssignmentPolicy -Eq "<assignment policy to find>" } | Set-Mailbox -RoleAssignmentPolicy <assignment policy to set>

This example finds all the mailboxes assigned to the Redmond Users - No Voicemail assignment policy and changes the assignment policy to Redmond Users - Voicemail Enabled.

Get-Mailbox | Where { $_.RoleAssignmentPolicy -Eq "Redmond Users - No Voicemail" } | Set-Mailbox -RoleAssignmentPolicy "Redmond Users - Voicemail Enabled"

This example includes the WhatIf parameter so that you can see all the mailboxes that would be changed without committing any changes.

Get-Mailbox | Where { $_.RoleAssignmentPolicy -Eq "Redmond Users - No Voicemail" } | Set-Mailbox -RoleAssignmentPolicy "Redmond Users - Voicemail Enabled" -WhatIf

For detailed syntax and parameter information, see Get-Mailbox or Set-Mailbox.