--- title: "Add-VBRBackupToTapeJob" description: "Creates a backup to tape job or a GFS job. Product Edition: Enterprise, Enterprise Plus, Veeam Universal License This cmdlet provides the following parameter sets: SimpleMediaPool GFSMediaPool This cmdlet creates a new backup to tape job or a GFS job" canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/add-vbrbackuptotapejob.html" breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Tape Devices > Tape Jobs > Add-VBRBackupToTapeJob" dateModified: "2026-08-19" --- # Add-VBRBackupToTapeJob ## Short Description Creates a backup to tape job or a GFS job. **Product Edition**: Enterprise, Enterprise Plus, Veeam Universal License ## Syntax This cmdlet provides the following parameter sets:
SimpleMediaPool
GFSMediaPool
|
Parameter |
Description |
Type |
Required |
Position |
Accept Pipeline Input |
|---|---|---|---|---|---|
|
AlwaysCopyFromLatestFull |
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. |
|
False |
Named |
False |
|
CopyFromLatestFull |
Defines that on the first run the tape job must copy only the latest backup chain. Otherwise,on the first run the job will copy all restore points produced by the source backup jobs that are available on disk. |
|
False |
Named |
False |
|
Description |
Specifies the description of the backup to tape job. |
|
False |
Named |
False |
|
EjectCurrentMedium |
Defines that the tapes will be automatically ejected from drive after the job finishes. The ejected tape is moved to a standard library slot. |
|
False |
Named |
False |
|
EnableParallelDrivesUsage |
Enables parallel processing of media pools. Default: |
|
False |
Named |
False |
|
ExportCurrentMediaSet |
Defines that the tapes belonging to the media set will be automatically placed to Import/Export (Mail) slot for further export. Use the If you use this parameter, but do not set the |
|
False |
Named |
False |
|
ExportDays |
Used to set days for exporting tapes for the Specifies days on which the tapes written by this tape job will be automatically exported: |
|
False |
Named |
False |
|
Force |
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. |
|
False |
Named |
False |
|
FullBackupMediaPool |
For non-GFS jobs. Specifies the media pool where you want to store full backups produced by this tape job. Accepts the |
True |
Named |
False |
|
|
FullBackupPolicy |
Specifies virtual full settings. Accepts the |
False |
Named |
False |
|
|
GFSMediaPool |
For GFS jobs. Specifies the target GFS media pool. Accepts the |
True |
Named |
False |
|
|
GFSScheduleOptions |
Specifies the schedule settings for the GFS media pool. Accepts the |
False |
Named |
False |
|
|
IncrementalBackupMediaPool |
For non-GFS jobs. Used to set media pool for the Specifies the media pool where you want to store incremental backups produced by this tape job. Accepts the |
False |
Named |
False |
|
|
JobScriptOptions |
Specifies scripting options. Accepts the |
False |
Named |
False |
|
|
LimitTapeDrives |
Defines that the cmdlet will limit the number of drives to use for processing this tape job. Default: 2 drives. |
|
False |
Named |
False |
|
Name |
Specifies the name you want to assign to the backup to tape job. |
|
True |
Named |
False |
|
NotificationOptions |
Specifies the email notification options. Accepts the |
False |
Named |
False |
|
|
Object |
Specifies the array of backup jobs or backup repositories that will be the source for this tape job. Accepts one of the following objects:
|
|
False |
Named |
False |
|
PreventInterruption |
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. Using this option may result in source backup jobs starting significantly later than their scheduled start time, thus potentially missing recovery point objectives. |
|
False |
Named |
False |
|
ProcessIncrementalBackup |
Defines that this tape job will archive incremental backups. Use the |
|
False |
Named |
False |
|
ScheduleOptions |
Specifies backup to tape job schedule. Default:
|
False |
Named |
False |
|
|
UseHardwareCompression |
Defines that tape library must perform hardware compression for archives. Do not use this option for archiving Veeam backups or other already compressed files. |
|
False |
Named |
False |
|
WaitForBackupJob |
Defines that the tape job must wait for the source backup job to finish. Use the |
|
False |
Named |
False |
|
WaitPeriod |
Used to set time period for the Specifies the time period for which the tape job must wait for the source backup jobs to finish. Allowed values: Accepts TimeSpan, int or string. |
|
False |
Named |
False |