Remove-VBRUnstructuredBackup

Short Description

Removes backup files created by the file backup jobs and object storage backup jobs.

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

Syntax

This cmdlet provides the following parameter sets:

FromDb (Default)

Remove-VBRUnstructuredBackup -Backup <VBRUnstructuredBackup[]> [-WhatIf]

[-Confirm] [<CommonParameters>]
NASServer

Remove-VBRUnstructuredBackup -Backup <VBRUnstructuredBackup[]> -Server <VBRUnstructuredServer[]> [-RunAsync]

[-WhatIf] [-Confirm] [<CommonParameters>]
FromDisk

Remove-VBRUnstructuredBackup -Backup <VBRUnstructuredBackup[]> [-FromDisk] [-RunAsync]

[-WhatIf] [-Confirm] [<CommonParameters>]
RestorePoint

Remove-VBRUnstructuredBackup -RestorePoint <VBRUnstructuredBackupRestorePoint[]> [-RunAsync]

[-WhatIf] [-Confirm] [<CommonParameters>]

Detailed Description

This cmdlet removes backup files created by the file backup jobs and object storage backup jobs.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
Backup	Specifies an array of backup files created by the file backup jobs and object storage backup jobs. The cmdlet will remove these backup files. Accepts the `VBRUnstructuredBackup[]` object. To get this object, run the `Get-VBRUnstructuredBackup` cmdlet.	`VBRUnstructuredBackup[]`	True	Named	True (ByPropertyName, ByValue)
FromDisk	Defines that the cmdlet will remove backup files from disk.	`SwitchParameter`	True	Named	False
RestorePoint	Specifies an array of restore points. The cmdlet will remove backups that have restore points specified in the array. Note: If the `Backup` parameter is also specified, the cmdlet will remove backup files for specified file shares. Accepts the `VBRUnstructuredBackupRestorePoint[]` object. To get this object, run the `Get-VBRUnstructuredBackupRestorePoint` cmdlet.	`VBRUnstructuredBackupRestorePoint[]`	True	Named	True (ByPropertyName, ByValue)
RunAsync	Defines that the command returns immediately without waiting for the task to complete.	`SwitchParameter`	False	Named	False
Server	Specifies an array of file shares and object storage. The cmdlet will remove backup files of the specified file shares from the disk. Accepts the `VBRUnstructuredServer[]` object. To get this object, run the `Get-VBRUnstructuredServer` cmdlet.	`VBRUnstructuredServer[]`	True	Named	False
Confirm	Defines that the cmdlet will display a prompt that asks if the user is sure that he wants to continue. Note: Microsoft PowerShell enables the `Confirm` parameter for this cmdlet by default. To disable this option, set the parameter value to `$false`. That is, `Confirm:$false`.	`SwitchParameter`	False	Named	False
WhatIf	Defines that the cmdlet will write a message that describes the effects of running the cmdlet without actually performing any action.	`SwitchParameter`	False	Named	False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Examples

Remove-VBRUnstructuredBackup Example 1. Removing Backup Files from Veeam Backup & Replication Infrastructure

This example shows how to remove the Reports backup backup files from the Veeam Backup & Replication infrastructure.

$backupfile = Get-VBRUnstructuredBackup -Name "Reports backup"

Remove-VBRUnstructuredBackup -Backup $backupfile

Perform the following steps:

Run the Get-VBRUnstructuredBackup cmdlet. Specify the Name parameter value. Save the result to the $backupfile variable.
Run the Remove-VBRUnstructuredBackup cmdlet. Set the $backupfile variable as the Backup parameter value.

Remove-VBRUnstructuredBackup Example 2. Removing Backup Files of Specific Object Storage from Disk

This example shows how to remove the Reports backup of the MinioSrv object storage from a disk.

$backupfile = Get-VBRUnstructuredBackup -Name "Reports"

$server = Get-VBRUnstructuredServer -Name "MinioSrv"

Remove-VBRUnstructuredBackup -Backup $backupfile -Server $server

Perform the following steps:

Run the Get-VBRUnstructuredBackup cmdlet. Specify the Name parameter value. Save the result to the $backupfile variable.
Run the Get-VBRUnstructuredServer cmdlet. Specify the Name parameter value. Save the result to the $server variable.
Run the Remove-VBRUnstructuredBackup cmdlet. Set the $backupfile variable as the Backup parameter value. Set the $server variable as the Server parameter value.

Remove-VBRUnstructuredBackup Example 3. Removing Backup Files From Disk

This example shows how to remove the Reports backup file from a disk.

$backupfile = Get-VBRUnstructuredBackup -Name "Reports"

Remove-VBRUnstructuredBackup -Backup $backupfile

Perform the following steps:

Run the Get-VBRUnstructuredBackup cmdlet. Specify the Name parameter value. Save the result to the $backupfile variable.
Run the Remove-VBRUnstructuredBackup cmdlet. Set the $backupfile variable as the Backup parameter value.

Remove-VBRUnstructuredBackup Example 4. Removing Restore Points of File Backups for Specific File Share

This example shows how to remove restore points of the NFS03 backup file created to back up the \\WinSRV2049\Documents file share.

$backupfile = Get-VBRUnstructuredBackup -Name "NFS03"

$server = Get-VBRUnstructuredServer -Name "\\WinSRV2049\Documents"

$restorepoint = Get-VBRUnstructuredBackupRestorePoint -Server $server -Backup $backupfile

Remove-VBRUnstructuredBackup -RestorePoint $restorepoint -RunAsync

Perform the following steps:

Run the Get-VBRUnstructuredBackup cmdlet. Specify the Name parameter value. Save the result to the $backupfile variable.
Run the Get-VBRUnstructuredServer cmdlet. Specify the Name parameter value. Save the result to the $server variable.
Run the Get-VBRUnstructuredBackupRestorePoint cmdlet. Set the $server variable as the Server parameter value. Set the $backupfile variable as the Backup parameter value. Save the result to the $restorepoint variable.
Run the Remove-VBRUnstructuredBackup cmdlet. Set the $restorepoint as the RestorePoint parameter value. Provide the RunAsync parameter.