Start-VBRCloudTenantBackupEvacuation

Short Description

Starts to migrate tenant data between performance extents.

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

Syntax

Start-VBRCloudTenantBackupEvacuation -SourceExtent <VBRRepositoryExtent> -TargetExtent <VBRRepositoryExtent>

-Tenant <IVBRCloudTenant> [<CommonParameters>]

Detailed Description

This cmdlet allows to migrate backed-up tenant data between performance extents of a scale-out backup repository. The cmdlet will disable the tenant account while performing the migration from the source performance extent to the target performance extent. After the migration is completed, the cmdlet will enable the tenant account.

If performance extents consist of repositories with Fast Clone enabled, the migration process uses Fast Clone technology. The backed-up data is not hydrated on relocating.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
SourceExtent	Specifies the source performance extent from which you want to migrate the tenant data. Accepts the `VBRRepositoryExtent` object. To create this object, run the `Get-VBRRepositoryExtent` cmdlet.	`VBRRepositoryExtent`	True	Named	True (ByPropertyName, ByValue)
TargetExtent	Specifies the target performance extent to which you want to migrate the tenant data. Accepts the `VBRRepositoryExtent` object. To create this object, run the `Get-VBRRepositoryExtent` cmdlet.	`VBRRepositoryExtent`	True	Named	True (ByPropertyName, ByValue)
Tenant	Specifies the tenant which data you want to migrate. Accepts the `IVBRCloudTenant` object. To create this object, run the `Get-VBRCloudTenant` cmdlet.	`IVBRCloudTenant`	True	Named	True (ByPropertyName, ByValue)

<CommonParameters>

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

Examples

Migrating Tenant Data Between Performance Extents

This example shows how to migrate the ABC Company tenant data between performance extents of a scale-out backup repository.

$scaleoutrepository = Get-VBRBackupRepository -Name "Veeam Performance Scale-Out Repository" -ScaleOut

$source = Get-VBRRepositoryExtent -Repository $scaleoutrepository

$target = Get-VBRRepositoryExtent -Repository $scaleoutrepository

$tenant = Get-VBRCloudTenant -Name "ABC Company"

Start-VBRCloudTenantBackupEvacuation -SourceExtent $source[0] -TargetExtent $target[1] -Tenant $tenant

Perform the following steps:

Get the source and target performance extents.
1. Run the Get-VBRBackupRepository cmdlet. Specify the Name parameter value. Provide the ScaleOut parameter. Save the result to the $scaleoutrepository variable.
2. Run the Get-VBRRepositoryExtent cmdlet. Specify the Repository parameter value. Save the result to the $source variable.
3. Run the Get-VBRRepositoryExtent cmdlet. Specify the Repository parameter value. Save the result to the $target variable.
  The Get-VBRRepositoryExtent cmdlet will return an array of extents. Mind the ordinal number of the necessary extent (in our example, it is the first and the second extents in the array).
Run the Get-VBRCloudTenant cmdlet. Specify the Name parameter value. Save the result to the $tenant variable.
Run the Start-VBRCloudTenantBackupEvacuation cmdlet. Specify the following settings:
- Set the $source[0] variable as the SourceExtent parameter value.
- Set the $target[1] variable as the TargetExtent parameter value.
- Set the $tenant variable as the Tenant parameter value.