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

# Set-VBRBackupToTapeJob

## Short Description
Modifies a backup to tape job or a GFS 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-VBRBackupToTapeJob -Job <VBRBackupToTapeJob> [-Name <String>] [-Description <String>] [-EjectCurrentMedium]
 [-ExportCurrentMediaSet] [-ExportDays <DayOfWeek[]>] [-FullBackupPolicy <VBRFullBackupToTapePolicy>]
 [-ScheduleOptions <VBRBackupToTapeScheduleOptions>] [-Object <Object[]>] [-ProcessIncrementalBackup]
 [-UseHardwareCompression] [-WaitPeriod <TimeSpan>] [-WaitForBackupJob]
 [-NotificationOptions <VBRNotificationOptions>] [-JobScriptOptions <VBRJobScriptOptions>]
 [-AlwaysCopyFromLatestFull] [-PassThru] [-Force] [-EnableParallelDrivesUsage] [-LimitTapeDrives <Int32>]
 [-PreventInterruption] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>SimpleMediaPool</code></p>

```
Set-VBRBackupToTapeJob -Job <VBRBackupToTapeJob> [-Name <String>] [-Description <String>] [-EjectCurrentMedium]
 [-ExportCurrentMediaSet] [-FullBackupMediaPool <VBRTapeMediaPool>]
 [-IncrementalBackupMediaPool <VBRTapeMediaPoolBase>] [-ExportDays <DayOfWeek[]>]
 [-FullBackupPolicy <VBRFullBackupToTapePolicy>] [-ScheduleOptions <VBRBackupToTapeScheduleOptions>]
 [-Object <Object[]>] [-ProcessIncrementalBackup] [-UseHardwareCompression] [-WaitPeriod <TimeSpan>]
 [-WaitForBackupJob] [-NotificationOptions <VBRNotificationOptions>] [-JobScriptOptions <VBRJobScriptOptions>]
 [-AlwaysCopyFromLatestFull] [-PassThru] [-Force] [-EnableParallelDrivesUsage] [-LimitTapeDrives <Int32>]
 [-PreventInterruption] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>GFSMediaPool</code></p>

```
Set-VBRBackupToTapeJob -Job <VBRBackupToTapeJob> [-Name <String>] [-Description <String>] [-EjectCurrentMedium]
 [-ExportCurrentMediaSet] [-GFSMediaPool <VBRTapeGFSMediaPool>] [-ExportDays <DayOfWeek[]>]
 [-FullBackupPolicy <VBRFullBackupToTapePolicy>] [-ScheduleOptions <VBRBackupToTapeScheduleOptions>]
 [-Object <Object[]>] [-ProcessIncrementalBackup] [-UseHardwareCompression] [-WaitPeriod <TimeSpan>]
 [-WaitForBackupJob] [-NotificationOptions <VBRNotificationOptions>] [-JobScriptOptions <VBRJobScriptOptions>]
 [-AlwaysCopyFromLatestFull] [-GFSScheduleOptions <VBRTapeGFSScheduleOptions>] [-PassThru] [-Force]
 [-EnableParallelDrivesUsage] [-LimitTapeDrives <Int32>] [-PreventInterruption] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet modifies a selected backup to tape job or a GFS job.

::: note

Consider the following:

- To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameters values with new values. The parameters that you omit will remain unchanged.
- The cmdlet checks if the data of the VMs added to the job changes its geographic location.
- The cmdlet will not run if the geographic location of the repository where VM backups reside and the target media pool location do not match. If you still want to run the cmdlet, use the `Force` parameter.

:::

## 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">AlwaysCopyFromLatestFull</span></p>
        </td>
        <td>
          <p>Defines that on each run the tape job must copy only the latest backup chain. Otherwise, on each run the tape job will copy all restore points produced by the source backup jobs that are available on disk.</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">Description</span></p>
        </td>
        <td>
          <p>Specifies the description of the backup 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">EnableParallelDrivesUsage</span></p>
        </td>
        <td>
          <p>Enables parallel processing of media pools.</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>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, Tuesday, Wednesday, Thursday, Friday, Saturday, 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">Force</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will create a job even if the geographic location of the repositories where VM backups reside and the target media pool location do not match.</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">FullBackupMediaPool</span></p>
        </td>
        <td>
          <p>For non-GFS 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 virtualized synthetic full backup for tape settings.</p><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="vbrfullbackuptotapepolicy.md"><code>VBRFullBackupToTapePolicy</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 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">GFSScheduleOptions</span></p>
        </td>
        <td>
          <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 jobs.</p><p>Used to set media pool for the <code>ProcessIncrementalBackup</code> parameter.</p><p>Specifies the media pool where you want to store incremental backups produced by this tape job.</p><p>Accepts the <a href="vbrtapemediapoolbase.md"><code>VBRTapeMediaPoolBase</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="vbrtapemediapoolbase.md"><code>VBRTapeMediaPoolBase</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 backup 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><a href="vbrbackuptotapejob.md"><code>VBRBackupToTapeJob</code></a>. To get this object, run the <a href="get-vbrtapejob.md"><code>Get-VBRTapeJob</code></a> cmdlet.</li><li><code>TapeJob</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="vbrbackuptotapejob.md"><code>VBRBackupToTapeJob</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 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">LimitTapeDrives</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will limit the number of drives to use for processing this tape job.</p><p>Default: 2 drives.</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">Name</span></p>
        </td>
        <td>
          <p>Specifies the name you want to assign to the backup 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 backup to tape job sources. Tape job sources are backup jobs or backup repositories.</p><p>Accepts either of the following types:</p><ul><li><a href="vbrcloudtenant.md"><code>VBRCloudTenant</code></a>. To get this object, run the <a href="get-vbrcloudtenant.md"><code>Get-VBRCloudTenant</code></a> cmdlet.</li><li><code>CBackupJob</code>. To get this object, run the <a href="get-vbrjob.md"><code>Get-VBRJob</code></a> cmdlet.</li><li><a href="vbrepjob.md"><code>VBREPJob</code></a>. To get this object, run the <a href="get-vbrepjob.md"><code>Get-VBREPJob</code></a> cmdlet.</li><li><code>CBackupRepository</code>. To get this object, run the <a href="get-vbrbackuprepository.md"><code>Get-VBRBackupRepository</code></a> cmdlet.</li><li><a href="vbrcloudtenantresource.md"><code>VBRCloudTenantResource</code></a>. To create this object, run the <a href="new-vbrcloudtenantresource.md"><code>New-VBRCloudTenantResource</code></a> cmdlet.</li></ul>
        </td>
        <td style="width:10%;">
          <p><code>Object[]</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">PassThru</span></p>
        </td>
        <td>
          <p>Defines that the command returns the output object to the Windows 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">PreventInterruption</span></p>
        </td>
        <td>
          <p>Defines that, if the source job starts while the tape job is still running, the source job will be placed on hold instead of interrupting the tape job and resulting in incomplete tape backups.</p><p>Using this option may result in source backup jobs starting significantly later than their scheduled start time, thus potentially missing recovery point objectives.</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">ProcessIncrementalBackup</span></p>
        </td>
        <td>
          <p>Defines that this tape job will archive incremental backups.</p><p>Use the <code>IncrementalBackupMediaPool</code> parameter to specify a separate media pool for storing incremental backups. If you do not set the <code>IncrementalBackupMediaPool</code> parameter, incremental backups will be stored to the media pool you set for full backups.</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">ScheduleOptions</span></p>
        </td>
        <td>
          <p>Specifies backup to tape job schedule.</p><p>Default:</p><ul><li><code>Enabled: False</code></li><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>ScheduleOptions: From Sunday to Saturday, from 00:00 to 23:00, Enabled: True</code></li><li><code>JobId: Null</code></li></ul><p>Accepts the <a href="vbrbackuptotapescheduleoptions.md"><code>VBRBackupToTapeScheduleOptions</code></a> object. To create this object, run the <a href="new-vbrbackuptotapescheduleoptions.md"><code>New-VBRBackupToTapeScheduleOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrbackuptotapescheduleoptions.md"><code>VBRBackupToTapeScheduleOptions</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">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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">WaitForBackupJob</span></p>
        </td>
        <td>
          <p>Defines that the tape job must wait for the source backup job to finish. Use the <code>WaitPeriod</code> parameter to set the time period.</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">WaitPeriod</span></p>
        </td>
        <td>
          <p>Used to set time period for the <code>WaitForBackupJob</code> parameter.</p><p>Specifies the time period for which the tape job must wait for the source backup jobs to finish.</p><p>Allowed values: <code>1-777</code> minutes.</p><p>Accepts <code>TimeSpan</code>, int or string.</p>
        </td>
        <td style="width:10%;">
          <p><code>TimeSpan</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
[`VBRBackupToTapeJob`](vbrbackuptotapejob.md)

## Examples

::: example
### Changing Media Pool for Backup to Tape Job  [Using Pipeline]

This example shows how to set a new media pool for the incremental backups.

```
$newpool = Get-VBRTapeMediaPool -Name "Incremental Backups"
Get-VBRTapeJob -Name "Daily WebApp Backup" | Set-VBRBackupToTapeJob -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. Pipe the cmdlet output to the `Set-VBRBackupToTapeJob` cmdlet. Set the `$newpool` variable as the `IncrementalBackupMediaPool` parameter value.

:::

## Related Commands

- [`Get-VBRJob`](get-vbrjob.md)
- [`Get-VBREPJob`](get-vbrepjob.md)
- [`Get-VBRBackupRepository`](get-vbrbackuprepository.md)
- [`Get-VBRTapeMediaPool`](get-vbrtapemediapool.md)
- [`New-VBRFullBackupToTapePolicy`](new-vbrfullbackuptotapepolicy.md)
- [`New-VBRBackupToTapeScheduleOptions`](new-vbrbackuptotapescheduleoptions.md)
- [`New-VBRNotificationOptions`](new-vbrnotificationoptions.md)
- [`New-VBRJobScriptOptions`](new-vbrjobscriptoptions.md)
- [`Get-VBRLocation`](get-vbrlocation.md)