New-VBRSureBackupJobScheduleOptions

In this article

    Short Description

    Defines a SureBackup job schedule.

    Applies to

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

    Syntax

    New-VBRSureBackupJobScheduleOptions -Type <VBRSbJobScheduleType> {Daily | Monthly | AfterJob} [-DailyOptions <VBRDailyOptions>] [-MonthlyOptions <VBRMonthlyOptions>] [-ParentJob <CBackupJob>] [-WaitForParentJob][-WaitTimeMinutes <int>]  [<CommonParameters>]

    Detailed Description

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

    Parameters

    Parameter

    Description

    Type

    Required

    Position

    Accept Pipeline Input

    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

    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.

    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.

    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.

    False

    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.

    SwitchParamter

    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 the About CommonParameters section of Microsoft Docs.

    Output Object

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

    Examples

    New-VBRSureBackupJobScheduleOptionsExample 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:

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

    New-VBRSureBackupJobScheduleOptionsExample 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:

    1. 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.
    2. Run the New-VBRSureBackupJobScheduleOptions cmdlet. Set the Monthly option for the Type parameter value. Set the $monthly variable as the DailyOptions parameter value.

    New-VBRSureBackupJobScheduleOptionsExample 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:

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

    Related Commands

    I want to report a typo

    There is a misspelling right here:

     

    I want to let the Veeam Documentation Team know about that.