Add-VBREntraIDTenant

Short Description

Adds a Microsoft Entra ID tenant to the backup infrastructure.

Applies to

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

Syntax

This cmdlet provides cmdlet sets that allow you to:

Add a tenant with the help of an existing application using password-based authentication.

Add-VBREntraIDTenant [-Region <VBRAzureBlobRegionType>] [-Description <String>] -TenantId <String> -ApplicationId <String> -SecretKey <SecureString> -CacheRepository <CBackupRepository> [<CommonParameters>]

Add a tenant with the help of an existing application using certificate-based authentication.

Add-VBREntraIDTenant [-Region <VBRAzureBlobRegionType>] [-Description <String>] -TenantId <String> -ApplicationId <String> -CertificatePath <String> [-Password <SecureString>] -CacheRepository <CBackupRepository> [<CommonParameters>]

Detailed Description

This cmdlet adds a tenant to the backup infrastructure.

Note

To add a tenant, you need an application already created in Entra ID. If you want to create an application automatically, add the tenant using the UI.

Parameters

Parameter	Description	Type	Required	Position	Accept Pipeline Input
TenantId	Specifies the ID of the tenant which you want to add to the backup infrastructure. The cmdlet will search the application within this tenant.	String	True	Named	False
ApplicationId	Specifies the ID of an application. The cmdlet will use this application to access Entra ID resources.	String	True	Named	False
SecretKey	For the password-based authentication. Specifies an application secret. The cmdlet will use this secret to authenticate to Entra ID.	SecureString	True	Named	False
CacheRepository	Specifies a cache repository. The cmdlet will use this repository to store temporary cache files for log processing.	Accepts the CBackupRepository object. To get this object, run the Get-VBRBackupRepository cmdlet.	True	Named	False
CertificatePath	For the certificate-based authentication. Specifies the path to the certificate. The cmdlet will use this certificate to authenticate to Entra ID.	String	True	Named	False
Region	Specifies the region type where the tenant is located.	VBRAzureBlobRegionType	False	Named	False
Description	Specifies the description for the tenant that you want to add.	String	False	Named	False
Password	For the certificate-based authentication. Specifies the password that the cmdlet will use to authenticate to Entra ID.	SecureString	False	Named	False

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Output Object

The cmdlet returns the VBREntraIdTenant object that contains settings of the added tenant.

Examples

Add-VBREntraIDTenant Example 1. Adding Tenant Using Password-Based Authentication

This example shows how to add an Entra ID tenant using the password-based authentication.

$tenantId = "xxxxx"

$appId = "xxxxx"

$appSecret = Read-Host -Prompt "Enter password" -AsSecureString

$repo = Get-VBRBackupRepository -Name "Default Backup Repository"

$tenant = Add-VBREntraIdTenant -TenantId $tenantId -ApplicationId $appId -SecretKey $appSecret -CacheRepository $repo

Perform the following steps:

Create the $tenantId and $appId variables whose values are the Entra ID tenant ID and the application ID.
Create the $appSecret variable. Use the Read-Host cmdlet to get the application secret and convert it to a secure string.
Run the Get-VBRBackupRepository cmdlet. Specify the Name parameter value. Save the result to the $repo variable.
Run the Add-VBREntraIdTenant cmdlet. Specify the following settings:

Set the $tenantId variable as the TenantId parameter value.
Set the $appId variable as the ApplicationId parameter value.
Set the $appSecret variable as the SecretKey parameter value.
Set the $repo variable as the CacheRepository parameter value.

Related Commands

Get-VBRBackupRepository