---
title: "Add-VBRStorageCopyJob"
description: "This cmdlet creates storage backup copy jobs for HPE StoreOnce and Dell Data Domain repositories."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/add-vbrstoragecopyjob.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Backup Copy > Storage Backup Copy Jobs > Add-VBRStorageCopyJob"
dateModified: "2026-08-19"
---

# Add-VBRStorageCopyJob

## Short Description
Creates storage backup copy jobs.

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

## Syntax
```
Add-VBRStorageCopyJob [-Name] <String> [-Description <String>] -SourceRepository <CBackupRepository[]>
 -TargetRepository <CBackupRepository[]> [-EnableHealthCheck] [-KeepSecondaryCopies]
 [-SecondaryCopiesRetentionPeriod <Int32>] [-NotificationOptions <VBRNotificationOptions>]
 [-ScriptOptions <VBRJobScriptOptions>] [-BackupWindowOptions <VBRBackupWindowOptions>] [-Force] [<CommonParameters>]
```

## Detailed Description
This cmdlet creates storage backup copy jobs for HPE StoreOnce and Dell Data Domain repositories.

## 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">BackupWindowOptions</span></p>
        </td>
        <td>
          <p>Specifies backup window settings for a job. The cmdlet will create the the backup copy job with these settings.</p><p>Accepts the <a href="vbrbackupwindowoptions.md"><code>VBRBackupWindowOptions</code></a> object. To create this object, run the <a href="new-vbrbackupwindowoptions.md"><code>New-VBRBackupWindowOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrbackupwindowoptions.md"><code>VBRBackupWindowOptions</code></a></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">Description</span></p>
        </td>
        <td>
          <p>Specifies a description of a backup copy job. The cmdlet will create the backup copy job with this description.</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>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">EnableHealthCheck</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will enable the Health check option.</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">Force</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will create backup copy jobs 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">KeepSecondaryCopies</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will enable retention policy for the backup files in the target location.</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 a name of a storage backup copy job. The cmdlet will create the copy job with this name.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>0</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">NotificationOptions</span></p>
        </td>
        <td>
          <p>Specifies notification settings. The cmdlet will create the backup copy job with these settings.</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><a href="vbrnotificationoptions.md"><code>VBRNotificationOptions</code></a></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">ScriptOptions</span></p>
        </td>
        <td>
          <p>Specifies job script options. The cmdlet will create a copy job with these script options.</p><p>Accepts the <code>VBRJobScriptOptions</code> object. To create this object, run the <a href="new-vbrjobscriptoptions.md"><code>New-VBRJobScriptOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrjobscriptoptions.md"><code>VBRJobScriptOptions</code></a></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">SecondaryCopiesRetentionPeriod</span></p>
        </td>
        <td>
          <p>Specifies a number of days for which you want to store backup files in the target location.</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">SourceRepository</span></p>
        </td>
        <td>
          <p>Specifies an array of source repositories. The cmdlet will copy backup files from these repositories.</p><p>You can specify the following types of repositories:</p><ul><li>HPE StoreOnce repositories.</li><li>Scale-Out Backup repository that consists of HPE StoreOnce or Dell Data Domain extents.</li><li>Dell Data Domain.</li></ul><p><strong>Note</strong>: The array of source repositories must contain the same number of the repositories as the array of the target repositories.</p><p>Accepts the string and 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>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">TargetRepository</span></p>
        </td>
        <td>
          <p>Specifies an array of target repositories. The cmdlet will copy backup files to these repositories.</p><p>You can specify the following types of repositories:</p><ul><li>HPE StoreOnce repositories.</li><li>Scale-Out Backup repository that consists of HPE StoreOnce or Dell Data Domain extents.</li><li>Dell Data Domain repositories.</li></ul><p><strong>Note</strong>: The array of target repositories must contain the same number of the repositories as the array of the source repositories.</p><p>Accepts the string and 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>True</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 `VBRStorageCopyJob` object that contains settings of storage backup copy jobs.

## Examples

::: example
### Example 1. Creating Backup Copy Job for Specific HPE StoreOnce Repositories

This example shows how to create a backup copy job that will copy data from the source `HPE StoreOnce 1` repository to the target `HPE StoreOnce 2` repository.

```
$source = Get-VBRBackupRepository -Name "HPE StoreOnce 1"
$target = Get-VBRBackupRepository -Name "HPE StoreOnce 2"
Add-VBRStorageCopyJob -Name "StoreOnce copy job" -SourceRepository $source -TargetRepository $target -Description "Copy job for StoreOnce repository"
```

Perform the following steps:

1. Run the [`Get-VBRBackupRepository`](get-vbrbackuprepository.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$source` variable.
2. Run the [`Get-VBRBackupRepository`](get-vbrbackuprepository.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$target` variable.
3. Run the `Add-VBRStorageCopyJob` cmdlet. Specify the following settings:

   - Specify the `Name` parameter value.
   - Set the `$source` variable as the `SourceRepository` parameter value.
   - Set the `$target` variable as the `TargetRepository` parameter value.
   - Specify the `Description` parameter value.

:::

::: example
### Example 2. Creating Backup Copy Job for List of HPE StoreOnce Repositories

This example shows how to create a backup copy job that will copy data from a list of source repositories to a list of the target repositories. Veeam Backup & Replication will copy data according to the following scheme:

- From `HPE StoreOnce 1` to `HPE StoreOnce 4`
- From `HPE StoreOnce 2` to `HPE StoreOnce 5`
- From `HPE StoreOnce 3` to `HPE StoreOnce 6`

```
$source = Get-VBRBackupRepository -Name "HPE StoreOnce 1", "HPE StoreOnce 2", "HPE StoreOnce 3"
$target = Get-VBRBackupRepository -Name "HPE StoreOnce 4", "HPE StoreOnce 5", "HPE StoreOnce 6"
Add-VBRStorageCopyJob -Name "StoreOnce copy job" -SourceRepository $source -TargetRepository $target -Description "Copy job for StoreOnce repository"
```

Perform the following steps:

1. Run the [`Get-VBRBackupRepository`](get-vbrbackuprepository.md) cmdlet. Specify the `Name` parameter value.

   Save the result to the `$source` variable. The [`Get-VBRBackupRepository`](get-vbrbackuprepository.md) cmdlet will return an array of source HPE StoreOnce repositories.

2. Run the [`Get-VBRBackupRepository`](get-vbrbackuprepository.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$target` variable.

   The [`Get-VBRBackupRepository`](get-vbrbackuprepository.md) cmdlet will return an array of target HPE StoreOnce repositories.

3. Run the `Add-VBRStorageCopyJob` cmdlet. Specify the following settings:

   - Specify the `Name` parameter value.
   - Set the `$source` variable as the `SourceRepository` parameter value.
   - Set the `$target` variable as the `TargetRepository` parameter value.
   - Specify the `Description` parameter value.

:::

::: example
### Example 3. Creating Backup Copy Job for HPE StoreOnce Repository with Backup Window Options

This example shows how to create a backup copy job for an HPE StoreOnce repository. The job will run during the following period of time:

- From 22:00 to 22:59 on Friday
- From 22:00 to 22:59 on Saturday

```
$source = Get-VBRBackupRepository -Name "HPE SO 05"
$target = Get-VBRBackupRepository -Name "HPE SO 07"
$windowoptions = New-VBRBackupWindowOptions -FromDay Friday -FromHour 22 -ToDay Saturday -ToHour 22 -Enabled
Add-VBRStorageCopyJob -Name "StoreOnce copy job" -SourceRepository $source -TargetRepository $target -Description "Copy job for StoreOnce repository" -BackupWindowOptions $windowoptions
```

Perform the following steps:

1. Run the [`Get-VBRBackupRepository`](get-vbrbackuprepository.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$source` variable.
2. Run the [`Get-VBRBackupRepository`](get-vbrbackuprepository.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$target` variable.
3. Run the [`New-VBRBackupWindowOptions`](new-vbrbackupwindowoptions.md) cmdlet. Specify the necessary parameters. Save the result to the `$windowoptions` variable.
4. Run the `Add-VBRStorageCopyJob` cmdlet. Specify the following settings:

   - Specify the `Name` parameter value.
   - Set the `$source` variable as the `SourceRepository` parameter value.
   - Set the `$target` variable as the `TargetRepository` parameter value.
   - Specify the `Description`  parameter value.
   - Set the `$windowoptions` variable as the `BackupWindowOptions` parameter value.

:::

## Related Commands

- [`Get-VBRBackupRepository`](get-vbrbackuprepository.md)
- [`New-VBRBackupWindowOptions`](new-vbrbackupwindowoptions.md)