---
title: "Add-VBRObjectStorageBackupJob"
description: "This cmdlet creates object storage backup job."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/add-vbrobjectstoragebackupjob.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Unstructured Data Backup > Working with Unstructured Data Source Jobs > Adding Object Storage Backup Jobs > Add-VBRObjectStorageBackupJob"
dateModified: "2026-08-19"
---

# Add-VBRObjectStorageBackupJob

## Short Description
Creates object storage backup job.

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

## Syntax
```
Add-VBRObjectStorageBackupJob -BackupObject <VBRObjectStorageBackupJobObject[]> [-SkipTagTracking]
 [-Name <String>] [-Description <String>] -ShortTermBackupRepository <CBackupRepository>
 [-ShortTermRetentionType <VBRUnstructuredBackupShortTermRetentionType>] [-ShortTermRetentionPeriod <Int32>]
 [-LongTermRetentionType <VBRUnstructuredBackupLongTermRetentionType>]
 [-LongTermBackupRepository <IRepository>] [-LongTermRetentionPeriod <Int32>]
 [-LongTermArchivalOptions <VBRUnstructuredBackupArchivalOptions>] [-EnableLongTermRetention] [-EnableCopyMode]
 [-SecondaryTarget <VBRUnstructuredBackupSecondaryTarget[]>]
 [-VersionRetentionOptions <VBRUnstructuredBackupVersionRetentionOptions>]
 [-StorageOptions <VBRStorageOptions>] [-HealthCheckOptions <VBRFullBackupOptions>]
 [-NotificationOptions <VBRNotificationOptions>] [-ScriptOptions <VBRJobScriptOptions>]
 [-ScheduleOptions <VBRServerScheduleOptions>] [-Force] [-HighPriority] [-TargetBackup <VBRUnstructuredBackup>] [<CommonParameters>]
```

## Detailed Description
This cmdlet creates object storage 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">BackupObject</span></p>
        </td>
        <td>
          <p>Specifies an array of objects. The cmdlet will add these objects to the object storage backup job.</p><p>Accepts the <code>VBRObjectStorageBackupJobObject[]</code> object. To define this object, run the <a href="new-vbrobjectstoragebackupjobobject.md"><code>New-VBRObjectStorageBackupJobObject</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRObjectStorageBackupJobObject[]</code></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>
      <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 the object storage backup job. The cmdlet will create the the object storage backup 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">EnableCopyMode</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will keep the copy of the data stored in the backup repository in the long-term archive 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">EnableLongTermRetention</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will keep objects on long-term archive 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">Force</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will add a file backup without showing warnings or errors 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">HealthCheckOptions</span></p>
        </td>
        <td>
          <p>Specifies the healthcheck schedule. The cmdlet will create the object storage backup with this healthcheck schedule.</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>VBRFullBackupOptions</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">HighPriority</span></p>
        </td>
        <td>
          <p>Defines that Veeam Backup & Replication will prioritize this job higher than other similar jobs and will allocate resources to it in the first place.</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">LongTermArchivalOptions</span></p>
        </td>
        <td>
          <p>Specifies the retention policy for data versions that are located on the long-term archive repository. The cmdlet will create object storage backup jobs with the specified retention policy.</p><p>Accepts the <code>VBRUnstructuredBackupArchivalOptions</code> object. To create this object, run the <a href="new-vbrunstructuredbackuparchivaloptions.md"><code>New-VBRUnstructuredBackupArchivalOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRUnstructuredBackupArchivalOptions</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">LongTermBackupRepository</span></p>
        </td>
        <td>
          <p>Specifies the archive repository. The cmdlet will add this repository as the long-term archive storage.</p><p>Accepts the <code>IRepository</code> object. To get this object, run the following cmdlets:</p><ul><li><a href="get-vbrbackuprepository.md"><code>Get-VBRBackupRepository</code></a>: use this cmdlet to get backup repositories.</li><li><a href="get-vbrobjectstoragerepository.md"><code>Get-VBRObjectStorageRepository</code></a>: use this cmdlet to get object storage repositories.</li></ul>
        </td>
        <td style="width:10%;">
          <p><code>IRepository</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">LongTermRetentionPeriod</span></p>
        </td>
        <td>
          <p>For the <code>LongTermRetentionType</code> option.</p><p>Specifies the period of time to keep data on the long-term archive repository. When this period is passed, Veeam Backup & Replication will delete this data from the archive repository.</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">LongTermRetentionType</span></p>
        </td>
        <td>
          <p>Specifies a retention policy for the long-term archive repository. You can set the retention policy to either of the following periods:</p><ul><li><code>Monthly:</code> use this option if you want Veeam Backup & Replication to apply retention policy monthly.</li><li><code>Yearly</code>: use this option if you want Veeam Backup & Replication to apply retention policy yearly.</li></ul><p>Use the <code>LongTermRetentionPeriod</code> to specify the number of months or years.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRUnstructuredBackupLongTermRetentionType</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 the object storage backup job. The cmdlet will create the object storage backup 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 options. The cmdlet will create the object storage backup job with these notification options.</p><p>Accepts the <code>VBRNotificationOptions</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><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">ScheduleOptions</span></p>
        </td>
        <td>
          <p>Specifies schedule options. The cmdlet will create the object storage backup job with these schedule options.</p><p>Accepts the <code>VBRJobScriptOptions</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>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. The cmdlet will create the object storage backup 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">SecondaryTarget</span></p>
        </td>
        <td>
          <p>Specifies the backup repository. The cmdlet will add this repository as the secondary repository to the object storage backup job.</p><p>Accepts the <code>VBRUnstructuredBackupSecondaryTarget[]</code> object. To create this object, run the <a href="new-vbrunstructuredbackupsecondarytarget.md"><code>New-VBRUnstructuredBackupSecondaryTarget</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRUnstructuredBackupSecondaryTarget[]</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">ShortTermBackupRepository</span></p>
        </td>
        <td>
          <p>Specifies the backup repository. The cmdlet will add this repository as the short-term backup storage.</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>True</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">ShortTermRetentionPeriod</span></p>
        </td>
        <td>
          <p>For the <code>ShortTermRetentionType</code> option.</p><p>Specifies the period of time to keep data on the short-term backup repository. When this period is passed, Veeam Backup & Replication will move data to the long-term archive repository.</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">ShortTermRetentionType</span></p>
        </td>
        <td>
          <p>Specifies a retention policy for the short-term backup repository. You can set the retention policy to either of the following periods:</p><ul><li><code>Daily:</code> use this option if you want Veeam Backup & Replication to apply retention policy daily.</li><li><code>Monthly:</code> use this option if you want Veeam Backup & Replication to apply retention policy monthly.</li></ul><p>Use the <code>ShortTermRetentionPeriod</code> to specify the number of days or months.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRUnstructuredBackupShortTermRetentionType</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">SkipTagTracking</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will enable tag tracking for an object storage backup job. If you provide this parameter, the cmdlet will skip tracking of tags for incremental backups in case the objects content is not changed when the job runs.</p><p><strong>Note</strong>: The cmdlet skips this parameter if you define tag masks settings with the <a href="new-vbrobjectstoragebackuptagmask.md"><code>New-VBRObjectStorageBackupTagMask</code></a> cmdlet.</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">StorageOptions</span></p>
        </td>
        <td>
          <p>Specifies storage optimization settings. The cmdlet will create the object storage backup with these settings.</p><p>Accepts the <code>VBRStorageOptions</code> object. To create this object, run the <a href="new-vbrstorageoptions.md"><code>New-VBRStorageOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRStorageOptions</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">TargetBackup</span></p>
        </td>
        <td>
          <p>For backup job mapping.</p><p>Specifies a backup chain that you want to map to a job.</p><p>Accepts the <code>VBRUnstructuredBackup</code> object. To create this object, run the <a href="get-vbrunstructuredbackup.md"><code>Get-VBRUnstructuredBackup</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrunstructuredbackup.md"><code>VBRUnstructuredBackup</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">VersionRetentionOptions</span></p>
        </td>
        <td>
          <p>Specifies the settings of version-based retention for backup and archive repositories. The cmdlet will apply these settings to the object storage backup job.</p><p>Accepts the <code>VBRUnstructuredBackupVersionRetentionOptions</code> object. To create this object, run the <a href="new-vbrunstructuredbackupversionretentionoptions.md"><code>New-VBRUnstructuredBackupVersionRetentionOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRUnstructuredBackupVersionRetentionOptions</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 `VBRObjectStorageBackupJob` object that contains settings of object storage backup job.

## Examples

::: example
### Adding Object Storage Backup Job

This example shows how add the `Azure OS Job` object storage backup job.

```
$server = Get-VBRUnstructuredServer -Name "Azure 01"
$object = New-VBRObjectStorageBackupJobObject -Server $serv -Container "Monthly Backups" -Path "Reports"
$repository = Get-VBRBackupRepository -Name "WinSrv2017"
Add-VBRObjectStorageBackupJob -BackupObject $object -Name "Azure OS Job" -ShortTermBackupRepository $repository
```

Perform the following steps:

1. Run the [`Get-VBRUnstructuredServer`](get-vbrunstructuredserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$server` variable.
2. Run the [`New-VBRObjectStorageBackupJobObject`](new-vbrobjectstoragebackupjobobject.md) cmdlet. Specify the `Server`, `Container`, `Day` and `Path` parameter values. Save the result to the `$object` variable.
3. Run the [`Get-VBRBackupRepository`](get-vbrbackuprepository.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$repository` variable.
4. Run the `Add-VBRObjectStorageBackupJob` cmdlet. Set the `$object` variable as the `BackupObject` parameter value. Specify the `Name` parameter value. Set the `$repository` variable as the `ShortTermBackupRepository` parameter value.

:::

## Related Commands

- [`Get-VBRUnstructuredServer`](get-vbrunstructuredserver.md)
- [`New-VBRObjectStorageBackupJobObject`](new-vbrobjectstoragebackupjobobject.md)
- [`Get-VBRBackupRepository`](get-vbrbackuprepository.md)