---
title: "Upgrade-VBRBackup"
description: "Upgrades the backup chain format of backups from per-machine (split machine) to true per-machine. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet provides the following parameter sets: This cmdlet upgrades "
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/upgrade-vbrbackup.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Backup > Managing Backups > Upgrade-VBRBackup"
dateModified: "2026-08-19"
---

# Upgrade-VBRBackup

## Short Description
Upgrades the backup chain format of backups from per-machine (split machine) to true per-machine.

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

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>Repository</code></p>

```
Upgrade-VBRBackup [-BackupRepository <CBackupRepository>] [-RunAsync] [-Force] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Backup</code></p>

```
Upgrade-VBRBackup [-Backup <CBackup[]>] [-RunAsync] [-Force] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet upgrades the backup chain format of backups from per-machine (split machine) to true per-machine. Note that the cmdlet does not upgrade single storage backups.

If you want to change the backup chain format for other backups, you need to use the [`Detach-VBRBackup`](detach-vbrbackup.md) cmdlet to detach backups from the job. Ensure that the job is targeted to the repository that creates backups of the required backup chain format. Then launch the job. For more information on backup chain formats and how to change them, see the [Changing Backup Chain Formats](https://helpcenter.veeam.com/docs/vbr/userguide/backup_change_type.html?ver=13) section in Veeam Backup & Replication User Guide.

## 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 an array of backups that you want to upgrade.</p><p><strong>Note</strong>: Backups must be stored on one repository.</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>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">BackupRepository</span></p>
        </td>
        <td>
          <p>Specifies the repository whose backups you want to upgrade.</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>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (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 upgrade 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">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
The cmdlet returns the `CBaseSession` object that defines settings of the upgrade session.

## Examples

::: example
### Upgrading Backups in Specific Repository

This example shows how to upgrade backups located in specific repository.

```
$repository = Get-VBRBackupRepository -Name "Backup Repository 1"
Upgrade-VBRBackup -BackupRepository $repository
```

Perform the following steps:

1. Run the [`Get-VBRBackupRepository`](get-vbrbackuprepository.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$repository` variable.
2. Run the `Upgrade-VBRBackup` cmdlet. Set the `$repository` variable as the `BackupRepository` parameter value.

:::

## Related Commands

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