Convert-VBRLegacyCopyBackup - Veeam Backup PowerShell Reference

Convert-VBRLegacyCopyBackup -Backup <CBackup> [-Days <Int32>] [-EnableTimeBasedRetention] [-RunAsync] -TargetJob <VBRBackupCopyJob> [<CommonParameters>]

Parameter	Description	Type	Required	Position	Accept Pipeline Input
Backup	Specifies backup file. The cmdlet will return the backup file you want to link to the new backup copy job.	Accepts the CBackup object. To get this object, run the Get-VBRBackup cmdlet.	True	Named	True (ByValue)
TargetJob	Specifies a backup copy job to which you want to map a backup file.	Accepts the VBRBackupCopyJob object. To create this object, run the Get-VBRBackupCopyJob cmdlet.	True	Named	False
Days	Specifies an amount of days after which detached legacy backup file is deleted from the storage. Note: Days count starts from the backup storage creation date.	Int32	False	Named	False
EnableTimeBasedRetention	Defines that retention policy is applied to the source legacy backup file and its incremental backup files. The amount of retention days is specified in the Days parameter. When determining whether the number of days is exceeded, the cmdlet compares storage creation date, the current date and retention days. Note: If the number of retention days is exceeded for the source legacy backup file but not exceeded for any of the incremental backup files, the source legacy backup file will not be deleted.	SwitchParameter	False	Named	False
RunAsync	Defines that the command returns immediately without waiting for the task to complete.	SwitchParameter	False	Named	False

At this step, get the job name and the target repository.

$LegacyJobName = "LegacyCopyJobName"

$Repo = Get-VBRBackupRepository -Name "TargetRepoName" # provide -ScaleOut parameter if it is a scale-out backup repository

Perform the following steps:

Specify the job name. Save the result to the $LegacyJobName variable.
Run the Get-VBRBackupRepository cmdlet. Specify the Name parameter value. Provide the ScaleOut parameter if your target repository is a scale-out repository. Save the result to the $Repo variable.

At this step, specify the job and the repository settings.

$LegacyJob = Get-VBRJob -Name $LegacyJobName

$LegacyBackup = Get-VBRBackup -Name $LegacyJob.name

$NewJobName = ($LegacyJob.name + "_Upgraded")

Perform the following steps:

Run the Get-VBRJob cmdlet. Set the $LegacyJobName variable as the Name parameter value. Save the result to the $LegacyJob variable.
Run the Get-VBRBackup cmdlet. Set the $LegacyJob.name variable as the Name parameter value. Save the result to the $LegacyBackup variable.
Use the ($LegacyJob.name + "_Upgraded") command to create a name for the job that will contain upgraded backups. Save the result to the $NewJobName variable.

At this step, get legacy backup copy job source objects and disable the job you want to upgrade.

$Sources = Get-VBRLegacyBackupCopySourceJob -Job $LegacyJob

Disable-VBRJob -Job $LegacyJob

Perform the following steps:

Run the Get-VBRLegacyBackupCopySourceJob cmdlet. Set the $LegacyJob variable as the Job parameter value. Save the result to the $Sources variable.
Run the Disable-VBRJob cmdlet. Set the $LegacyJob variable as the Job parameter value.

At this step, get legacy source backups files you want to upgrade to the per-machine backups with separate metadata files. Validate which of them are eligible for the upgrade using the foreach statement and start the upgrade process. Any existing per-machine backups with separate metadata files will be skipped.

$SourceJobName = $Sources.name

$SourceBackups = Get-VBRBackup -Name $SourceJobName

foreach ($SourceBackup in $SourceBackups)

{

if ($SourceBackup.istruepervmcontainer -eq $True)

{

write-host ("Backup "+$SourceJobName+" is already upgraded")

}

else

{

Upgrade-VBRBackup -Backup $SourceBackup -Force

}

Perform the following steps:

Assign the $sources.name variable as the $SourceJobName variable value.
Run the Get-VBRBackup cmdlet. Set the $SourceJobName variable as the Name parameter value. Save the result to the $SourceBackups variable.
Use the foreach statement where the $SourceBackup variable represents legacy source backup files and the $SourceBackups variable represents the collection of these files. Provide the If Else statements from the example.

At this step, add new backup copy job and convert legacy backup files to the per-machine backups with separate metadata files.

$NewBackupCopyJob = Add-VBRBackupCopyJob -Name $NewJobName -Mode Immediate -BackupJob $Sources -TargetRepository $Repo -DirectOperation

Convert-VBRLegacyCopyBackup -Backup $LegacyBackup -TargetJob $NewBackupCopyJob

Perform the following steps:

Run the Add-VBRBackupCopyJob cmdlet. Set the $NewJobName variable as the Name parameter value. Specify the Mode, the BackupJob and the TargetRepository parameter values. Provide the DirectOperation parameter. Save the result to the $NewBackupCopyJob variable.
Run the Convert-VBRLegacyCopyBackup cmdlet. Set the $LegacyBackup variable as the Backup parameter value. Set the $NewBackupCopyJob variable as the TargetJob parameter value.

$LegacyJobName = "LegacyCopyJobName"

$Repo = Get-VBRBackupRepository -Name "LegacyCopyJobTargetRepoName" # provide -ScaleOut parameter if it is a scale-out backup repository

$LegacyJob = Get-VBRJob -Name $LegacyJobName

$LegacyBackup = Get-VBRBackup -Name $LegacyJob.name

$NewJobName = ($LegacyJob.name + "_Upgraded")

$Sources = Get-VBRLegacyBackupCopySourceJob -Job $LegacyJob

Disable-VBRjob -Job $LegacyJob

$SourceJobName = $Sources.name

$SourceBackups = Get-VBRBackup -Name $SourceJobName

foreach ($SourceBackup in $SourceBackups)

{

if ($SourceBackup.istruepervmcontainer -eq $True)

{

write-host ("Backup "+$SourceJobName+" is already upgraded")

}

else

{

Upgrade-VBRBackup -Backup $SourceBackup -Force

}

$NewBackupCopyJob = Add-VBRBackupCopyJob -Name $NewJobName -Mode Immediate -BackupJob $Sources -TargetRepository $Repo -DirectOperation

Convert-VBRLegacyCopyBackup -Backup $LegacyBackup -TargetJob $NewBackupCopyJob