---
title: "Set-VBRComputerBackupCopyJob"
description: "Modifies Veeam Agent backup copy jobs. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet modifies Veeam Agent backup copy jobs. To modify settings, specify new values for the necessary parameters."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/set-vbrcomputerbackupcopyjob_agent.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Veeam Agent Management > Working with Veeam Agent Backup Jobs and Policies > Veeam Agent Backup Copy Jobs > Set-VBRComputerBackupCopyJob"
dateModified: "2026-08-19"
---

# Set-VBRComputerBackupCopyJob

## Short Description
Modifies Veeam Agent backup copy jobs.

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

## Syntax
```
Set-VBRComputerBackupCopyJob -Job <VBRComputerBackupCopyJob> [-Name <String>] [-Description <String>]
 [-Backup <CBackup[]>] [-BackupJob <VBRComputerBackupJob[]>] [-SourceRepository <CBackupRepository[]>]
 [-Repository <CBackupRepository>] [-DirectOperation] [-SourceAccelerator <CWanAccelerator>]
 [-TargetAccelerator <CWanAccelerator>] [-Force] [-RecoveryPointObjective <VBRRecoveryPointObjective>]
 [-RetentionPolicy <VBRRetentionPolicy>] [-BackupWindowOptions <VBRBackupWindowOptions>]
 [-NotificationOptions <VBRNotificationOptions>] [-StorageOptions <VBRBackupCopyJobStorageOptions>]
 [-HealthCheckOptions <VBRHealthCheckOptions>] [-ScriptOptions <VBRJobScriptOptions>]
 [-RPOWarningOptions <VBRRpoNotificationOption[]>] [-EnableTransactionLogCopy] [-AnyTime]
 [-GFSOptions <VBRComputerGFSOptions>] [-RetentionType <VBRRetentionType>] [-RetentionNumber <Int32>] [<CommonParameters>]
```

## Detailed Description
This cmdlet modifies Veeam Agent backup copy jobs.

::: 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 Veeam Agent backup copy job at any time according to its schedule.</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. The cmdlet will add machines from these backups to a Veeam Agent backup copy.</p><p><strong>Note</strong>: This parameter is available for a Veeam Agent backup copy job that is created with the periodic backup copy mode.</p><p>Accepts the <code>CBackup[]</code> object. To create 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>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">BackupJob</span></p>
        </td>
        <td>
          <p>Specifies an array of backup jobs. The cmdlet will add machines processed by these jobs to a Veeam Agent backup copy job.</p><p>Accepts the <code>VBRComputerBackupJob[]</code> object. To create this object, run the <a href="get-vbrcomputerbackupjob.md"><code>Get-VBRComputerBackupJob</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRComputerBackupJob[]</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)</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 Veeam Agent backup copy job. The cmdlet will create the 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 Veeam Agent backup copy job.</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">DirectOperation</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will create a Veeam Agent backup copy job that will transfer data directly from the source backup repository to the target backup repository.</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">EnableTransactionLogCopy</span></p>
        </td>
        <td>
          <p>Defines that the Veeam Agent backup copy job will process transaction logs of the source job.</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 Veeam Agent 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">GFSOptions</span></p>
        </td>
        <td>
          <p>Specifies a GFS retention. The cmdlet will create Veeam Agent backup copy job with the specified policy.</p><p><strong>Note</strong>: This option is not available for Veeam Agent policies.</p><p>Accepts the <code>VBRComputerGFSOptions</code> object. To get this object, run the <a href="new-vbrcomputergfsoptions.md"><code>New-VBRComputerGFSOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRComputerGFSOptions</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">HealthCheckOptions</span></p>
        </td>
        <td>
          <p>Specifies the health check schedule for a Veeam Agent backup copy job. The cmdlet will create the job with these settings.</p><p>Accepts the <code>VBRFullBackupOptions</code> object. To create this object, run the <a href="new-vbrfullbackupoptions.md"><code>New-VBRFullBackupOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRHealthCheckOptions</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 Veeam Agent backup copy job that you want to modify.</p><p>Accepts the <code>VBRComputerBackupCopyJob</code> object. To create this object, run the <a href="get-vbrcomputerbackupcopyjob.md"><code>Get-VBRComputerBackupCopyJob</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRComputerBackupCopyJob</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">Name</span></p>
        </td>
        <td>
          <p>Specifies a name that you want to assign to a Veeam Agent backup copy job.</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 for a Veeam Agent backup copy job. The cmdlet will create the job with these settings.</p><p>Accepts the <code>VBRNotificationOptions</code> object. To create this object, run the <a href="new-vbrnotificationoptions.md"><code>New-VBRNotificationOptions</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">RecoveryPointObjective</span></p>
        </td>
        <td>
          <p>Specifies a schedule for a Veeam Agent backup copy job with the periodic backup copy mode. The cmdlet will create the job with these settings.</p><p>Accepts the <code>VBRRecoveryPointObjective</code> object. To create this object, run the <a href="get-vbrrecoverypointobjective.md"><code>Get-VBRRecoveryPointObjective</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRRecoveryPointObjective</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">Repository</span></p>
        </td>
        <td>
          <p>Specifies the backup repository. The cmdlet will copy the machine data to this repository.</p><p>Default: Default backup repository.</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>False</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>RetentionType</code> set to the <code>RestoreDays</code> property.</p><p>Specifies a number of days for which you want to store backup files in the target location.</p><p>Default: 7 days.</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">RetentionPolicy</span></p>
        </td>
        <td>
          <p>Specifies a retention policy for a Veeam Agent backup copy job. The cmdlet will create the job with these settings. You can specify the following types of retention policies:</p><ul><li><strong>Simple retention policy</strong>: use this option for short-time archiving. To create a job with this type of the policy, provide the <code>VBRSimpleRetentionPolicy</code> object. Run the <a href="new-vbrsimpleretentionpolicy.md"><code>New-VBRSimpleRetentionPolicy</code></a> cmdlet to create this object.</li><li><strong>GFS retention policy</strong>: use this option for long-term archiving. To create a job with this type of the policy, provide the <code>VBRRetentionPolicy</code> object. Run the <a href="new-vbrgfsretentionpolicy.md"><code>New-VBRGFSRetentionPolicy</code></a> cmdlet to create this object.</li></ul><p>Accepts the following objects:</p><ul><li><code>VBRRetentionPolicy</code>. Run the <a href="new-vbrgfsretentionpolicy.md"><code>New-VBRGFSRetentionPolicy</code></a> cmdlet to get this object.</li><li><code>VBRSimpleRetentionPolicy</code>. Run the <a href="new-vbrsimpleretentionpolicy.md"><code>New-VBRSimpleRetentionPolicy</code></a> cmdlet to create this object.</li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRRetentionPolicy</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">RetentionType</span></p>
        </td>
        <td>
          <p>Specifies retention type for Veeam Agent copy jobs managed by the Veeam Backup server. You can specify one of the following types:</p><ul><li><code>RestorePoints</code></li><li><code>RestoreDays</code></li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRRetentionType</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">RPOWarningOptions</span></p>
        </td>
        <td>
          <p>Specifies an array of the number of hours when data must be copied from the source repository to the target repository.</p><p>Default: <code>1 hour</code>.</p><p>Accepts the <code>VBRRPONotificationOptions[]</code> object. To create this object, run the <a href="new-vbrrponotificationoption.md"><code>New-VBRRPONotificationOption</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrrponotificationoption.md"><code>VBRRpoNotificationOption[]</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 pre-job and post-job script options for a Veeam Agent backup copy job. The cmdlet will create the job with these settings.</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">SourceAccelerator</span></p>
        </td>
        <td>
          <p>Specifies the WAN accelerator on the source side.</p><p>Remember to set the pair of source and target WAN accelerators.</p><p>Accepts the <a href="cwanaccelerator.md"><code>CWanAccelerator</code></a> object. To get this object, run the <a href="get-vbrwanaccelerator.md"><code>Get-VBRWANAccelerator</code></a>cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="cwanaccelerator.md"><code>CWanAccelerator</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">SourceRepository</span></p>
        </td>
        <td>
          <p>Specifies an array of source backup repositories.</p><p>Accepts the <code>CBackupRepository[]</code> object. To create 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)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">StorageOptions</span></p>
        </td>
        <td>
          <p>Specifies the storage settings of the backup repository. The cmdlet will create the Veeam Agent backup copy job with these settings.</p><p>Accepts the <code>VBRBackupCopyJobStorageOptions</code> object. To create this object, run the <a href="new-vbrbackupcopyjobstorageoptions.md"><code>New-VBRBackupCopyJobStorageOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRBackupCopyJobStorageOptions</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">TargetAccelerator</span></p>
        </td>
        <td>
          <p>Specifies the WAN accelerator on the target side.</p><p>Remember to set the pair of source and target WAN accelerators.</p><p>Accepts the <a href="cwanaccelerator.md"><code>CWanAccelerator</code></a> object. To get this object, run the <a href="get-vbrwanaccelerator.md"><code>Get-VBRWANAccelerator</code></a>cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="cwanaccelerator.md"><code>CWanAccelerator</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>
    </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 `VBRComputerBackupCopyJob` object that contains settings of Veeam Agent backup copy jobs.

## Examples

::: example
### Modifying Backup Window Settings for Veeam Agent Backup Copy Job

The following example shows how to modify backup window settings for a Veeam Agent Backup Copy job.

```
$job = Get-VBRComputerBackupCopyJob -Name "Windows Copy Job05"
$windowoptions = New-VBRBackupWindowOptions -FromDay Monday -FromHour 08 -ToDay Friday -ToHour 20
Set-VBRComputerBackupCopyJob -Job $job -BackupWindowOptions $windowoptions
```

Perform the following steps:

1. Run the [`Get-VBRComputerBackupCopyJob`](get-vbrcomputerbackupcopyjob.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-VBRComputerBackupCopyJob` cmdlet. Set the `$job` variable as the `Job` parameter value. Set the `$windowoptions` variable as the `BackupWindowOptions` parameter value.

:::

## Related Commands

- [`Get-VBRComputerBackupCopyJob`](get-vbrcomputerbackupcopyjob.md)
- [`New-VBRBackupWindowOptions`](new-vbrbackupwindowoptions.md)