Upgrade-VBRBackup

Short Description

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

Applies to

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

Syntax

This cmdlet provides parameter sets that allow you to:

  • Upgrade all per-machine (split machine) backups stored on a repository to the true per-machine format.

Upgrade-VBRBackup [-BackupRepository <CBackupRepository>] [-Force] [-RunAsync]  [<CommonParameters>]

  • Upgrade per-machine (split machine) backups of a backup job to the true per-machine format.

Upgrade-VBRBackup [-Backup <CBackup[]>] [-Force] [-RunAsync]  [<CommonParameters>]

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 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 section in Veeam Backup & Replication User Guide.

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

BackupRepository

Specifies the repository whose backups you want to upgrade.

Accepts the CBackupRepository object. To get this object, run the Get-VBRBackupRepository cmdlet.

False

Named

True (ByValue)

Backup

Specifies an array of backups that you want to upgrade.

Note: Backups must be stored on one repository.

Accepts the CBackup[] object. To get this object, run the Get-VBRBackup cmdlet.

False

Named

True (ByValue)

Force

Defines that the cmdlet will upgrade backups without showing warnings in the PowerShell console.

SwitchParameter

False

Named

False

RunAsync

Defines that the command returns immediately without waiting for the task to complete.

SwitchParameter

False

Named

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Output Object

The cmdlet returns the CBaseSession object that defines settings of the upgrade session.

Examples

Upgrading Backups in Specific Repository

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

$repository = Get-VBRBackupRepository

Upgrade-VBRBackup -BackupRepository $repository

Perform the following steps:

  1. Run the Get-VBRBackupRepository cmdlet. 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