---
title: "Start-VBRDownloadBackup"
description: "Downloads backup files from the capacity tier to the performance tier. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet downloads backup files from the capacity tier to the performance tier."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/start-vbrdownloadbackup.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Backup Infrastructure > Scale-Out Backup Repositories > Capacity Tier > Start-VBRDownloadBackup"
dateModified: "2026-08-19"
---

# Start-VBRDownloadBackup

## Short Description
Downloads backup files from the capacity tier to the performance tier.

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

## Syntax
```
Start-VBRDownloadBackup -Backup <CBackup[]> [-AllBackup] [-RunAsync] [-Force] [<CommonParameters>]
```

## Detailed Description
This cmdlet downloads backup files from the capacity tier to the performance tier. You can download either all backup files or only the backup files from the latest backup chain.

## 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">AllBackup</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will download all backup files from capacity tier to the performance tier.</p><p><strong>Note</strong>: If you do not provide this parameter, the cmdlet will download the backup files from the latest backup chain.</p><p>Default: <code>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">Backup</span></p>
        </td>
        <td>
          <p>Specifies an array of backups which files you want to download to the performance tier. The cmdlet will either download backup files from the latest backup chain or all backup files that are located on the capacity tier.</p><p>Default: Downloads backup files from the latest backup chain.</p><p><strong>Note</strong>: If the backup files from the latest backup chain are already downloaded to the performance tier, the cmdlet will download all backup files from the capacity tier.</p><p>Accepts the <code>CBackup[]</code> object. To get 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>True (ByPropertyName, ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Force</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will start to download the backup files from the latest backup chain and will not prompt any notifications.</p><p><strong>Note</strong>:</p><ul><li>If the performance tier already contains the backup files from the latest backup chain, the cmdlet will not download any backup files from the capacity tier.</li><li>If you provide the <code>AllBackup</code> parameter, the cmdlet will download all backup files from the capacity tier to the performance tier.</li></ul>
        </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">RunAsync</span></p>
        </td>
        <td>
          <p>Defines that the command returns immediately without waiting for the task to complete.</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).

## Output Object
[`VBRSession`](vbrsession.md)

## Examples

::: example
### Example 1. Downloading Backup Files from Latest Backup Chain to Performance Tier

This example shows how to download the `Report09` backup files from the latest backup chain to the performance tier.

```
$backups = Get-VBRBackup -Name "Report09"
Start-VBRDownloadBackup -Backup $backups -RunAsync
```

Perform the following steps:

1. Run the [`Get-VBRBackup`](get-vbrbackup.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$backups` variable.
2. Run the `Start-VBRDownloadBackup` cmdlet. Set the `$backups` variable as the `Backup` parameter value. Provide the `RunAsync` parameter.

:::

::: example
### Example 2. Downloading all Backup Files to Performance Tier

This example shows how to download all `Report06` backup files to the performance tier.

```
$backups = Get-VBRBackup -Name "Report06"
Start-VBRDownloadBackup -Backup $backups -AllBackup -RunAsync
```

Perform the following steps:

1. Run the [`Get-VBRBackup`](get-vbrbackup.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$backups` variable.
2. Run the `Start-VBRDownloadBackup` cmdlet. Specify the following settings:

   - Set the `$backups` variable as the `Backup` parameter value.
   - Provide the `AllBackup` parameter.
   - Provide the `RunAsync` parameter.

:::

## Related Commands

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