---
title: "Copy-VBRBackup"
description: "Copies backups to a repository or local or shared folder. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet provides the following parameter sets: This cmdlet copies the whole backup chains to a repository or"
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/copy-vbrbackup.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Backup > Managing Backups > Copy-VBRBackup"
dateModified: "2026-08-19"
---

# Copy-VBRBackup

## Short Description
Copies backups to a repository or local or shared folder.

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

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>Path</code></p>

```
Copy-VBRBackup -Backup <CBackup> [-Name <String[]>] [-Path <String>] [-ShareCredentials <CCredentials>]
 [-AutoDelete <VBRMoveCopyRetention>] [-RetentionNumber <Int32>]
 [-RetentionPeriodType <VBRRetentionPeriodType>] [-RunAsync] [-Force]
 [-WhatIf] [-Confirm] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Repository</code></p>

```
Copy-VBRBackup -Backup <CBackup> [-Name <String[]>] [-Repository <CBackupRepository>]
 [-AutoDelete <VBRMoveCopyRetention>] [-RetentionNumber <Int32>]
 [-RetentionPeriodType <VBRRetentionPeriodType>] [-RunAsync] [-Force]
 [-WhatIf] [-Confirm] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet copies the whole backup chains to a repository or local or shared folder.

## 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">AutoDelete</span></p>
        </td>
        <td>
          <p>Specifies the time interval after which Veeam Backup & Replication will delete copied backups.</p><p>The parameter accepts the following values:</p><ul><li><code>In1Month</code></li><li><code>In3Months</code></li><li><code>In6Months</code></li><li><code>In1Year</code></li><li><code>In2Years</code></li><li><code>In3Years</code></li><li><code>In5Years</code></li><li><code>In7Years</code></li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRMoveCopyRetention</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 the backups that will be copied.</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 copy backups without showing warnings in the PowerShell console.</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">Name</span></p>
        </td>
        <td>
          <p>Specifies an array of names of the workloads that you want to move.</p><p><strong>Note</strong>: This parameter applies only if backups are per-machine with metadata for each workload.</p>
        </td>
        <td style="width:10%;">
          <p><code>String[]</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Path</span></p>
        </td>
        <td>
          <p>Specifies a path to the local or shared folder to which you want to copy backups.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Repository</span></p>
        </td>
        <td>
          <p>Specifies the repository to which you want to copy backups.</p><p>Accepts the <code>CBackupRepository</code> object. To get this object, run the <a href="get-vbrbackuprepository.md"><code>Get-VBRBackupRepository</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CBackupRepository</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">RetentionNumber</span></p>
        </td>
        <td>
          <p>For the <code>RetentionPeriodType</code> option.</p><p>Specifies the period of time to keep the copied data. After this period finishes, Veeam Backup & Replication will remove data.</p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</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">RetentionPeriodType</span></p>
        </td>
        <td>
          <p>Specifies the type of the retention policy. You can set the following types:</p><ul><li><code>Days</code>: use this option if you want Veeam Backup & Replication to apply retention policy daily.</li><li><code>Months</code>: use this option if you want Veeam Backup & Replication to apply retention policy monthly.</li><li><code>Years</code>: use this option if you want Veeam Backup & Replication to apply retention policy yearly.</li></ul><p>Use the <code>RetentionNumber</code> to specify the number of days, months or years.</p><p><strong>Note</strong>: Use this parameter if the <code>AutoDelete</code> parameter is not specified.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRRetentionPeriodType</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">ShareCredentials</span></p>
        </td>
        <td>
          <p>Specifies the credentials that will be used to access the shared folder.</p><p>Accepts the <code>CCredentials</code> object. To get this object, run the <code>Get-VBRCredentials</code> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CCredentials</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>
      <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>
        </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).

## Output Object
The cmdlet returns the [`VBRCopyBackupSession`](vbrcopybackupsession.md) object that contains settings of the copy session.

## Examples

::: example
### Copying Backups

This example shows how to copy backups to a repository.

```
$backup = Get-VBRBackup
$repository = Get-VBRBackupRepository
Copy-VBRBackup -Backup $backup -Repository $repository
```

Perform the following steps:

1. Run the [`Get-VBRBackup`](get-vbrbackup.md) cmdlet. Save the result to the `$backup` variable.
2. Run the [`Get-VBRBackupRepository`](get-vbrbackuprepository.md) cmdlet. Save the result to the `$repository` variable.
3. Run the `Copy-VBRBackup` cmdlet. Set the `$backup` variable as the `Backup` parameter value. Set the `$repository` variable as the `Repository` parameter value.

:::

## Related Commands

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