---
title: "Move-VBRBackup"
description: "Moves all backups of a job to another repository or specific workloads and their backups to another job. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet provides the following parameter sets: This cmdlet mo"
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/move-vbrbackup.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Backup > Managing Backups > Move-VBRBackup"
dateModified: "2026-08-19"
---

# Move-VBRBackup

## Short Description
Moves all backups of a job to another repository or specific workloads and their backups to another job.

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

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>Backup (Default)</code></p>

```
Move-VBRBackup -Backup <CBackup> -Repository <CBackupRepository> [-RunAsync] [-Force]
 [-WhatIf] [-Confirm] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>TruePerVm</code></p>

```
Move-VBRBackup -Backup <CBackup> -Name <String[]> -Job <CBackupJob> [-RunAsync] [-Force]
 [-WhatIf] [-Confirm] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet moves backups to another repository or to another job. For more information on the move operation and its considerations, see the [Moving Backups](https://helpcenter.veeam.com/docs/vbr/userguide/backup_moving.html?ver=13) section in the Veeam Backup & Replication User Guide.

When you move backups to another repository, the cmdlet reconfigures the job to target to the new location. When you move workload and their backups to another job, backups are moved to the repository which the specified job is targeted to.

## 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">Backup</span></p>
        </td>
        <td>
          <p>Specifies backups that will be moved.</p><p>Accepts the <code>CBackup</code> object. To get this object, run the <a href="get-vbrbackup.md"><code>Get-VBRBackup</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CBackup</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">Force</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will move backups without showing warnings in the PowerShell console.</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Job</span></p>
        </td>
        <td>
          <p>Specifies the job to which you want to move workloads and their backups.</p><p><strong>Note</strong>: This parameter applies only if backups are true per-machine (with metadata for each workload). This parameter is required if the <code>Name</code> parameter is set.</p><p>Accepts the <code>CBackupJob</code> object. To create this object, run the <a href="get-vbrjob.md"><code>Get-VBRJob</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CBackupJob</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">Name</span></p>
        </td>
        <td>
          <p>Specifies an array of names of the workloads that you want to move.</p><p><strong>Note</strong>: This parameter applies only if backups are true per-machine (with metadata for each workload). This parameter is required if the <code>Job</code> parameter is set.</p>
        </td>
        <td style="width:10%;">
          <p><code>String[]</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">Repository</span></p>
        </td>
        <td>
          <p>Specifies the repository to which backups will be moved.</p><p>Accepts the <code>CBackupRepository</code> object. To get this object, run the <a href="get-vbrbackuprepository.md"><code>Get-VBRBackupRepository</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CBackupRepository</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Confirm</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will display a prompt that asks if you want to continue running the command.</p><p><strong>Note</strong>: Microsoft PowerShell enables the <code>Confirm</code> parameter for this cmdlet by default. To disable this option, set the parameter value to <code>$false</code>. That is, <code>Confirm:$false</code>.</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">WhatIf</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will write a message that describes the effects of running the cmdlet without actually performing any action.</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
The cmdlet returns the [`VBRMoveBackupSession`](vbrmovebackupsession.md) object that contains settings of the move session.

## Examples

::: example
### Moving Backups

This example shows how to move all backups to another repository.

```
$backup = Get-VBRBackup
$repository = Get-VBRBackupRepository
Move-VBRBackup -Backup $backup -Repository $repository
```

Perform the following steps:

1. Run the [`Get-VBRBackup`](get-vbrbackup.md) cmdlet. Save the result to the `$backup` variable.
2. Run the [`Get-VBRBackupRepository`](get-vbrbackuprepository.md) cmdlet. Save the result to the `$repository` variable.
3. Run the `Move-VBRBackup` cmdlet. Set the `$backup` variable as the `Backup` parameter value. Set the `$repository` variable as the `Repository` parameter value.

:::

## Related Commands

- [`Get-VBRBackup`](get-vbrbackup.md)
- [`Get-VBRBackupRepository`](get-vbrbackuprepository.md)