Apply-VBRLocation

Short Description

Assigns geographic locations to the backup infrastructure components.

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

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
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.	`VBRLocation`	True	Named	True (ByPropertyName)
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.	`Object[]`	True	Named	True (ByPropertyName)

<CommonParameters>

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

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:
1. Run the Get-VBRBackupRepository cmdlet. Specify the Name parameter value. Save the result to the $rep variable.
2. 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.