---
title: "Set-VBRObjectToTapeJob"
description: "Modifies an object to tape job or GFS object to tape job. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet provides the following parameter sets: AllParameterSets (Default) SimpleMediaPool GFSMediaPool This "
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/set-vbrobjecttotapejob.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Tape Devices > Tape Jobs > Set-VBRObjectToTapeJob"
dateModified: "2026-08-19"
---

# Set-VBRObjectToTapeJob

## Short Description
Modifies an object to tape job or GFS object to tape job.

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

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>AllParameterSets (Default)</code></p>

```
Set-VBRObjectToTapeJob -Job <VBRObjectToTapeJob> [-Name <String>] [-Description <String>] [-EjectCurrentMedium]
 [-ExportCurrentMediaSet] [-FullBackupPolicy <VBRFileToTapeBackupPolicy>]
 [-IncrementalBackupPolicy <VBRFileToTapeBackupPolicy>] [-Object <VBRObjectStorageBackupJobObject[]>]
 [-UseHardwareCompression] [-NotificationOptions <VBRNotificationOptions>]
 [-JobScriptOptions <VBRJobScriptOptions>] [-EnableFileAclChangeTracking] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>SimpleMediaPool</code></p>

```
Set-VBRObjectToTapeJob -Job <VBRObjectToTapeJob> [-Name <String>] [-Description <String>] [-EjectCurrentMedium]
 [-ExportCurrentMediaSet] [-FullBackupMediaPool <VBRTapeMediaPool>]
 [-IncrementalBackupMediaPool <VBRTapeMediaPool>] [-ExportDays <DayOfWeek[]>]
 [-FullBackupPolicy <VBRFileToTapeBackupPolicy>] [-IncrementalBackupPolicy <VBRFileToTapeBackupPolicy>]
 [-Object <VBRObjectStorageBackupJobObject[]>] [-UseHardwareCompression]
 [-NotificationOptions <VBRNotificationOptions>] [-JobScriptOptions <VBRJobScriptOptions>]
 [-EnableFileAclChangeTracking] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>GFSMediaPool</code></p>

```
Set-VBRObjectToTapeJob -Job <VBRObjectToTapeJob> [-Name <String>] [-Description <String>] [-EjectCurrentMedium]
 [-ExportCurrentMediaSet] [-GFSMediaPool <VBRTapeGFSMediaPool>]
 [-GFSMediaSetsToExport <VBRGFSMediaSetTypeToExport[]>] [-FullBackupPolicy <VBRFileToTapeBackupPolicy>]
 [-IncrementalBackupPolicy <VBRFileToTapeBackupPolicy>] [-Object <VBRObjectStorageBackupJobObject[]>]
 [-UseHardwareCompression] [-GFSScheduleOptions <VBRTapeGFSScheduleOptions>]
 [-NotificationOptions <VBRNotificationOptions>] [-JobScriptOptions <VBRJobScriptOptions>]
 [-EnableFileAclChangeTracking] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet modifies a selected object to tape job or GFS object to tape job that was created before.

::: note

To modify settings, specify new values for the necessary parameters. This cmdlet will overwrite the previous parameter values with the 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">Description</span></p>
        </td>
        <td>
          <p>Specifies the description of the object to tape 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">EjectCurrentMedium</span></p>
        </td>
        <td>
          <p>Defines that the tapes will be automatically ejected from drive after the job finishes.</p><p>The ejected tape is moved to a standard library slot.</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">EnableFileAclChangeTracking</span></p>
        </td>
        <td>
          <p>Enables backup of permissions and attributes for files.</p><p>Default: <code>False</code>.</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">ExportCurrentMediaSet</span></p>
        </td>
        <td>
          <p>For non-GFS object to tape jobs.</p><p>Defines that the tapes belonging to the media set will be automatically placed to Import/Export (Mail) slot for further export. Use the <code>ExportDays</code> parameter to set days on which you want to export tapes.</p><p>If you use this parameter, but do not set the <code>ExportDays</code> parameter, the tapes will be exported every day.</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">ExportDays</span></p>
        </td>
        <td>
          <p>Used to set days for exporting tapes for the <code>ExportCurrentMediaSet</code> parameter.</p><p>Specifies days on which the tapes written by this tape job will be automatically exported: <code>Monday</code>, <code>Tuesday</code>, <code>Wednesday</code>, <code>Thursday</code>, <code>Friday</code>, <code>Saturday</code>, <code>Sunday</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>DayOfWeek[]</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">FullBackupMediaPool</span></p>
        </td>
        <td>
          <p>For non-GFS object to tape jobs.</p><p>Specifies the media pool where you want to store full backups produced by this tape job.</p><p>Accepts the <a href="vbrtapemediapool.md"><code>VBRTapeMediaPool</code></a> object, GUID or string. To get this object, run the <a href="get-vbrtapemediapool.md"><code>Get-VBRTapeMediaPool</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrtapemediapool.md"><code>VBRTapeMediaPool</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">FullBackupPolicy</span></p>
        </td>
        <td>
          <p>Specifies virtual synthetic full backup for tape settings.</p><p>Default:</p><ul><li><code>Type: Daily</code></li><li><code>DailyOptions: Type: SelectedDays, Period: 18:00, DayOfWeek: Saturday</code></li><li><code>MonthlyOptions: Period: 22:00, DayNumberInMonth: Fourth, DayOfWeek: Saturday, Months: January, February, March, April, May, June, July, August, September, October, November, December</code></li><li><code>Enabled: False</code></li></ul><p>Accepts the <a href="vbrfullbackuptotapepolicy.md"><code>VBRFullBackupToTapePolicy</code></a> object. To create this object, run the <a href="new-vbrfullbackuptotapepolicy.md"><code>New-VBRFullBackupToTapePolicy</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrfiletotapebackuppolicy.md"><code>VBRFileToTapeBackupPolicy</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">GFSMediaPool</span></p>
        </td>
        <td>
          <p>For GFS object to tape jobs.</p><p>Specifies the target GFS media pool.</p><p>Accepts the <a href="vbrtapegfsmediapool.md"><code>VBRTapeGFSMediaPool</code></a> object, GUID or string. To get this object, run the <a href="get-vbrtapemediapool.md"><code>Get-VBRTapeMediaPool</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrtapegfsmediapool.md"><code>VBRTapeGFSMediaPool</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">GFSMediaSetsToExport</span></p>
        </td>
        <td>
          <p>For GFS object to tape jobs.</p><p>Specifies GFS media sets for which the tapes will be automatically exported once the tape job is finished:</p><ul><li><code>Daily</code></li><li><code>Weekly</code></li><li><code>Monthly</code></li><li><code>Quarterly</code></li><li><code>Yearly</code></li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRGFSMediaSetTypeToExport[]</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">GFSScheduleOptions</span></p>
        </td>
        <td>
          <p>For GFS object to tape jobs.</p><p>Specifies the schedule settings for the GFS media pool.</p><p>Accepts the <a href="vbrtapegfsscheduleoptions.md"><code>VBRTapeGFSScheduleOptions</code></a> object. To create this object, run the <a href="new-vbrtapegfsscheduleoptions.md"><code>New-VBRTapeGFSScheduleOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrtapegfsscheduleoptions.md"><code>VBRTapeGFSScheduleOptions</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">IncrementalBackupMediaPool</span></p>
        </td>
        <td>
          <p>For non-GFS object to tape jobs.</p><p>Specifies the media pool where you want to store incremental backups produced by this tape job.</p><p>Accepts the <a href="vbrtapemediapool.md"><code>VBRTapeMediaPool</code></a> object, GUID or string. To get this object, run the <a href="get-vbrtapemediapool.md"><code>Get-VBRTapeMediaPool</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrtapemediapool.md"><code>VBRTapeMediaPool</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">IncrementalBackupPolicy</span></p>
        </td>
        <td>
          <p>Specifies the incremental backup settings.</p><p>Default:</p><ul><li><code>Type: Daily</code></li><li><code>DailyOptions: Type: SelectedDays, Period: 18:00, DayOfWeek: Saturday</code></li><li><code>MonthlyOptions: Period: 22:00, DayNumberInMonth: Fourth, DayOfWeek: Saturday, Months: January, February, March, April, May, June, July, August, September, October, November, December</code></li><li><code>Enabled: False</code></li></ul><p>Accepts the <a href="vbrfiletotapebackuppolicy.md"><code>VBRFileToTapeBackupPolicy</code></a> object. To create this object, run the <a href="new-vbrfiletotapebackuppolicy.md"><code>New-VBRFileToTapeBackupPolicy</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrfiletotapebackuppolicy.md"><code>VBRFileToTapeBackupPolicy</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 object to tape job to which you want to apply new settings.</p><p>Accepts the following objects:</p><ul><li>GUID</li><li>String</li><li><code>VBRObjectToTapeJob</code>. To get this object, run the <a href="get-vbrtapejob.md"><code>Get-VBRTapeJob</code></a> cmdlet.</li></ul>
        </td>
        <td style="width:10%;">
          <p><a href="vbrobjecttotapejob.md"><code>VBRObjectToTapeJob</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">JobScriptOptions</span></p>
        </td>
        <td>
          <p>Specifies the scripting options.</p><p>Accepts the <a href="vbrjobscriptoptions.md"><code>VBRJobScriptOptions</code></a> 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">Name</span></p>
        </td>
        <td>
          <p>Specifies the name you want to assign to the object to tape 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 the email notification options.</p><p>Accepts the <a href="vbrnotificationoptions.md"><code>VBRNotificationOptions</code></a> 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">Object</span></p>
        </td>
        <td>
          <p>Specifies the array of object to tape job sources.</p><p>Accepts the <code>VBRObjectStorageBackupJobObject[]</code> object, GUID or string. To create 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>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">UseHardwareCompression</span></p>
        </td>
        <td>
          <p>Defines that tape library must perform hardware compression for archives. Do not use this option for archiving Veeam backups or other already compressed files.</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>
    </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
[`VBRObjectToTapeJob`](vbrobjecttotapejob.md)

## Examples

::: example
### Modifying Object to Tape Job [Using Pipeline]

This example shows how to set a new media pool for the incremental backups for the `Sydney Container to Tape` job.

```
$newpool = Get-VBRTapeMediaPool -Name "Azure Blob Storage Backups"
Get-VBRTapeJob -Name "Sydney Container to Tape" | Set-VBRObjectToTapeJob -IncrementalBackupMediaPool $newpool
```

Perform the following steps:

1. Run the [`Get-VBRTapeMediaPool`](get-vbrtapemediapool.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$newpool` variable.
2. Run the [`Get-VBRTapeJob`](get-vbrtapejob.md) cmdlet. Specify the `Name` parameter value.
3. Pipe the cmdlet output to the `Set-VBRObjectToTapeJob` cmdlet. Set the `$newpool` variable as the `IncrementalBackupMediaPool` parameter value.

:::

## Related Commands

- [`Get-VBRTapeJob`](get-vbrtapejob.md)
- [`Get-VBRUnstructuredServer`](get-vbrunstructuredserver.md)
- [`New-VBRObjectStorageBackupJobObject`](new-vbrobjectstoragebackupjobobject.md)
- [`Get-VBRTapeMediaPool`](get-vbrtapemediapool.md)
- [`New-VBRFileToTapeBackupPolicy`](new-vbrfiletotapebackuppolicy.md)
- [`New-VBRNotificationOptions`](new-vbrnotificationoptions.md)
- [`New-VBRJobScriptOptions`](new-vbrjobscriptoptions.md)
- [`New-VBRTapeGFSScheduleOptions`](new-vbrtapegfsscheduleoptions.md)