Convert-VBRLegacyCopyBackup

Short Description

Converts legacy backup file of legacy periodic backup copy job to the true per-machine backup file using mapping.

Applies to

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

Syntax

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

Detailed Description

This cmdlet converts legacy backup file of legacy periodic backup copy job to the true per-machine backup file using mapping.

The cmdlet detaches backup file from legacy periodic backup copy job and links it to the new backup copy job. After you run the cmdlet, you will have two backup files: detached legacy backup file and true per-machine backup file linked to the new backup copy job.

Parameters

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

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

Output Object

None