This is an archive version of the document. To get the most up-to-date information, see the current version.

Add-VBRAzureExternalRepository

Short Description

Adds Microsoft Azure Blob storage as an external repository.

Applies to

Platform: VMware, Hyper-V

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

Syntax

Add-VBRAzureExternalRepository -AzureBlobFolder <VBRAzureBlobFolder> -Connection <VBRAzureBlobConnection> [-Name <string>] [-Description <string>] [-DecryptBackups] [-DecryptionKey <VBREncryptionKey>] [-Force] [<CommonParameters>]

Detailed Description

This cmdlet adds Microsoft Azure Blob storage as an external repository to the backup infrastructure.

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

AzureBlobFolder

Specifies the name of the folder in the external repository. Veeam Backup & Replication will import backups from this folder into the backup infrastructure.

Accepts the VBRAzureBlobFolder object. To get this object, run the Get-VBRAzureBlobFolder cmdlet.

True

Named

True (ByValue)

Connection

Specifies an active session with Microsoft Azure Blob storage that you want to add as an external repository.

Accepts the VBRAzureBlobConnection object. To get this object, run the Connect-VBRAzureBlobService cmdlet and set the ExternalRepository property as the ServiceType parameter value.

True

Named

False

Name

Specifies the name of Microsoft Azure Blob storage that you want to add as an external repository.

String

False

Named

False

Description

Specifies the description of Microsoft Azure Blob storage that you want to add as an external repository.

String

False

Named

False

DecryptBackups

Defines that Veeam Backup & Replication will decrypt encrypted backup files created by Cloud Protection Manager.

SwitchParameter

False

Named

False

DecryptionKey

Specifies the password that Veeam Backup & Replication will use to decrypt the backup files.

Accepts the VBREncryptionKey object. To get this object, run the Get-VBREncryptionKey  cmdlet.

False

Named

False

Force

Defines that the cmdlet will add an external repository without showing warnings in the PowerShell console.

SwitchParameter

False

Named

False

<CommonParameters>

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

Output Object

This cmdlet returns the VBRAzureExternalRepository object that contains settings of Microsoft Azure Blob repositories added to the backup infrastructure.

Examples

Adding Microsoft Azure Blob Storage as External Repository

This example shows how to add the Microsoft Azure Blob storage as an external repository to the backup infrastructure.

$account = Get-VBRAzureBlobAccount

$connection = Connect-VBRAzureBlobService -Account $account -RegionType Global -ServiceType ExternalRepository

$container = Get-VBRAzureBlobContainer -Connection $connection -Name "Azure External Repository"

$folder = Get-VBRAzureBlobFolder -Container $container -Connection $connection

Add-VBRAzureExternalRepository -Name "AzureExternalRepo" -Description "New external repository" -AzureBlobFolder $folder -Connection $connection

Perform the following steps:

  1. Get the Azure Blob folder:
  1. Run the Get-VBRAzureBlobAccount cmdlet. Save the result to the $account variable.
  2. Run the Connect-VBRAzureBlobService cmdlet. Set the $account variable as the Account parameter value. Specify the RegionType and ServiceType parameter values. Save the result to the $connection variable.
  3. Run the Get-VBRAzureBlobContainer cmdlet. Set the $connection variable as the Connection parameter value. Specify the Name parameter value. Save the result to the $container variable.
  4. Run the Get-VBRAzureBlobFolder cmdlet. Set the $container variable as the Container parameter value. Set the $connection variable as the Connection parameter value. Save the result to the $folder variable.
  1. Run the Add-VBRAzureExternalRepository cmdlet. Specify the following settings:
  • Specify the Name parameter value.
  • Specify the Description parameter value.
  • Set the $folder variable as the AzureBlobFolder parameter value.
  • Set the $connection variable as the Connection parameter value.

Related Commands