---
title: "Forget-VBRCloudUnavailableBackupFile"
description: "Removes backup files, that are no longer available, from a cloud repository. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet removes backup files, that are no longer available, from a cloud repository."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/forget-vbrcloudunavailablebackupfile.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Backup > Managing Backups > Forget-VBRCloudUnavailableBackupFile"
dateModified: "2026-08-19"
---

# Forget-VBRCloudUnavailableBackupFile

## Short Description
Removes backup files, that are no longer available, from a cloud repository.

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

## Syntax
```
Forget-VBRCloudUnavailableBackupFile -BackupFiles <VBRCloudUnavailableBackupFile[]> [-IncludeDependentFiles] [<CommonParameters>]
```

## Detailed Description
This cmdlet removes backup files, that are no longer available, from a cloud repository.

::: note

Any restore points on a repository or extent that is inaccessible, on in Maintenance mode, will be considered as unavailable. Before you remove these backup files, check the list of the files that the [`Get-VBRCloudUnavailableBackupFile`](get-vbrcloudunavailablebackupfile.md) cmdlet returns to ensure the correct files will be removed.

:::

## 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">BackupFiles</span></p>
        </td>
        <td>
          <p>Specifies backup files that you want to remove.</p><p>Accepts the <code>VBRCloudUnavailableBackupFile[]</code> object. To create this object, run the <a href="get-vbrcloudunavailablebackupfile.md"><code>Get-VBRCloudUnavailableBackupFile</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrcloudunavailablebackupfile.md"><code>VBRCloudUnavailableBackupFile[]</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>True (ByPropertyName, ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">IncludeDependentFiles</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will remove incremental backup files that are related to the full backup files. If you do not provide this parameter, the cmdlet will not remove full backup files and incremental backup files that are related to these full backup files.</p><p><strong>Note</strong>: If full backup files that you want to remove do not have incremental backup files, the cmdlet will remove these full backup files even if you do not provide the <code>IncludeDependentFiles</code> parameter.</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>True (ByPropertyName, ByValue)</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
### Removing Unavailable Backup Files from Cloud Repository

This example shows how to remove backup files that are no longer available from a cloud repository for the `ABC Company` cloud tenant account. The cmdlet will remove incremental files as well.

```
$tenant = Get-VBRCloudTenant -Name "ABC Company"
$backupfiles = Get-VBRCloudUnavailableBackupFile -CloudTenant $tenant
Forget-VBRCloudUnavailableBackupFile -BackupFiles $backupfiles
```

Perform the following steps:

1. Run the [`Get-VBRCloudTenant`](get-vbrcloudtenant.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$tenant` variable.
2. Run the [`Get-VBRCloudUnavailableBackupFile`](get-vbrcloudunavailablebackupfile.md) cmdlet. Set the `$tenant` variable as the `CloudTenant` parameter value. Save the result to the `$backupfiles` variable.
3. Run the `Forget-VBRCloudUnavailableBackupFile` cmdlet. Set the `$backupfiles` variable as the `BackupFiles` parameter value.

:::

## Related Commands

- [`Get-VBRCloudTenant`](get-vbrcloudtenant.md)
- [`Get-VBRCloudUnavailableBackupFile`](get-vbrcloudunavailablebackupfile.md)