Start-VBRCapacityTierSync - Veeam Backup PowerShell Reference

Start-VBRCapacityTierSync -Repository <VBRScaleOutBackupRepository> [-ApproximateOffloadSizeGB <Int64>] [-RunAsync] [<CommonParameters>]

Parameter	Description	Type	Required	Position	Accept Pipeline Input
Repository	Specifies a scale-out backup repository. The cmdlet will return the performance extents added to this repository.	Accepts the VBRScaleOutBackupRepository object. to get this object, run the Get-VBRBackupRepository cmdlet.	True	Named	True (ByValue, ByProperty Name)
ApproximateOffloadSizeGB	Specifies an approximate size of data that you want to offload to the capacity tier. Note: If you provide this parameter, the cmdlet will move backups to capacity tier and delete them from performance tier.	Int64	False	Named	True (ByPropertyName)
RunAsync	Defines that the command returns immediately without waiting for the task to complete.	SwitchParameter	False	Named	False

Parameter

Description

Type

Required

Position

Accept
Pipeline
Input

Repository

Specifies a scale-out backup repository. The cmdlet will return the performance extents added to this repository.

Accepts the VBRScaleOutBackupRepository object. to get this object, run the Get-VBRBackupRepository cmdlet.

True

Named

True (ByValue,
ByProperty
Name)

ApproximateOffloadSizeGB

Specifies an approximate size of data that you want to offload to the capacity tier.

Note: If you provide this parameter, the cmdlet will move backups to capacity tier and delete them from performance tier.

Int64

False

Named

True (ByPropertyName)

RunAsync

Defines that the command returns immediately without waiting for the task to complete.

SwitchParameter

False

Named

False

This example shows how to start offload data from the performance tier to the capacity tier. We recommend using this script if you have several scale-out repositories and would like to synchronize data on a specific repository.

$repository = Get-VBRBackupRepository -ScaleOut

Start-VBRCapacityTierSync -Repository $repository[1]

Perform the following steps:

Run the Get-VBRBackupRepository cmdlet. Specify the ScaleOut parameter. Save the result to the $repository variable.

The Get-VBRBackupRepository cmdlet will return an array of scale-out repositories. Mind the ordinal number of the necessary repository (in our example, it is the second scale-out repository in the array).

Run the Start-VBRCapacityTierSync cmdlet. Set the $repository variable as the Repository parameter value.

This example shows how to sync data stored on the performance tier with the data on capacity tier. We recommend using this script if you do not want to specify an ordinal number of a scale-out repository.

Get-VBRBackupRepository -ScaleOut | ForEach-Object {Start-VBRCapacityTierSync -Repository $_ -RunAsync}

Perform the following steps:

Run the Get-VBRBackupRepository cmdlet. Specify the ScaleOut parameter.
Pipe the cmdlet output to the ForEach-Object cmdlet:

Run the Start-VBRCapacityTierSync cmdlet.
Set the $_ value for the Repository parameter. Provide the RunAsync parameter.