1-800-691-1991 | 9am - 8pm ET

Granular permissions for Microsoft Azure user

KB ID: 2702
Product: Veeam Backup & Replication
Version: 9.5.0.x
Published: 2018-08-09
Last Modified: 2020-08-13


Microsoft Azure has a number of built-in roles with predefined permissions. If you prefer to set up a custom role for Veeam Integration, you can use Azure PowerShell method to create one.


Setting up a custom role for Veeam Backup & Replication consists of two steps:

NOTE: Please be informed of a possible vulnerability before proceeding futher.

1. Creating a custom role on Microsoft Azure

You can specify the minimum permissions set using the following script:  
$role = [Microsoft.Azure.Commands.Resources.Models.Authorization.PSRoleDefinition]::new()
$role.Name = 'Veeam Restore Operator'
$role.Description = 'Permissions for Veeam Direct Restore to Microsoft Azure'
$role.IsCustom = $true
$permissions = @(
$role.Actions = $permissions
$role.NotActions = (Get-AzureRmRoleDefinition -Name 'Virtual Machine Contributor').NotActions
$subs = '/subscriptions/00000000-0000-0000-0000-000000000000'
$role.AssignableScopes = $subs
New-AzureRmRoleDefinition -Role $role

2. Add a user with the newly created custom role to Veeam Backup and Replication

Once the role and user have been created, they need to be added to Veeam Backup and Replication using the following method. This role cannot be added through the User Interface. 
a. Start Windows command line (CMD.exe or PowerShell.exe) with Administrative privileges
b. Navigate to Veeam Backup installation folder (by default: C:\Program Files\Veeam\Backup and Replication\) and then to “Backup” subfolder, so the full path should look like: "C:\Program Files\Veeam\Backup and Replication\Backup":
cd C:\Program Files\Veeam\Backup and Replication\Backup
c. Type following command: Veeam.backup.manager.exe REGISTERAZUREACCOUNT. The account is now ready for use.

More information

For Veeam 9.5 Update 4 and later, please refer to the following document:
KB ID: 2702
Product: Veeam Backup & Replication
Version: 9.5.0.x
Published: 2018-08-09
Last Modified: 2020-08-13

Couldn't find what you were looking for?

Below you can submit an idea for a new knowledge base article.
Report a typo on this page:

Please select a spelling error or a typo on this page with your mouse and press CTRL + Enter to report this mistake to us. Thank you!

Spelling error in text

Knowledge base content request
By submitting, you agree that your personal data will be managed by Veeam in accordance with the Privacy Policy.

ty icon

Thank you!

We have received your request and our team will reach out to you shortly.


error icon

Oops! Something went wrong.

Please go back try again later.