Apply-VBRLocation

Short Description

Assigns geographic locations to the backup infrastructure components.

Applies to

Platform: VMware, Hyper-V

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

Syntax

Apply-VBRLocation -Object <Object[]> -Location <VBRLocation> [<CommonParameters>]

Detailed Description

This cmdlet assigns geographic locations to the backup infrastructure components.

Parameters

Parameter	Description		Required	Position	Accept Pipeline Input
Object	Specifies the array of the infrastructure components. The cmdlet will assign a location to these components.	Accepts the following objects: CBackupRepository (backup repository). Run the Get-VBRBackupRepository cmdlet to get this object. VBRScaleOutBackupRepository (scale-out backup repository). Run the Get-VBRBackupRepository cmdlet to get this object. VBRTapeVault (tape vault). Run the Get-VBRTapeVault cmdlet to get this object. VBRTapeLibrary (tape library). Run the Get-VBRTapeLibrary cmdlet to get this object. VBRCloudProvider (cloud provider). Run the Get-VBRCloudProvider cmdlet to get this object. VBRProtectionGroup (protection group). Run the Get-VBRProtectionGroup cmdlet to get this object. Find-VBRViEntity return types (VMware virtual objects). Find-VBRHvEntity return types (Hyper-V virtual objects). VBRAmazonS3Repository (Amazon S3 object storage). Run the Get-VBRObjectStorageRepository cmdlet to get this object. VBRAmazonS3CompatibleRepository (S3 compatible object storage). Run the Get-VBRObjectStorageRepository cmdlet to get this object. VBRAzureBlobRepository (Azure Blob object storage). Run the Get-VBRObjectStorageRepository cmdlet to get this object. VBRAzureDataBoxRepository (Azure Data Box storage). Run the Get-VBRObjectStorageRepository cmdlet to get this object.	True	Named	True (ByProperty Name)
Location	Specifies the location you want to assign to the infrastructure components.	Accepts the VBRLocation object. To get this object, run the Get-VBRLocation cmdlet.	True	Named	True (ByProperty Name)

Parameter

Description

Required

Position

Accept
Pipeline
Input

Object

Specifies the array of the infrastructure components. The cmdlet will assign a location to these components.

Accepts the following objects:

CBackupRepository (backup repository). Run the Get-VBRBackupRepository cmdlet to get this object.
VBRScaleOutBackupRepository (scale-out backup repository). Run the Get-VBRBackupRepository cmdlet to get this object.
VBRTapeVault (tape vault). Run the Get-VBRTapeVault cmdlet to get this object.
VBRTapeLibrary (tape library). Run the Get-VBRTapeLibrary cmdlet to get this object.
VBRCloudProvider (cloud provider). Run the Get-VBRCloudProvider cmdlet to get this object.
VBRProtectionGroup (protection group). Run the Get-VBRProtectionGroup cmdlet to get this object.
Find-VBRViEntity return types (VMware virtual objects).
Find-VBRHvEntity return types (Hyper-V virtual objects).
VBRAmazonS3Repository (Amazon S3 object storage). Run the Get-VBRObjectStorageRepository cmdlet to get this object.
VBRAmazonS3CompatibleRepository (S3 compatible object storage). Run the Get-VBRObjectStorageRepository cmdlet to get this object.
VBRAzureBlobRepository (Azure Blob object storage). Run the Get-VBRObjectStorageRepository cmdlet to get this object.
VBRAzureDataBoxRepository (Azure Data Box storage). Run the Get-VBRObjectStorageRepository cmdlet to get this object.

True

Named

True (ByProperty
Name)

Location

Specifies the location you want to assign to the infrastructure components.

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

True

Named

True (ByProperty
Name)

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

Output Object

None.

Examples

Assigning Location to Backup Repository and ESXI Host

This example shows how to assign a selected location to a backup repository and an ESXi host.

$rep = Get-VBRBackupRepository -Name "North Repository"

$esxi = Find-VBRViEntity -Name team.support.north

$loc = Get-VBRLocation -Name "ABC North"

Apply-VBRLocation -Objects $esxi, $rep -Location $loc

Perform the following steps:

Get the infrastructure components to which you want to assign a location:

Run the Get-VBRBackupRepository cmdlet. Specify the Name parameter value. Save the result to the $rep variable.
Run the Find-VBRViEntity cmdlet. Specify the Name parameter value. Save the result to the $esxi variable.

Run the Get-VBRLocation cmdlet. Specify the Name parameter value. Save the result to the $loc variable.
Run the Apply-VBRLocation cmdlet. Set the $esxi and the $rep variables as the Objects parameter values. Set the $loc variable as the Location parameter value.

Related Commands