---
title: "Remove-VBRBackupFile"
description: "Removes missing backup files from the Veeam Backup & Replication configuration database. If the four-eyes authorization is enabled, you cannot run this cmdlet."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/remove-vbrbackupfile.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Backup > Managing Backups > Remove-VBRBackupFile"
dateModified: "2026-08-19"
---

# Remove-VBRBackupFile

## Short Description
Removes missing backup files from the Veeam Backup & Replication configuration database.

::: note

If the four-eyes authorization is enabled, you cannot run this cmdlet. For more information, see the [Four-Eyes Authorization](https://helpcenter.veeam.com/docs/vbr/userguide/four_eyes_authorization.html?ver=13) section in the User Guide for VMware vSphere.

:::

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

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>BackupFile (Default)</code></p>

```
Remove-VBRBackupFile -BackupFile <VBRBackupFile> [-FromDisk] [-WhatIf]
 [-Confirm] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Backup</code></p>

```
Remove-VBRBackupFile -Backup <CBackup> [-FromDisk] [-WhatIf] [-Confirm] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet removes missing backup files from the Veeam Backup & Replication configuration database.

## Parameters

<table style="width:100%;" class="Blue_Table">
      <tr style="vertical-align:top">
        <th style="width:20%;">
          <p>Parameter</p>
        </th>
        <th style="width:20%;">
          <p>Description</p>
        </th>
        <th style="width:20%;">
          <p>Type</p>
        </th>
        <th style="width:10%;">
          <p>Required</p>
        </th>
        <th style="width:10%;">
          <p>Position</p>
        </th>
        <th style="width:10%;">
          <p>Accept Pipeline Input</p>
        </th>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Backup</span></p>
        </td>
        <td>
          <p>Specifies a backup from which you want to remove missing backup files.</p><p>Accepts the <code>CBackup</code> object. To create this object, run the <a href="get-vbrbackup.md"><code>Get-VBRBackup</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CBackup</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">BackupFile</span></p>
        </td>
        <td>
          <p>Specifies a missing backup file that you want to remove.</p><p>Accepts the <a href="vbrbackupfile.md"><code>VBRBackupFile</code></a> object. To create this object, run the <a href="get-vbrbackupfile.md"><code>Get-VBRBackupFile</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrbackupfile.md"><code>VBRBackupFile</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">FromDisk</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will remove the missing backup files from the configuration database and from disk (if these backup files are still available). If you do not provide this parameter, the cmdlet will remove missing backup files from the configuration database only.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Confirm</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will display a prompt that asks if you want to continue running the command.</p><p><strong>Note</strong>: Microsoft PowerShell enables the <code>Confirm</code> parameter for this cmdlet by default. To disable this option, set the parameter value to <code>$false</code>. That is, <code>Confirm:$false</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">WhatIf</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will write a message that describes the effects of running the cmdlet without actually performing any action.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
    </table>

`<CommonParameters>`

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see [ Microsoft Docs](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-7).

## Examples

::: example
### Example 1. Removing Missing Backup File

This example shows how to remove a missing backup file and all backup files related to it from Veeam Backup & Replication configuration database.

```
$backup = Get-VBRBackup -Name "Daily backups"
$missingfile = Get-VBRBackupFile -Backup $backup[4]
Remove-VBRBackupFile -BackupFile $missingfile -Confirm
```

Perform the following steps:

1. Run the [`Get-VBRBackup`](get-vbrbackup.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$backup` variable.
2. Run the [`Get-VBRBackupFile`](get-vbrbackupfile.md) cmdlet. Set the `$backup[4]` variable as the `Backup` parameter value. Save the result to the `$missingfile` variable.
3. Run the `Remove-VBRBackupFile` cmdlet. Set the `$missingfile` variable as the `BackupFile` parameter value. Provide the `Confirm` parameter.

:::

::: example
### Example 2. Removing all Missing Backup Files from Backup

This example shows how to remove all backup files that are missing from a backup. The cmdlet will remove the files from the configuration database and from disk.

```
$backup = Get-VBRBackup -Name "Daily backups"
Remove-VBRBackupFile -Backup $backup -FromDisk
```

Perform the following steps:

1. Run the [`Get-VBRBackup`](get-vbrbackup.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$backup` variable.
2. Run the `Remove-VBRBackupFile` cmdlet. Set the `$backup` variable as the `Backup` parameter value. Provide the `FromDisk` parameter.

:::

## Related Commands

- [`Get-VBRBackup`](get-vbrbackup.md)
- [`Get-VBRBackupFile`](get-vbrbackupfile.md)