---
title: "Set-VBRAzureComputeBackupCopyJob"
description: "This cmdlet modifies Azure IaaS backup copy jobs. 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."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/set-vbrazurecomputebackupcopyjob.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Backup Copy > Azure Backup Copy Job > Set-VBRAzureComputeBackupCopyJob"
dateModified: "2026-08-19"
---

# Set-VBRAzureComputeBackupCopyJob

## Short Description
Modifies Azure IaaS backup copy jobs.

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

## Syntax
```
Set-VBRAzureComputeBackupCopyJob -Job <CBackupJob> [-Name <String>] [-Description <String>]
 [-Backup <VBRAzureComputeBackup[]>] [-Repository <CBackupRepository>]
 [-RecoveryPointObjective <VBRRecoveryPointObjective>] [-RetentionPolicy <VBRRetentionPolicy>]
 [-BackupWindowOptions <VBRBackupWindowOptions>] [<CommonParameters>]
```

## Detailed Description
This cmdlet modifies Azure IaaS 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">Backup</span></p>
        </td>
        <td>
          <p>Specifies an array of Azure backups that you want to copy.</p><p>Accepts the <code>VBRAzureComputeBackup[]</code> object. To get this object, run the <a href="get-vbrazurecomputebackup.md"><code>Get-VBRAzureComputeBackup</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRAzureComputeBackup[]</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 the period of time when a backup copy job is allowed to run.</p><p>Accepts the <a href="vbrbackupwindowoptions.md"><code>VBRBackupWindowOptions</code></a> object. To get 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 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">Job</span></p>
        </td>
        <td>
          <p>Specifies an Azure backup copy job. The cmdlet will modify this job.</p><p>Accepts the <code>CBackupJob</code> object. To get this object, run the <a href="get-vbrjob.md"><code>Get-VBRJob</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CBackupJob</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 of a backup copy job. The cmdlet will create the 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">RecoveryPointObjective</span></p>
        </td>
        <td>
          <p>Specifies a backup copy interval. The cmdlet will copy new restore points of Azure IaaS backup copy jobs to the target backup repository.</p><p>Accepts the <code>VBRRecoveryPointObjective</code> object. To create this object, run the <a href="new-vbrrecoverypointobjective_azure.md"><code>New-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 a target backup repository. The cmdlet will copy Azure backups to this 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">RetentionPolicy</span></p>
        </td>
        <td>
          <p>Specifies a number of restore points to keep on a target backup repository.</p><p>Accepts the <code>VBRRetentionPolicy</code> object. To get this object, run the following cmdlets:</p><ul><li><a href="new-vbrgfsretentionpolicy_azure.md"><code>New-VBRGFSRetentionPolicy</code></a></li><li><a href="new-vbrsimpleretentionpolicy_azure.md"><code>New-VBRSimpleRetentionPolicy</code></a></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>
    </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 `VBRAzureComputeBackupCopyJob` object that contains an array of Azure IaaS backup copy jobs.

## Examples

::: example
### Modifying Backup Repository of Azure Backup Copy Job

This example shows how to modify a backup repository of an Azure backup copy job.

```
$copyjob = Get-VBRJob -Name "Azure backup copy"
$repository = Get-VBRBackupRepository
Set-VBRAzureComputeBackupCopyJob -Job $copyjob -Repository $repository
```

Perform the following steps:

1. Run the [`Get-VBRJob`](get-vbrjob.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$copyjob` variable.
2. Run the [`Get-VBRBackupRepository`](get-vbrbackuprepository.md) cmdlet. Save the result to the `$repository` variable.
3. Run the `Set-VBRAzureComputeBackupCopyJob` cmdlet. Set the `$copyjob` variable as the `Job` parameter value. Set the `$repository` variable as the `Repository` parameter value.

:::

## Related Commands

- [`Get-VBRJob`](get-vbrjob.md)
- [`Get-VBRBackupRepository`](get-vbrbackuprepository.md)