Remove-VBRNASBackup - Veeam Backup PowerShell Reference

Parameter	Description	Type	Required	Position	Accept Pipeline Input
NASBackup	Specifies an array of backup files created by the file backup job. The cmdlet will remove these backup files.	Accepts the VBRNASBackup[] object. To create this object, run the Get-VBRNASBackup cmdlet.	True	Named	True (ByValue, ByPropertyName)
NASServer	Specifies an array of file shares. The cmdlet will remove backup files of the specified file shares.	Accepts the VBRNASServer[] object. To create this object, run the Get-VBRNASServer cmdlet.	True	Named	False
RestorePoint	Specifies an array of restore points. The cmdlet will remove specified file shares.	Accepts the VBRNASBackupRestorePoint[] object. To create this object, run the Get-VBRNASBackupRestorePoint cmdlet.	True	Named	True (ByValue, ByPropertyName)
FromDisk	Defines that the cmdlet will remove backup files from disk.	SwitchParamter	True	Named	False
RunAsync	Indicates that the command returns immediately without waiting for the task to complete.	SwitchParamter	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.	SwitchParamter	False	Named	False
Confirm	Defines that the cmdlet will display a prompt that asks if the user is sure that he wants to continue.	SwitchParamter	False	Named	False

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

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

Remove-VBRNASBackup -NASBackup $backupfile

Perform the following steps:

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

This example shows how to remove the Reports backup of the \\WinSRV2049\Documents file share from a disk.

$backupfile = Get-VBRNASBackup -Name "Reports"

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

Remove-VBRNASBackup -NASBackup $backupfile -NASServer $server

Perform the following steps:

Run the Get-VBRNASBackup cmdlet. Specify the Name parameter value. Save the result to the $backupfile variable.
Run the Get-VBRNASServer cmdlet. Specify the Name parameter value. Save the result to the $server variable.
Run the Remove-VBRNASBackup cmdlet. Set the $backupfile variable as the NASBackup parameter value. Set the $server variable as the NASServer parameter value.

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

$backupfile = Get-VBRNASBackup -Name "Reports"

Remove-VBRNASBackup -NASBackup $backupfile -FromDisk

Perform the following steps:

Run the Get-VBRNASBackup cmdlet. Specify the Name parameter value. Save the result to the $backupfile variable.
Run the Remove-VBRNASBackup cmdlet. Set the $backupfile variable as the NASBackup parameter value. Set the $server variable as the NASServer parameter value.

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

$backupfile = Get-VBRNASBackup -Name "NFS03"

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

$restorepoint = Get-VBRNASBackupRestorePoint -NASServer $server -NASBackup $backupfile

Remove-VBRNASBackup -RestorePoint $restorepoint -RunAsync

Perform the following steps:

Run the Get-VBRNASBackup cmdlet. Specify the Name parameter value. Save the result to the $backupfile variable.
Run the Get-VBRNASServer cmdlet. Specify the Name parameter value. Save the result to the $server variable.
Run the Get-VBRNASBackupRestorePoint cmdlet. Set the $server variable as the NASServer parameter value. Set the $backupfile variable as the NASBackup parameter value.
Run the Remove-VBRNASBackup cmdlet. Set the $restorepoint as the RestorePoint parameter value. Provide the RunAsync parameter.