---
title: "Set-VBRStorageCopyJob"
description: "This cmdlet modifies storage backup copy jobs for HPE StoreOnce and Dell Data Domain repositories. To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameter values with new values."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/set-vbrstoragecopyjob.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Backup Copy > Storage Backup Copy Jobs > Set-VBRStorageCopyJob"
dateModified: "2026-08-19"
---

# Set-VBRStorageCopyJob

## Short Description
Modifies storage backup copy jobs.

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

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

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

::: note

To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameter values with new values. The parameters that you omit will remain unchanged.

:::

## 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">AnyTime</span></p>
        </td>
        <td>
          <p>Defines that Veeam Backup & Replication will run a backup job continuously.</p><p><strong>Note</strong>: You cannot use this parameter together with the <strong>BackupWindowOptions</strong> 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>False</p>
        </td>
      </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><strong>Note</strong>: You cannot use this parameter together with the <strong>AnyTime</strong> parameter.</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 modify backup copy jobs that are created for HPE StoreOnce and Dell Data Domain repositories 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">Job</span></p>
        </td>
        <td>
          <p>Specifies a storage backup copy job you want to modify. The cmdlet will modify the settings of this job.</p><p>Accepts the <code>VBRStorageCopyJob</code> object. To get this object, run the <a href="get-vbrstoragecopyjob.md"><code>Get-VBRStorageCopyJob</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRStorageCopyJob</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 (ByValue)</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 backup copy job with this name.</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">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 repositories.</li></ul><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>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">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>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>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 `VBRStorageCopyJob` object that contains settings of backup copy jobs for HPE StoreOnce and Dell Data Domain repositories.

## Examples

::: example
### Example 1. Modifying Backup Copy Job Schedule to Run at Specific Time

This example shows how to modify backup window settings for a backup copy job. The backup copy job will run from 20:00 to 22:59 every day from Monday to Friday.

```
$job = Get-VBRStorageCopyJob -Name "Backup Copy StoreOnce 05"
$windowoptions = New-VBRBackupWindowOptions -FromDay Monday -ToDay Friday -FromHour 20 -ToHour 22 -Enabled
Set-VBRStorageCopyJob -Job $job -BackupWindowOptions $windowoptions
```

Perform the following steps:

1. Run the [`Get-VBRStorageCopyJob`](get-vbrstoragecopyjob.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$job` variable.
2. Run the [`New-VBRBackupWindowOptions`](new-vbrbackupwindowoptions.md) cmdlet. Specify the necessary parameters. Save the result to the `$windowoptions` variable.
3. Run the `Set-VBRStorageCopyJob` cmdlet. Set the `$job` variable as the `Job` parameter value. Set the `$windowoptions` variable as the `BackupWindowOptions` parameter value.

:::

::: example
### Example 2.  Modifying Backup Copy Job Schedule to Run Continuously

This example shows how to modify schedule settings for a backup copy job. The backup copy job will run continuously.

```
$job = Get-VBRStorageCopyJob -Name "Backup Copy StoreOnce 05"
Set-VBRStorageCopyJob -Job $job -BackupWindowOptions $windowoptions -AnyTime
```

Perform the following steps:

1. Run the [`Get-VBRStorageCopyJob`](get-vbrstoragecopyjob.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$job` variable.
2. Run the `Set-VBRStorageCopyJob` cmdlet. Set the `$job` variable as the `Job` parameter value. Set the `$windowoptions` variable as the `BackupWindowOptions` parameter value. Provide the `AnyTime` parameter.

:::

## Related Commands

- [`Get-VBRStorageCopyJob`](get-vbrstoragecopyjob.md)
- [`New-VBRBackupWindowOptions`](new-vbrbackupwindowoptions.md)