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 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>]
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.
Accept Pipeline Input
Specifies the repository whose backups you want to upgrade.
Accepts the CBackupRepository object. To get this object, run the Get-VBRBackupRepository cmdlet.
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.
Defines that the cmdlet will upgrade backups without showing warnings in the PowerShell console.
Defines that the command returns immediately without waiting for the task to complete.
This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.
The cmdlet returns the CBaseSession object that defines settings of the upgrade session.
Detaching Backups from Job
This example shows how to upgrade backups located in specific repository.
$repository = Get-VBRBackupRepository
Upgrade-VBRBackup -BackupRepository $repository
Perform the following steps:
- Run the Get-VBRBackupRepository cmdlet. Save the result to the $repository variable.
- Run the Upgrade-VBRBackup cmdlet. Set the $repository variable as the BackupRepository parameter value.