Add-VBRAzureAccount

Short Description

Adds a Microsoft Azure compute account to Veeam Backup & Replication.

Applies to

Platform: VMware, Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License

Syntax

This cmdlet provides parameter sets that allow you to

Add the Microsoft Azure compute account.

Add-VBRAzureAccount -Name <string> [-Region {Global | Germany | China | Government}] [-AzureCredentials <CCredentials>] [-Description <string>] [-TenantId <string>] [-ApplicationId <string>] [-SecretKey <string>] [-CertificatePath <string>] [-Password <string>] [<CommonParameters>]

Add Microsoft Azure Stack Hub account.

Add-VBRAzureAccount -ResourceManagerEndpoint <string> -Name <string> [-AzureCredentials <CCredentials>] [-Description <string>] [-TenantId <string>] [-ApplicationId <string>] [-SecretKey <string>] [-CertificatePath <string>] [-Password <string>] [<CommonParameters>]>]

Detailed Description

This cmdlet adds a credentials record for Microsoft Azure compute account to Veeam Backup & Replication and imports information about subscriptions and resources associated with the Microsoft Azure compute account.

You can add the following types of the accounts:

Microsoft Azure account
Microsoft Azure Stack Hub compute account

The cmdlet will open a Microsoft Azure wizard. Follow the steps of the wizard to add the account.

Important

Mind the following:

This cmdlet does not create a Microsoft Azure compute account. You must set up the Microsoft Azure account beforehand.

This cmdlet does not support Microsoft Azure compute accounts with the Azure Service Manager (ASM, also known as a "classic" type).
Veeam Backup & Replication no longer supports Azure Germany since Microsoft closed Microsoft Cloud Deutschland.

Parameters

Parameter	Description	Required	Position	Accept Pipeline Input	Accept Wildcard Characters
Name	Specifies a name of credentials record for for Microsoft Azure compute account. The cmdlet will add credentials record with this name.	True	Named	False	False
ResourceManagerEndpoint	To connect to Microsoft Azure Stack Hub compute account. Specifies the virtual IP address of Azure Resource Manager. The account will connect to this resource manager. Note: You must specify the IP address in the following format: management.<region>.<FQDN>.	True	Named	False	False
Region	Specifies the region type of the Microsoft Azure account. You can select the following types of regions: Global Government China Note: Although the Germany region is available for the RegionType parameter, it is no longer supported.	False	Named	False	False
Description	Specifies a description of credentials record for for Microsoft Azure compute account. The cmdlet will add credentials record with this description.	False	Named	False	False
AzureCredentials	Note: This parameter is obsolete and will be deprecated in next version. Specifies an exiting Azure AD application. Veeam Backup & Replication will use this Azure AD application to connect to Microsoft Azure.	False	Named	False	False
TenantId	For existing account connection type. Specifies an ID of a tenant (directory) where the AD application resides. The cmdlet will use this tenant ID to connect to the Azure AD application.	False	Named	False	False
ApplicationId	Specifies the ID of the AD application. The cmdlet will use this application to connect to Microsoft Azure.	False	Named	False	False
SecretKey	For the password-based authentication. Specifies the application secret that the cmdlet will use to authenticate against Microsoft Azure.	False	Named	False	False
CertificatePath	For certificate-based authentication. Specifies a path to the folder where the certificate is located. The cmdlet will use it to authenticate against Azure.	False	Named	False	False
Password	For certificate-based authentication. Specifies a password that the cmdlet will use it to authenticate against Azure.	False	Named	False	False

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

Return Type

VBRAzureAccount

Example 1

This command adds the Microsoft Azure compute account into your Veeam Backup & Replication infrastructure with the following settings:

The name of the account is Azure Compute Administrator
The ID of a tenant (directory) where the AD application resides is XXXXXXXX
The ID of the application is 42f83f98
The application secret is XXXXXXXXXXXXXXXXXXX
The region type is Global

Add-VBRAzureAccount -Name "Azure Compute Administrator" -TenantId "XXXXXXXX" -ApplicationId "42f83f98" -SecretKey "XXXXXXXXXXXXXXXXXXX" -Region Global

Example 2

This command adds the Microsoft Azure Stack Hub compute account named Azure Stack Administrator. The account connects to the management.local.veeamstack.external virtual IP address of Azure Resource Manager

Add-VBRAzureAccount -ResourceManagerEndpoint "management.local.azurestack.external" -Name "Azure Stack Administrator"