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: Standard, Enterprise, Enterprise Plus

Syntax

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

Related Commands

Get-VBRRepositoryExtent

Return Type

VBRSession

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 scale-out repository extent from which you want to start evacuation. You can pass multiple extents with different policies and of different scale-out repositories.

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

You can assign multiple extents to this object.

True

Named

True (by Value
FromPipeline, ValueFromPipeline
ByPropertyName)

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 about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.

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.

PS C:\PS> $scaleoutrepository = Get-VBRBackupRepository -Name "Veeam Scale-Out Repository" -ScaleOut

PS C:\PS> Set-VBRScaleOutBackupRepository –Repository $scaleoutrepository –Extent “Backup Repository 1”, “Backup Repository 2”, “Backup Repository 3”