---
title: "Set-VBREntraIDTenantBackupJob"
description: "This cmdlet modifies an Entra ID tenant backup job."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/set-vbrentraidtenantbackupjob.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Microsoft EntraID Support > Tenant Backup Jobs > Set-VBREntraIDTenantBackupJob"
dateModified: "2026-08-19"
---

# Set-VBREntraIDTenantBackupJob

## Short Description
Modifies a backup job that protects a Microsoft Entra ID tenant.

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

## Syntax
```
Set-VBREntraIDTenantBackupJob -Job <VBREntraIDTenantBackupJob> [-Name <String>] [-Description <String>]
 [-RetentionPolicy <Int32>] [-NotificationOptions <VBRNotificationOptions>] [-EnableSchedule]
 [-ScheduleOptions <VBRServerScheduleOptions>] [-EncryptionOptions <VBREncryptionOptions>]
 [-EnableSecondaryTarget] [-SecondaryTarget <VBREntraIDBackupSecondaryTarget[]>]
 [-TargetBackup <VBREntraIDTenantBackup>] [<CommonParameters>]
```

## Detailed Description
This cmdlet modifies an Entra ID tenant backup job.

## 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">Description</span></p>
        </td>
        <td>
          <p>Specifies the description of the tenant backup 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">EnableSchedule</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will enable the custom schedule for the tenant backup job.</p><p>If you provide this parameter, the tenant backup job will run according to the schedule specified in <code>ScheduleOptions</code>. Otherwise, to run the job, you will need to start it manually.</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">EnableSecondaryTarget</span></p>
        </td>
        <td>
          <p>Enables copying tenant backups to the secondary 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">EncryptionOptions</span></p>
        </td>
        <td>
          <p>Specifies encryption options.</p><p>Accepts the <code>VBREncryptionOptions</code> object. To create this object, run the <a href="new-vbrencryptionoptions.md"><code>New-VBREncryptionOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrencryptionoptions.md"><code>VBREncryptionOptions</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">Job</span></p>
        </td>
        <td>
          <p>Specifies the tenant backup job that you want to modify.</p><p>Accepts the <code>VBREntraIDTenantBackupJob</code> object. To get this object, run the <a href="get-vbrentraidtenantbackupjob.md"><code>Get-VBREntraIDTenantBackupJob</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrentraidtenantbackupjob.md"><code>VBREntraIDTenantBackupJob</code></a></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">Name</span></p>
        </td>
        <td>
          <p>Specifies the name of the tenant backup 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 options. The cmdlet will create the log backup job with these notification options.</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">RetentionPolicy</span></p>
        </td>
        <td>
          <p>Specifies the retention policy in days for backups created by the tenant backup job.</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">ScheduleOptions</span></p>
        </td>
        <td>
          <p>Specifies schedule options.</p><p>Accepts the <code>VBRServerScheduleOptions</code> object. To create this object, run the <a href="new-vbrserverscheduleoptions.md"><code>New-VBRServerScheduleOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRServerScheduleOptions</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">SecondaryTarget</span></p>
        </td>
        <td>
          <p>Specifies secondary repository settings.</p><p>Accepts the <code>VBREntraIDBackupSecondaryTarget</code> object. To create this object, run the <a href="new-vbrentraidbackupsecondarytarget.md"><code>New-VBREntraIDBackupSecondaryTarget</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrentraidbackupsecondarytarget.md"><code>VBREntraIDBackupSecondaryTarget[]</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">TargetBackup</span></p>
        </td>
        <td>
          <p>Specifies Entra ID backup copy settings. The cmdlet will use data of this backup to create a backup chain instead of creating the chain anew.</p><p>Accepts the <code>VBREntraIDTenantBackup</code> object. To get this object, run the <a href="get-vbrentraidtenantbackup.md"><code>Get-VBREntraIDTenantBackup</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrentraidtenantbackup.md"><code>VBREntraIDTenantBackup</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 [`VBREntraIDTenantBackupJob`](vbrentraidtenantbackupjob.md) object that contains setting of the created tenant backup job.

## Examples

::: example
### Changing Settings of Entra ID Backup Job

This example shows how to change the settings of the `Tenant Backup` backup job and disable encryption.

```
$backupJob = Get-VBREntraIDTenantBackupJob -Name "Tenant Backup"
$encOptions = New-VBREncryptionOptions -EnableEncryption:$false
Set-VBREntraIDTenantBackupJob -Job $backupJob -Description "Backup of Entra ID tenant" -RetentionPolicy 12 -EncryptionOptions $encOptions
```

Perform the following steps:

1. Run the [`Get-VBREntraIDTenantBackupJob`](get-vbrentraidtenantbackupjob.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$backupJob` variable.
2. Run the [`New-VBREncryptionOptions`](new-vbrencryptionoptions.md) cmdlet. Set the `EnableEncryption` parameter value to `$false`. Save the result to the `$encOptions` variable.
3. Run the `Set-VBREntraIDTenantBackupJob` cmdlet. Specify the following:

   - Set the `$backupJob` variable as the `Job` parameter value.
   - Specify the `Description` and `RetentionPolicy` parameter values.
   - Set the `$encOptions` variable as the `EncryptionOptions` parameter value.

:::

## Related Commands

- [`Get-VBREntraIDTenantBackupJob`](get-vbrentraidtenantbackupjob.md)
- [`New-VBREncryptionOptions`](new-vbrencryptionoptions.md)
- [`New-VBREntraIDBackupSecondaryTarget`](new-vbrentraidbackupsecondarytarget.md)