Set-VBRJobScheduleOptions (obsolete)

Short Description

Applies modified job schedule settings to jobs.

Note

This cmdlet is obsolete. You can still run this cmdlet, but it is recommended to modify job schedule using the Set-VBRJobScheduleModifies job schedule. cmdlet.

Platform: VMware, Hyper-V

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

Syntax

Set-VBRJobScheduleOptions [-Job] <CBackupJob[]> [-Options] <ScheduleOptions> [<CommonParameters>]

Detailed Description

This cmdlet applies customized scheduling options to a selected backup, replication or copy job.

Run the New-VBRJobScheduleOptionsCreates new job schedule options. This cmdlet is obsolete. You can still run this cmdlet but, depending on the job type, it is recommended to run one of the following cmdlets: - The New-VBRServerScheduleOptions cmdlet to define schedule settings for backup jobs. - The New-VBRWindowsWorkstationScheduleOptions cmdlet to create a job schedule for Windows workstations. - The New-VBRLinuxScheduleOptions cmdlet to create a job schedule for Linux computers. - The New-VBRMacScheduleOptions cmdlet to create a job schedule for macOS computers. - The Set-VBRJobSchedule cmdlet to modify a job schedule. cmdlet to create the new schedule settings.

You can modify schedule of backup, replication or backup copy jobs.

Run the Set-VSBJobScheduleOptionsApplies customized job scheduling options to a selected SureBackup job. This cmdlet is obsolete. The cmdlet will still work but may not be supported in further versions. cmdlet to set scheduling options to SureBackup job.

Note

To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameters values with new values. The parameters that you omit will remain unchanged.

Parameters

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Job

Specifies the array of jobs. The cmdlet will apply schedule settings to these jobs.

Accepts the CBackupJob object. To create this object, run the Get-VBRJobReturns existing jobs. cmdlet.

CBackupJob[]

True

0

True (ByPropertyName, ByValue)

Options

Specifies the schedule options you want to apply.

Accepts the VBRServerScheduleOptions object. To create this object, run the New-VBRServerScheduleOptionsCreates the schedule for jobs. cmdlet.

ScheduleOptions

True

1

False

<CommonParameters>

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

Examples

Set-VBRJobScheduleOptions (obsolete)Example 1. Scheduling Backup Job with Time Interval of 2 Hours

This example shows how to schedule the backup job to run repeatedly throughout a day with the time interval of 2 hours.

$newschedule = New-VBRJobScheduleOptions

$newschedule.OptionsPeriodically.Enabled = $true

$newschedule.OptionsPeriodically.FullPeriod = 120

$newschedule.OptionsDaily.Enabled = $false

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

Set-VBRJobScheduleOptions -Job $job -Options $newschedule

Perform the following steps:

  1. Run the New-VBRJobScheduleOptionsCreates new job schedule options. This cmdlet is obsolete. You can still run this cmdlet but, depending on the job type, it is recommended to run one of the following cmdlets: - The New-VBRServerScheduleOptions cmdlet to define schedule settings for backup jobs. - The New-VBRWindowsWorkstationScheduleOptions cmdlet to create a job schedule for Windows workstations. - The New-VBRLinuxScheduleOptions cmdlet to create a job schedule for Linux computers. - The New-VBRMacScheduleOptions cmdlet to create a job schedule for macOS computers. - The Set-VBRJobSchedule cmdlet to modify a job schedule. cmdlet. Save the result to the $newschedule variable.
  2. Provide $true value for the the OptionsPeriodically property of the $newschedule variable.
  3. Specify the value for the OptionsPeriodically property in minutes.
  4. Provide the $false value for the OptionsDaily property of the $newschedule variable.
  5. Run the Get-VBRJobReturns existing jobs. cmdlet. Specify the Name parameter value. Save the result to the $job variable.
  6. Run the Set-VBRJobScheduleOptions cmdlet. Set the $job variable as the Job parameter value. Set the $newschedule variable as the Options parameter value.

Set-VBRJobScheduleOptions (obsolete)Example 2. Applying Customized Scheduling Options to Specific Jobs [Using Pipeline]

This command applies the customized scheduling options to the jobs named DC Backup and DC File Copy.

$ScheduleOptions = New-VBRJobScheduleOptions

Get-VBRJob -Name "DC Backup", "DC File Copy" | Set-VBRJobScheduleOptions -Options $ScheduleOptions

Perform the following steps:

  1. Run the New-VBRJobScheduleOptionsCreates new job schedule options. This cmdlet is obsolete. You can still run this cmdlet but, depending on the job type, it is recommended to run one of the following cmdlets: - The New-VBRServerScheduleOptions cmdlet to define schedule settings for backup jobs. - The New-VBRWindowsWorkstationScheduleOptions cmdlet to create a job schedule for Windows workstations. - The New-VBRLinuxScheduleOptions cmdlet to create a job schedule for Linux computers. - The New-VBRMacScheduleOptions cmdlet to create a job schedule for macOS computers. - The Set-VBRJobSchedule cmdlet to modify a job schedule. cmdlet. Save the result to the $ScheduleOptions variable.
  2. Run the Get-VBRJobReturns existing jobs. cmdlet. Specify the Name parameter value.
  3. Pipe the cmdlet output to the Set-VBRJobScheduleOptions cmdlet. Set the $ScheduleOptions variable as the Options parameter value.

Set-VBRJobScheduleOptions (obsolete)Example 3. Applying Customized Scheduling Options to Specific Job [Using Variable]

This command applies the customized scheduling options to the job represented by the $job variable.

$job = Get-VBRJob

$ScheduleOptions = New-VBRJobScheduleOptions

Set-VBRJobScheduleOptions -Job $job -Options $ScheduleOptions

Perform the following steps:

  1. Run the Get-VBRJobReturns existing jobs. cmdlet. Save the result to the $job variable.
  2. Run the New-VBRJobScheduleOptionsCreates new job schedule options. This cmdlet is obsolete. You can still run this cmdlet but, depending on the job type, it is recommended to run one of the following cmdlets: - The New-VBRServerScheduleOptions cmdlet to define schedule settings for backup jobs. - The New-VBRWindowsWorkstationScheduleOptions cmdlet to create a job schedule for Windows workstations. - The New-VBRLinuxScheduleOptions cmdlet to create a job schedule for Linux computers. - The New-VBRMacScheduleOptions cmdlet to create a job schedule for macOS computers. - The Set-VBRJobSchedule cmdlet to modify a job schedule. cmdlet. Save the result to the $ScheduleOptions variable.
  3. Run the Set-VBRJobScheduleOptions cmdlet. Set the $job variable as the Job parameter value. Set the $ScheduleOptions variable as the Options parameter value.
  • Get-VBRJobReturns existing jobs.
  • New-VBRJobScheduleOptionsCreates new job schedule options. This cmdlet is obsolete. You can still run this cmdlet but, depending on the job type, it is recommended to run one of the following cmdlets: - The New-VBRServerScheduleOptions cmdlet to define schedule settings for backup jobs. - The New-VBRWindowsWorkstationScheduleOptions cmdlet to create a job schedule for Windows workstations. - The New-VBRLinuxScheduleOptions cmdlet to create a job schedule for Linux computers. - The New-VBRMacScheduleOptions cmdlet to create a job schedule for macOS computers. - The Set-VBRJobSchedule cmdlet to modify a job schedule.

Page updated 2026-08-19

Page content applies to build 13.1.1.18