---
title: "Start-VBRCloudTenantBackupEvacuation"
description: "Starts to migrate tenant data between performance extents. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet allows to migrate backed-up tenant data between performance extents of a scale-out backup repositor"
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/start-vbrcloudtenantbackupevacuation.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Veeam Cloud Connect > Veeam Cloud Connect Tenant Accounts > Start-VBRCloudTenantBackupEvacuation"
dateModified: "2026-08-19"
---

# Start-VBRCloudTenantBackupEvacuation

## Short Description
Starts to migrate tenant data between performance extents.

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

## Syntax
```
Start-VBRCloudTenantBackupEvacuation -SourceExtent <VBRRepositoryExtent> -TargetExtent <VBRRepositoryExtent>
 -Tenant <IVBRCloudTenant> [<CommonParameters>]
```

## Detailed Description
This cmdlet allows to migrate backed-up tenant data between performance extents of a scale-out backup repository. The cmdlet will disable the tenant account while performing the migration from the source performance extent to the target performance extent. After the migration is completed, the cmdlet will enable the tenant account.

If performance extents consist of repositories with [Fast Clone](https://helpcenter.veeam.com/docs/vbr/userguide/backup_repository_block_cloning.html?ver=13) enabled, the migration process uses Fast Clone technology. The backed-up data is not hydrated on relocating.

## 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">SourceExtent</span></p>
        </td>
        <td>
          <p>Specifies the source performance extent from which you want to migrate the tenant data.</p><p>Accepts the <a href="vbrrepositoryextent.md"><code>VBRRepositoryExtent</code></a> object. To create this object, run the <a href="get-vbrrepositoryextent.md"><code>Get-VBRRepositoryExtent</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrrepositoryextent.md"><code>VBRRepositoryExtent</code></a></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">TargetExtent</span></p>
        </td>
        <td>
          <p>Specifies the target performance extent to which you want to migrate the tenant data.</p><p>Accepts the <a href="vbrrepositoryextent.md"><code>VBRRepositoryExtent</code></a> object. To create this object, run the <a href="get-vbrrepositoryextent.md"><code>Get-VBRRepositoryExtent</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrrepositoryextent.md"><code>VBRRepositoryExtent</code></a></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">Tenant</span></p>
        </td>
        <td>
          <p>Specifies the tenant which data you want to migrate.</p><p>Accepts the <code>IVBRCloudTenant</code> object. To create this object, run the <a href="get-vbrcloudtenant.md"><code>Get-VBRCloudTenant</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>IVBRCloudTenant</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>
    </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).

## Examples

::: example
### Migrating Tenant Data Between Performance Extents

This example shows how to migrate the `ABC Company` tenant data between performance extents of a scale-out backup repository.

```
$scaleoutrepository = Get-VBRBackupRepository -Name "Veeam Performance Scale-Out Repository" -ScaleOut
$source = Get-VBRRepositoryExtent -Repository $scaleoutrepository
$target = Get-VBRRepositoryExtent -Repository $scaleoutrepository
$tenant = Get-VBRCloudTenant -Name "ABC Company"
Start-VBRCloudTenantBackupEvacuation -SourceExtent $source[0] -TargetExtent $target[1] -Tenant $tenant
```

Perform the following steps:

1. Get the source and target performance extents.

   1. Run the [`Get-VBRBackupRepository`](get-vbrbackuprepository.md) cmdlet. Specify the `Name` parameter value. Provide the `ScaleOut` parameter. Save the result to the `$scaleoutrepository` variable.
   2. Run the [`Get-VBRRepositoryExtent`](get-vbrrepositoryextent.md) cmdlet. Specify the `Repository` parameter value. Save the result to the `$source` variable.
   3. Run the [`Get-VBRRepositoryExtent`](get-vbrrepositoryextent.md) cmdlet. Specify the `Repository` parameter value. Save the result to the `$target` variable.

      The `Get-VBRRepositoryExtent` cmdlet will return an array of extents. Mind the ordinal number of the necessary extent (in our example, it is the first and the second extents in the array).

2. Run the [`Get-VBRCloudTenant`](get-vbrcloudtenant.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$tenant` variable.
3. Run the `Start-VBRCloudTenantBackupEvacuation` cmdlet. Specify the following settings:

   - Set the `$source[0]` variable as the `SourceExtent` parameter value.
   - Set the `$target[1]` variable as the `TargetExtent` parameter value.
   - Set the `$tenant` variable as the `Tenant` parameter value.

:::

## Related Commands

- [`Get-VBRBackupRepository`](get-vbrbackuprepository.md)
- [`Get-VBRRepositoryExtent`](get-vbrrepositoryextent.md)
- [`Get-VBRCloudTenant`](get-vbrcloudtenant.md)