This is an archive version of the document. To get the most up-to-date information, see the current version.

New-VBRBackupToTapeScheduleOptions

In this article

Short Description

Creates a new VBRBackupToTapeScheduleOptions object.

Applies to

Platform: VMware, Hyper-V

Product Edition: Enterprise, Enterprise Plus

Syntax

New-VBRBackupToTapeScheduleOptions [-Type <VBRBackupToTapePolicyType>] [-DailyOptions <VBRDailyOptions>] [-MonthlyOptions <VBRMonthlyOptions>] [-BackupWindowOptions <VBRBackupWindowOptions>] [-Job <VBRJob>] [-Enabled][-WarningAction <ActionPreference>] [-WarningVariable <String>] [<CommonParameters>]

Related Commands

New-VBRDailyOptions

New-VBRMonthlyOptions

New-VBRBackupWindowOptions

Get-VBRJob

Return Type

VBRBackupToTapeScheduleOptions

Detailed Description

This cmdlet creates the VBRBackupToTapeScheduleOptions object. This object contains schedule settings for backup to tape job and is used further to apply these settings to an existing backup to tape job.

Parameters

Parameter	Description	Required	Position	Accept Pipeline Input	Accept Wildcard Characters
Type	Specifies the job schedule type: AfterJob: the tape job will wait for the source backup job to complete. AfterNewBackup: the tape job will periodically check the source jobs for new backups and archive new backups to tape. Daily: the tape job will run on selected days. Use the DailyOptions parameter to set the days. Monthly: the tape job will run on selected months. Use the MonthlyOptions parameter to set the months. Default: Daily.	False	Named	False	False
Daily Options	Used to set days for the Type parameter (Daily option). Accepts VBRDailyOptions object. Default: Type: SelectedDays. Period: 18:00. DayOfWeek: Saturday.	False	Named	False	False
Monthly Options	Used to set months for the Type parameter (Monthly option). Accepts VBRMonthlyOptions object. Default: Period: 22:00. DayNumberInMonth: Fourth. DayOfWeek: Saturday. Months: January, February, March, April, May, June, July, August, September, October, November, December.	False	Named	False	False
Backup Window Options	Specifies backup windows: the tape job will run within the specified time interval. Accepts VBRBackupWindowOptions object. Default: From Sunday to Saturday. From 00:00 to 23:00. Enabled: True.	False	Named	False	False
Job	Specifies the source backup job after which the tape job must run. Accepts VBRJob or CBackupJob objects. Default: Null.	False	Named	False	False
Enabled	Indicates if this schedule is enabled. Default: False.	False	Named	False	False

This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.

Example

This example shows how to create a tape job schedule with the following settings:

The job runs every Friday.
The job starts at 23:00.

To create a job schedule:

Run New-VBRDailyOptions to set the day and time. Save the result to the $dailyoptions variable.
Run New-VBRBackupToTapeScheduleOptions with the saved variable. Save the schedule to the $scheduleoptions variable for future use.

PS C:\PS> $dailyoptions = New-VBRDailyOptions -DayOfWeek Friday -Period 23:00

PS C:\PS> $scheduleoptions = New-VBRBackupToTapeScheduleOptions -DailyOptions $dailyoptions -Enabled