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:

Repository

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

Upgrade-VBRBackup [-Backup <CBackup[]>] [-RunAsync] [-Force] [<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

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
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.	`CBackup[]`	False	Named	True (ByValue)
BackupRepository	Specifies the repository whose backups you want to upgrade. Accepts the `CBackupRepository` object. To get this object, run the `Get-VBRBackupRepository` cmdlet.	`CBackupRepository`	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 -Name "Backup Repository 1"

Upgrade-VBRBackup -BackupRepository $repository

Perform the following steps:

Run the Get-VBRBackupRepository cmdlet. Specify the Name parameter value. Save the result to the $repository variable.
Run the Upgrade-VBRBackup cmdlet. Set the $repository variable as the BackupRepository parameter value.

Get-VBRBackupRepository