Help Center
Choose product document...
Veeam Backup & Replication 9.5 [Archived]
PowerShell Reference

Set-VBRJobOptions

Short Description

Modifies job settings.

Applies to

Platform: VMware, Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus

Syntax

Set-VBRJobOptions [-Job] <CBackupJob[]> [-Options] <CJobOptions> [-WarningAction <ActionPreference>] [-WarningVariable <String>] [<CommonParameters>]

Detailed Description

This cmdlet applies customized settings to a selected job.

Run New-VBRJobOptions to customize the job settings.

Parameters

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

Job

Specifies the job you want to edit.

True

1

True (ByValue,
ByProperty
Name)

False

Options

Specifies the set of parameters you want to apply to the job.

True

2

False

False

<CommonParameters>

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

Example 1

This example shows how to define the retention policy for a backup job.

You will need to perform the following steps:

  1. Run New-VBRJobOptions to get the object with the default backup job settings. Save the result to the $retention variable.
  2. Edit the backup storage settings. Use the RetainCycles parameter of the BackupStorageOptions object to specify the number of restore points.
  3. Run Get-VBRJob to get the job to which you want to apply the retention policy. Save the result to the $job variable.
  4. Run Set-VBRJobOptions with the $job and $retention variables to apply the retention policy.

PS C:\PS> $retention = New-VBRJobOptions -ForBackupJob

PS C:\PS> $retention.BackupStorageOptions.RetainCycles = 7

PS C:\PS> $job = Get-VBRJob -Name "ABC Backup"

PS C:\PS> Set-VBRJobOptions -Job $job -Options $retention

Example 2

This command applies custom settings to the backup job named "Backup Job 01". The job object is obtained with Get-VBRJob and piped down. The object containing the set of customized options is obtained with New-VBRJobOptions and assigned to the $options variable beforehand.

PS C:\PS> Get-VBRJob -Name "Backup Job 01" | Set-VBRJobOptions -Options $options

Example 3

This command applies custom settings to the backup job represented by the $job variable. The job object is obtained with Get-VBRJob and assigned to the variable beforehand. The object containing the set of customized options is obtained with New-VBRJobOptions and assigned to the $options variable beforehand.

PS C:\PS> Set-VBRJobOptions -Job $job -Options $options

Related Commands

Get-VBRJob

New-VBRJobOptions

Veeam Large Logo

User Guide for VMware vSphere

User Guide for Microsoft Hyper-V

Enterprise Manager User Guide

Veeam Cloud Connect Guide

Veeam Agent Management Guide

Veeam Backup Explorers User Guide

Backup and Restore of SQL Server Databases

PowerShell Reference

RESTful API Reference

Veeam Backup FREE Edition User Guide