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

Set-VBRComputerGFSMonthlyOptions

Short Description

Modifies settings of a monthly GFS retention policy for Veeam Agent backup jobs.

Applies to

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

Syntax

Set-VBRComputerGFSMonthlyOptions -Options <VBRComputerGFSMonthlyOptions> [-RetentionPeriod <Int32>] [-SelectedWeek <VBRWeekOfMonth>] [<CommonParameters>]

Detailed Description

This cmdlet modifies settings of a monthly GFS retention policy for Veeam Agent backup jobs. To modify settings, you need to specify new values for the necessary parameters. The parameters that you omit will remain unchanged.

Parameters

Parameter	Description	Type	Required	Position	Accept Pipeline Input
Options	Specifies a monthly GFS retention policy for Veeam Agent backup jobs. The cmdlet will modify this policy.	Accepts the VBRComputerGFSMonthlyOptions object. To create this object, run the New-VBRComputerGFSMonthlyOptions cmdlet.	True	Named	True
RetentionPeriod	Specifies the number of months to keep monthly full backups.	Int32	False	Named	False
SelectedWeek	Specifies a week of a month when a monthly backup is created. You can specify either of the following weeks: First - the cmdlet will create the monthly backup in the first week of the month. Last - the cmdlet will create the monthly backup in the last week of the month.	VBRWeekOfMonth	False	Named	False

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Options

Specifies a monthly GFS retention policy for Veeam Agent backup jobs. The cmdlet will modify this policy.

Accepts the VBRComputerGFSMonthlyOptions object. To create this object, run the New-VBRComputerGFSMonthlyOptions cmdlet.

True

Named

True

RetentionPeriod

Specifies the number of months to keep monthly full backups.

Int32

False

Named

False

SelectedWeek

Specifies a week of a month when a monthly backup is created. You can specify either of the following weeks:

First - the cmdlet will create the monthly backup in the first week of the month.
Last - the cmdlet will create the monthly backup in the last week of the month.

VBRWeekOfMonth

False

Named

False

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

Output Object

This cmdlet returns the VBRComputerGFSMonthlyOptions object that contains settings of a monthly GFS retention policy for Veeam Agent backup jobs.

Examples

Set-VBRComputerGFSMonthlyOptions Example 1. Modifying Number of Months for GFS Retention Policy

Set-VBRComputerGFSMonthlyOptions Example 2. Modifying Day When Backup is Created

Related Commands

New-VBRComputerGFSMonthlyOptions