---
title: "Start-VBRRepositoryExtentBackupEvacuation"
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."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/start-vbrrepositoryextentbackupevacuation.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Backup Infrastructure > Scale-Out Backup Repositories > Performance Tier > Start-VBRRepositoryExtentBackupEvacuation"
dateModified: "2026-08-19"
---

# Start-VBRRepositoryExtentBackupEvacuation

## Short Description
Evacuates backups from a scale-out backup repository extent.

**Platform**: VMware, Hyper-V

**Product Edition**: Enterprise, Enterprise Plus, Veeam Universal License

## Syntax
```
Start-VBRRepositoryExtentBackupEvacuation -Extent <IVBRExtent[]> [-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

<table style="width:100%;" class="Blue_Table">
      <tr style="vertical-align:top">
        <th style="width:20%;">
          <p>Parameter</p>
        </th>
        <th style="width:20%;">
          <p>Description</p>
        </th>
        <th style="width:20%;">
          <p>Type</p>
        </th>
        <th style="width:10%;">
          <p>Required</p>
        </th>
        <th style="width:10%;">
          <p>Position</p>
        </th>
        <th style="width:10%;">
          <p>Accept Pipeline Input</p>
        </th>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Extent</span></p>
        </td>
        <td>
          <p>Specifies the array of scale-out repository extents. The cmdlets will evacuate backups from these extents.</p><p>Accepts extents with different policies and of different scale-out repositories.</p><p>Accepts the following object:</p><ul><li>ID</li><li>String (name of the backup repository that is used as extent)</li><li><a href="vbrrepositoryextent.md"><code>VBRRepositoryExtent</code></a></li></ul><p>To get this object, run the <a href="get-vbrrepositoryextent.md"><code>Get-VBRRepositoryExtent</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>IVBRExtent[]</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName, ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">RunAsync</span></p>
        </td>
        <td>
          <p>Defines that the command returns immediately without waiting for the task to complete.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
    </table>

`<CommonParameters>`

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see [ Microsoft Docs](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-7).

## Output Object
[`VBRSession`](vbrsession.md)

## Examples

::: example
### Evacuating Backups from Extents

This command evacuates backups from the `Backup Repository 1`, `Backup Repository 2`, `Backup Repository 3` extents.

```
Start-VBRRepositoryExtentBackupEvacuation -Extent "Backup Repository 1", "Backup Repository 2", "Backup Repository 3"
```

:::

## Related Commands

[`Get-VBRRepositoryExtent`](get-vbrrepositoryextent.md)