Start-VBRRepositoryExtentBackupEvacuation

In this article

    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