This is an archive version of the document. To get the most up-to-date information, see the current version.

Start-VBRRepositoryExtentBackupEvacuation

Short Description

Evacuates backups from a scale-out backup repository extent.

Applies to

Platform: VMware, Hyper-V

Product Edition: Enterprise, Enterprise Plus, Veeam Universal License

Syntax

Start-VBRRepositoryExtentBackupEvacuation -Extent <VBRRepositoryExtent[]> [-RunAsync]  [<CommonParameters>]

Detailed Description

This cmdlet evacuates backups from a scale-out backup repository extent. When you evacuate backups, Veeam moves them to other extents according to the configured policy.

Parameters

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

Extent

Specifies the array of scale-out repository extents. The cmdlets will evacuate backups from these extents.

Accepts extents with different policies and of different scale-out repositories.

Accepts VBRRepositoryExtent, ID or string (name of the backup repository that is used as extent) types.

True

Named

True (ByValue,
ByProperty
Name)

True (for string)

RunAsync

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

False

Named

False

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

Return Type

VBRSession

Example

This command evacuates backups from an extent.

  1. Run Get-VBRBackupRepository to get the repository. Use the ScaleOut parameter. Save it to the $scaleoutrepository variable.
  2. Run Set-VBRScaleOutBackupRepository with this variable. List the existing extents and the new repository.

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

Set-VBRScaleOutBackupRepository –Repository $scaleoutrepository –Extent “Backup Repository 1”, “Backup Repository 2”, “Backup Repository 3”

Related Commands

Get-VBRRepositoryExtent