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

# Add-VBREntraIDTenantBackupJob

## Short Description
Creates a Microsoft Entra ID tenant backup job.

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

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

## Detailed Description
This cmdlet creates a backup job that protects a Microsoft Entra ID tenant.

## 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">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">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 tenant 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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Tenant</span></p>
        </td>
        <td>
          <p>Specifies the tenant whose data you want to back up.</p><p>Accepts the <code>VBREntraIDTenant</code> object. To get this object, run the <a href="get-vbrentraidtenant.md"><code>Get-VBREntraIDTenant</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrentraidtenant.md"><code>VBREntraIDTenant</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>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
### Creating Entra ID Tenant Backup Job

This example shows how to add a tenant backup job with scheduling options and enabled encryption.

```
$tenant = Get-VBREntraIdTenant -AzureTenantId "xxxx"
$daily = New-VBRDailyOptions -DayOfWeek Friday -Period 7:00
$scheduleOptions = New-VBRServerScheduleOptions -Type Daily -DailyOptions $daily
$encKey = Get-VBREncryptionKey -Description "For Entra ID encryption"
$encOptions = New-VBREncryptionOptions -EnableEncryption -EncryptionKey $encKey
$backupJob = Add-VBREntraIDTenantBackupJob -Name "Tenant Backup" -Tenant $tenant -EnableSchedule -ScheduleOptions $scheduleOptions -EncryptionOptions $encOptions
```

Perform the following steps:

1. Run the [`Get-VBREntraIdTenant`](get-vbrentraidtenant.md) cmdlet. Specify the `AzureTenantId` parameter value. Save the result to the `$tenant` variable.
2. Run the [`New-VBRDailyOptions`](new-vbrdailyoptions.md) cmdlet. Specify the `DayOfWeek` and `Period` parameter values. Save the result to the `$daily` variable.
3. Run the [`New-VBRServerScheduleOptions`](new-vbrserverscheduleoptions.md) cmdlet. Set the `Daily` value as the `Type` parameter value. Set the `$daily` variable as the `DailyOptions` parameter value. Save the result to the `$scheduleOptions` variable.
4. Run the [`Get-VBREncryptionKey`](get-vbrencryptionkey.md) cmdlet. Specify the `Description` parameter value. Save the result to the `$encKey` variable.
5. Run the [`New-VBREncryptionOptions`](new-vbrencryptionoptions.md) cmdlet. Specify the `EnableEncryption` parameter. Set the `$encKey` variable as the `EncryptionKey` parameter value. Save the result to the `$encOptions` variable.
6. Run the `Add-VBREntraIDTenantBackupJob` cmdlet. Specify the following settings:

   - Specify the `Name` parameter value.
   - Set the `$tenant` variable as the `Tenant` parameter value.
   - Provide the `EnableSchedule` parameter.
   - Set the `$scheduleOptions` variable as the `ScheduleOptions` parameter value.
   - Set the `$encOptions` variable as the `EncryptionOptions` parameter value.
   - Save the result to the `$backupJob` variable.

:::

## Related Commands

- [`Get-VBREntraIdTenant`](get-vbrentraidtenant.md)
- [`New-VBRDailyOptions`](new-vbrdailyoptions.md)
- [`New-VBRServerScheduleOptions`](new-vbrserverscheduleoptions.md)
- [`Get-VBREncryptionKey`](get-vbrencryptionkey.md)
- [`New-VBREncryptionOptions`](new-vbrencryptionoptions.md)
- [`New-VBREntraIDBackupSecondaryTarget`](new-vbrentraidbackupsecondarytarget.md)