Detaches backups from the job they belong to.
Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License
Detach-VBRBackup -Backup <CBackup> [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]
This cmdlet detaches backups from the job they belong to.
When the cmdlet detaches backups from a job, the job stops processing these backup files. During the next run, the job will start a new backups chain, that is, will create active full backups.
If the detached backups belonged to the job with daily retention, the background retention process retains the backups according to the configured retention and deletes the backups from the repository after the retention period ends. If the retention period is set in restore points, the background retention process does not delete the backups. You need to delete them manually using the Remove-VBRBackup.
Accept Pipeline Input
Specifies an array of backups that you want to detach from a job.
Accepts the CBackup object. To get this object, run the Get-VBRBackup cmdlet.
True (ByPropertyName, ByValue)
Defines that the cmdlet will detach backups without showing warnings in the PowerShell console.
Defines that the cmdlet will write a message that describes the effects of running the cmdlet without actually performing any action.
Defines that the cmdlet will display a prompt that asks if you want to continue running the command.
This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.
Detaching Backups from Job
This example shows how to detach backups from the "Daily backups" job.
$backup = Get-VBRBackup
Detach-VBRBackup -Backup $backup
Perform the following steps:
- Run the Get-VBRBackup cmdlet. Save the result to the $backup variable.
The Get-VBRBackup cmdlet will return an array of backups. Mind the ordinal number of the necessary backup (in our example, it is the first backup in the array).
- Run the Detach-VBRBackup cmdlet. Set the $backup variable as the Job parameter value.