Set-VBRComputerGFSMonthlyOptions - Veeam Backup PowerShell Reference

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

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. Second - the cmdlet will create the monthly backup in the second week of the month. Third - the cmdlet will create the monthly backup in the third week of the month. Fourth - the cmdlet will create the monthly backup in the fourth 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.
Second - the cmdlet will create the monthly backup in the second week of the month.
Third - the cmdlet will create the monthly backup in the third week of the month.
Fourth - the cmdlet will create the monthly backup in the fourth week of the month.
Last - the cmdlet will create the monthly backup in the last week of the month.

VBRWeekOfMonth

False

Named

False

This example shows how to modify the settings of the monthly GFS retention policy and change a number of months to keep monthly backups. With these settings applied, Veeam Backup & Replication will keep monthly backups for 5 months.

$options = New-VBRComputerGFSMonthlyOptions -RetentionPeriod 3 -SelectedWeek First

Set-VBRComputerGFSMonthlyOptions -Options $options -RetentionPeriod 5

Perform the following steps:

Run the New-VBRComputerGFSMonthlyOptions cmdlet. Specify the RetentionPeriod and the SelectedWeek parameter values. Save the result to the $options variable.
Run the Set-VBRComputerGFSMonthlyOptions cmdlet. Set the $options variable as the Options parameter value. Specify the RetentionPeriod parameter value.

This example shows how to modify the settings of the monthly GFS retention policy and change a week when a monthly backup is created. With these settings applied, Veeam Backup & Replication will create monthly backups on the last week of a month.

$options = New-VBRComputerGFSMonthlyOptions -RetentionPeriod 3 -SelectedWeek First

Set-VBRComputerGFSMonthlyOptions -Options $options -SelectedWeek Last

Perform the following steps:

Run the New-VBRComputerGFSMonthlyOptions cmdlet. Specify the RetentionPeriod and the SelectedWeek parameter values. Save the result to the $options variable.
Run the Set-VBRComputerGFSMonthlyOptions cmdlet. Set the $options variable as the Options parameter value. Set the Last option for the SelectedWeek parameter.