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

Add-VBRBackupToTapeJob -Name <String> [-Description <String>] [-EjectCurrentMedium] [-ExportCurrentMediaSet]

-FullBackupMediaPool <VBRTapeMediaPool> [-IncrementalBackupMediaPool <VBRTapeMediaPool>]

[-ExportDays <DayOfWeek[]>] [-FullBackupPolicy <VBRFullBackupToTapePolicy>]

[-ScheduleOptions <VBRBackupToTapeScheduleOptions>] [-Object <Object[]>] [-ProcessIncrementalBackup]

[-UseHardwareCompression] [-WaitPeriod <TimeSpan>] [-WaitForBackupJob]

[-NotificationOptions <VBRNotificationOptions>] [-JobScriptOptions <VBRJobScriptOptions>]

[-CopyFromLatestFull] [-AlwaysCopyFromLatestFull] [-Force] [-EnableParallelDrivesUsage]

[-LimitTapeDrives <Int32>] [-PreventInterruption] [<CommonParameters>]

GFSMediaPool

Add-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>]

[-CopyFromLatestFull] [-AlwaysCopyFromLatestFull] [-GFSScheduleOptions <VBRTapeGFSScheduleOptions>] [-Force]

[-EnableParallelDrivesUsage] [-LimitTapeDrives <Int32>] [-PreventInterruption] [<CommonParameters>]

Detailed Description

This cmdlet creates a new backup to tape job or a GFS job. You can target the job to a simple or a GFS media pool.

Note

Consider the following:

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.
If you choose to archive data from backup repositories, the backup to tape job will process only the backups that were created with backup jobs configured on this Veeam backup server. Imported backups and configuration backups will be skipped from processing.

Parameters

Parameters
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.	`SwitchParameter`	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.	`SwitchParameter`	False	Named	False
Description	Specifies the description of the backup to tape job.	`String`	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.	`SwitchParameter`	False	Named	False
EnableParallelDrivesUsage	Enables parallel processing of media pools. Default: `False`.	`SwitchParameter`	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 `ExportDays` parameter to set days on which you want to export tapes. If you use this parameter, but do not set the `ExportDays` parameter, the tapes will be exported every day.	`SwitchParameter`	False	Named	False
ExportDays	Used to set days for exporting tapes for the `ExportCurrentMediaSet` parameter. Specifies days on which the tapes written by this tape job will be automatically exported: `Monday`, `Tuesday`, `Wednesday`, `Thursday`, `Friday`, `Saturday`, `Sunday`.	`DayOfWeek[]`	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.	`SwitchParameter`	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 `VBRTapeMediaPool` object, GUID or string. To get this object, run the `Get-VBRTapeMediaPool` cmdlet.	`VBRTapeMediaPool`	True	Named	False
FullBackupPolicy	Specifies virtual full settings. Accepts the `VBRFullBackupToTapePolicy` object. To create this object, run the `New-VBRFullBackupToTapePolicy` cmdlet.	`VBRFullBackupToTapePolicy`	False	Named	False
GFSMediaPool	For GFS jobs. Specifies the target GFS media pool. Accepts the `VBRTapeGFSMediaPool` object, GUID or string. To get this object, run the `Get-VBRTapeMediaPool` cmdlet.	`VBRTapeGFSMediaPool`	True	Named	False
GFSScheduleOptions	Specifies the schedule settings for the GFS media pool. Accepts the `VBRTapeGFSScheduleOptions` object. To create this object, run the `New-VBRTapeGFSScheduleOptions` cmdlet.	`VBRTapeGFSScheduleOptions`	False	Named	False
IncrementalBackupMediaPool	For non-GFS jobs. Used to set media pool for the `ProcessIncrementalBackup` parameter. Specifies the media pool where you want to store incremental backups produced by this tape job. Accepts the `VBRTapeMediaPool` object, GUID or string. To get this object, run the `Get-VBRTapeMediaPool` cmdlet.	`VBRTapeMediaPool`	False	Named	False
JobScriptOptions	Specifies scripting options. Accepts the `VBRJobScriptOptions` object. To create this object, run the `New-VBRJobScriptOptions` cmdlet.	`VBRJobScriptOptions`	False	Named	False
LimitTapeDrives	Defines that the cmdlet will limit the number of drives to use for processing this tape job. Default: 2 drives.	`Int32`	False	Named	False
Name	Specifies the name you want to assign to the backup to tape job.	`String`	True	Named	False
NotificationOptions	Specifies the email notification options. Accepts the `VBRNotificationOptions` object. To create this object, run the `New-VBRNotificationOptions` cmdlet.	`VBRNotificationOptions`	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: `CBackupJob`. To get this object, run the `Get-VBRJob` cmdlet. `CBackupRepository`. To get this object, run the `Get-VBRBackupRepository` cmdlet. `VBRComputerBackupJob`. To get this object, run the `Get-VBRComputerBackupJob` cmdlet. `VBREPJob`. To get this object, run the `Get-VBREPJob` cmdlet. `VBRCloudTenant`. To get this object, run the `Get-VBRCloudTenant` cmdlet. `VBRCloudTenantResource`. To get this object, run the `New-VBRCloudTenantResource` cmdlet.	`Object[]`	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.	`SwitchParameter`	False	Named	False
ProcessIncrementalBackup	Defines that this tape job will archive incremental backups. Use the `IncrementalBackupMediaPool` parameter to specify a separate media pool for storing incremental backups. If you do not set the `IncrementalBackupMediaPool` parameter, incremental backups will be stored to the media pool the you set for full backups.	`SwitchParameter`	False	Named	False
ScheduleOptions	Specifies backup to tape job schedule. Default: `Enabled: False.` `Type: Daily.` `DailyOptions: Type: SelectedDays, Period: 18:00, DayOfWeek: Saturday.` `MonthlyOptions: Period: 22:00, DayNumberInMonth: Fourth, DayOfWeek: Saturday, Months: January, February, March, April, May, June, July, August, September, October, November, December.` `ScheduleOptions: From Sunday to Saturday, from 00:00 to 23:00, Enabled: True.` `JobId: Null.`	`VBRBackupToTapeScheduleOptions`	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.	`SwitchParameter`	False	Named	False
WaitForBackupJob	Defines that the tape job must wait for the source backup job to finish. Use the `WaitPeriod` parameter to set the time period.	`SwitchParameter`	False	Named	False
WaitPeriod	Used to set time period for the `WaitForBackupJob` parameter. Specifies the time period for which the tape job must wait for the source backup jobs to finish. Allowed values: `1-777` minutes. Accepts TimeSpan, int or string.	`TimeSpan`	False	Named	False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Output Object

VBRBackupToTapeJob

Examples

Creating Backup to Tape Job with Backup Job as Source

This example shows how to create a backup to tape job for SQL 1 Backup source job. The tape job will use the same media pool to back up full and incremental backups.

$job = Get-VBRJob -Name "SQL 1 Backup"

$mediapool = Get-VBRTapeMediaPool -Name "SQL Backups Media Pool"

$dailyoptions = New-VBRDailyOptions -DayOfWeek Friday -Period 23:00

$scheduleoptions = New-VBRBackupToTapeScheduleOptions -DailyOptions $dailyoptions -Enabled

Add-VBRBackupToTapeJob -Name "SQL to Tape" -Description "SQL archive" -Object $job -FullBackupMediaPool $mediapool -ProcessIncrementalBackup -IncrementalBackupMediaPool $mediapool -ExportDays Monday -ScheduleOptions $scheduleoptions

Perform the following steps:

Run the Get-VBRJob cmdlet. Specify the Name parameter value. Save the result to the $job variable.
Run the Get-VBRTapeMediaPool cmdlet. Specify the Name parameter value. Save the result to the $mediapool variable.
Run the New-VBRDailyOptions cmdlet. Set Friday as the DayOfWeek parameter value and 23:00 as the Period parameter value. Save the result to the $dailyoptions variable.
Run the New-VBRBackupToTapeScheduleOptions cmdlet. Set the $dailyoptions variable as the DailyOptions parameter value. Provide the Enabled parameter. Save the result to the $scheduleoptions variable.
Run the Add-VBRBackupToTapeJob cmdlet. Specify the following settings:
- Specify the Name and the Description parameter value.
- Set the $job variable as the Object parameter value.
- Set the $mediapool variable as the FullBackupMediaPool and IncrementalBackupMediaPool parameters value.
- Provide the ProcessIncrementalBackup parameter.
- Specify the ExportDays parameter value.
- Set the $scheduleoptions variable as the ScheduleOptions parameter value.