New-VBRSureBackupJobScheduleOptions

Short Description

Defines a SureBackup job schedule.

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

Syntax

New-VBRSureBackupJobScheduleOptions -Type <VBRSbJobScheduleType> [-DailyOptions <VBRDailyOptions>]

[-MonthlyOptions <VBRMonthlyOptions>] [-ParentJob <CBackupJob>] [-WaitForParentJob] [-WaitTimeMinutes <Int32>] [<CommonParameters>]

Detailed Description

This cmdlet creates the VBRSureBackupJobScheduleOptions object that defines a SureBackup job schedule.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
DailyOptions	For daily schedule. Specifies a daily schedule for a SureBackup job. The cmdlet will create the SureBackup job with this schedule. Accepts the `VBRDailyOptions` object. To create this object, run the `New-VBRDailyOptions` cmdlet.	`VBRDailyOptions`	False	Named	False
MonthlyOptions	For a monthly schedule. Specifies a monthly schedule for a SureBackup job. The cmdlet will create the SureBackup job with this schedule. Accepts the `VBRMonthlyOptions` object. To create this object, run the `New-VBRMonthlyOptions` cmdlet.	`VBRMonthlyOptions`	False	Named	False
ParentJob	For running after a job. Specifies a name of the job after which Veeam Backup & Replication the SureBackup job must run. The cmdlet will create the SureBackup job with this schedule. Accepts the `CBackupJob` object. To create this object, run the `Get-VBRJob` cmdlet.	`CBackupJob`	False	Named	False
Type	Specifies how often a SureBackup job must run. You can select one of the following options: `Daily:` use this option if you want the SureBackup job to run every day. Provide the `DailyOptions` parameter to specify a daily schedule. `Monthly:` use this option if you want the SureBackup job to run monthly. Provide the `MonthlyOptions` parameter to specify a monthly schedule. `AfterJob:` use this option if you want the SureBackup job to run after a specific job. Provide the `ParentJob` parameter to specify the job after which the SureBackup job must run.	`VBRSbJobScheduleType`	True	Named	False
WaitForParentJob	Defines that the SureBackup job will wait until the linked backup or replication job completes. If you provide this parameter, Veeam Backup & Replication will wait until the linked job completes. Otherwise, it will start the SureBackup job without waiting for the linked job to complete. Use the `WaitTimeMinutes` parameter to specify how long the SureBackup job must wait for the linked job to complete.	`SwitchParameter`	False	Named	False
WaitTimeMinutes	Specifies the time period in minutes that the SureBackup job must wait for the linked job to complete.	`Int32`	False	Named	False

<CommonParameters>

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

Output Object

The cmdlet returns the VBRSureBackupJobScheduleOptions object that defines SureBackup job schedule.

Examples

New-VBRSureBackupJobScheduleOptions Example 1. Defining Daily SureBackup Job Schedule

This example shows how to define the daily SureBackup job schedule. The schedule is created to run the SureBackup job every Friday at 23:00.

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

New-VBRSureBackupJobScheduleOptions -Type Daily -DailyOptions $daily

Perform the following steps:

Run the New-VBRDailyOptions cmdlet. Specify the DayOfWeek parameter value. Specify the Period parameter value. Save the result to the $daily variable.
Run the New-VBRSureBackupJobScheduleOptions cmdlet. Set the Daily option for the Type parameter value. Set the $daily variable as the DailyOptions parameter value.

New-VBRSureBackupJobScheduleOptions Example 2. Defining Monthly SureBackup Job Schedule

This example shows how to define the monthly SureBackup job schedule. The schedule is created to run the SureBackup job at 23:00 on the second Wednesday every month.

$monthly = New-VBRMonthlyOptions -DayNumberInMonth Second -DayOfWeek Wednesday -Period 23:00

New-VBRSureBackupJobScheduleOptions -Type Monthly MonthlyOptions $monthly

Perform the following steps:

Run the New-VBRMonthlyOptions cmdlet. Set the Second option for the DayNumberInMonth parameter value. Set the Wednesday option for the DayOfWeek parameter value. Specify the Period parameter value. Save the result to the $monthly variable.
Run the New-VBRSureBackupJobScheduleOptions cmdlet. Set the Monthly option for the Type parameter value. Set the $monthly variable as the DailyOptions parameter value.

New-VBRSureBackupJobScheduleOptions Example 3. Defining Chained SureBackup Job Schedule

This example shows how to define the chained SureBackup job schedule. The schedule is created to run the SureBackup job after the Exchange Backup Job job completes.

$job = Get-VBRJob -Name "Exchange Backup Job"

New-VBRSureBackupJobScheduleOptions -Type AfterJob -ParentJob $job

Perform the following steps:

Run the Get-VBRJob cmdlet. Specify the Name parameter value. Save the result to the $job variable.
Run the New-VBRSureBackupJobScheduleOptions cmdlet. Set the AfterJob option for the Type parameter value. Set the $job variable as the ParentJob parameter value.