Set-VBRComputerGFSYearlyOptions - Veeam Backup PowerShell Reference

Set-VBRComputerGFSYearlyOptions -Options <VBRComputerGFSYearlyOptions> [-RetentionPeriod <Int32>] [-SelectedMonth <VBRMonth>] [<CommonParameters>]

Parameter	Description	Type	Required	Position	Accept Pipeline Input
Options	Specifies a yearly GFS retention policy for Veeam Agent backup jobs. The cmdlet will modify this policy.	Accepts the VBRComputerGFSYearlyOptions object. To create this object, run the New-VBRComputerGFSYearlyOptions cmdlet	True	Named	True
RetentionPeriod	Specifies the number of months to keep yearly full backups.	Int32	False	Named	False
SelectedMonth	Specifies a month when a yearly backup is created. You can specify either of the following months: January February March April May June July August September October November December	VBRMonth	False	Named	False

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Options

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

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

True

Named

True

RetentionPeriod

Specifies the number of months to keep yearly full backups.

Int32

False

Named

False

SelectedMonth

Specifies a month when a yearly backup is created. You can specify either of the following months:

January
February
March
April
May
June
July
August
September
October
November
December

VBRMonth

False

Named

False

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

$options = New-VBRComputerGFSYearlyOptions -RetentionPeriod 2 -SelectedMonth November

Set-VBRComputerGFSYearlyOptions -Options $options -RetentionPeriod 3

Perform the following steps:

Run the New-VBRComputerGFSYearlyOptions cmdlet. Specify the RetentionPeriod and the SelectedWeek parameter values. Save the result to the $options variable.
Run the Set-VBRComputerGFSYearlyOptions 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 yearly GFS retention policy and change a month when a yearly backup is created. With these settings applied, Veeam Backup & Replication will create yearly backups in February.

$options = New-VBRComputerGFSYearlyOptions -RetentionPeriod 2 -SelectedMonth November

Set-VBRComputerGFSYearlyOptions -Options $options -SelectedMonth February

Perform the following steps:

Run the New-VBRComputerGFSYearlyOptions cmdlet. Specify the RetentionPeriod and the SelectedMonth parameter values. Save the result to the $options variable.
Run the Set-VBRComputerGFSYearlyOptions cmdlet. Set the $options variable as the Options parameter value. Set the February option for the SelectedMonth parameter.