How to set impersonation rights manually
How to manually manage impersonation rights for the administrator account.
Add impersonation rights to your admin account via:
- Windows PowerShell - click this link,
- EAC (Exchange Admin Center) - click here for details (applies to Exchange 2013, 2016 and Office 365 only).
- Run Windows PowerShell.
Check the PowerShell version by typing the following cmdlet:
- An empty response means you are using version 1.0.
- For versions 2.0 and newer you should see a detailed answer.
- We recommend to keep PowerShell updated to avoid compatibility problems. To download the newest version of PowerShell please visit this Microsoft website.
- If Exchange Server is in a remote location (for example hosted) or you are connecting to Office 365, learn how to connect to remote Exchange via PowerShell. To manage permissions locally (MS Exchange Server on-premises or when logged on to remote Exchange via Remote Desktop, etc.) execute the commands below in Exchange Management Shell.
Check if the account in question already has impersonation rights assigned:
Get-ManagementRoleAssignment -RoleAssignee "<account name>" -Role ApplicationImpersonation -RoleAssigneeType user
- where <account name> is the name of the administrator account on the target server you want to check.
Add impersonation rights:
New-ManagementRoleAssignment –Name:<impersonation Assignment Name> –Role:ApplicationImpersonation –User: "<account name>"
- where <impersonation Assignment Name> is the name of your choice for this assignment. Be aware that each assignment should have a unique name. You can omit the Name switch and a unique assignment name will be created automatically.
If necessary, you can also restrict these impersonation rights so that they apply to a specific group of users. To do so, you first need to define a management scope that will include your AD group:
$ADGroup = Get-DistributionGroup -Identity "<group name>" New-ManagementScope "<scope name>" -RecipientRestrictionFilter "MemberOfGroup -eq '$($ADGroup.DistinguishedName)'"
- where <group name> is the name of your AD group object, and <scope name> is the name of your choice for the new management scope.
Now, modify the existing assignment by using the following cmdlet:
Set-ManagementRoleAssignment "<impersonation Assignment Name>" -CustomRecipientWriteScope "<scope name>"
You can remove impersonation rights with this command, if necessary:
Get-ManagementRoleAssignment -RoleAssignee "<account name>" -Role ApplicationImpersonation -RoleAssigneeType user | Remove-ManagementRoleAssignment
Log on to Office 365 using the admin account or log on to Exchange Admin Center (https://localhost/ecp). In Office 365, access the Exchange tab:
Next, go to Permissions, then admin roles and choose Discovery Management by double-clicking it:
- Add the Role ApplicationImpersonation and add your admin user as the group member:
Please note that according to Microsoft, Office 365 Small Business plans cannot assign impersonation rights manually. The default built-in admin account is the only one who can hold such a permission.
- MS Technet on New-ManagementRoleAssignment cmdlet, in Exchange Server 2010
- MS Technet on New-ManagementRoleAssignment cmdlet, in Exchange Server 2013
- MS Technet on New-ManagementRoleAssignment cmdlet, in Exchange Server 2016 and Exchange Online
- Allow PowerShell connections to Exchange Server over IP address
- Applies to: CodeTwo Backup for Exchange CodeTwo Backup for Office 365 CodeTwo Email Signatures for Email Clients CodeTwo Exchange Migration CodeTwo Office 365 Migration
- Categories: How-To
- Last modified: 2017-11-13
- Created: 2013-08-26
- ID: 285
- Keywords: impersonation, rights, permissions, exchange, migration