Start-VBRCloudTenantBackupEvacuation
Short Description
Starts to migrate tenant data between performance extents.
Applies to
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
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. | True | Named | True (ByValue, ByPropertyName) |
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. | True | Named | True (ByValue, ByPropertyName) |
Tenant | Specifies the tenant which data you want to migrate. | Accepts the IVBRCloudTenant object. To create this object, run the Get-VBRCloudTenant cmdlet. | True | Named | True (ByValue, ByPropertyName) |
<CommonParameters>
This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.
Output Object
None.
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.
- Run the Get-VBRBackupRepository cmdlet. Specify the Name parameter value. Provide the ScaleOut parameter. Save the result to the $scaleoutrepository variable.
- Run the Get-VBRRepositoryExtent cmdlet. Specify the Repository parameter value. Save the result to the $source variable.
- 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.
Related Commands