---
title: "New-VBRComputerGFSOptions"
description: "Defines settings of GFS retention for Veeam Agent backup jobs. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet creates the VBRComputerGFSOptions object."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/new-vbrcomputergfsoptions.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Veeam Agent Management > Working with Veeam Agent Backup Jobs and Policies > Veeam Agent Job Advanced Settings > New-VBRComputerGFSOptions"
dateModified: "2026-08-19"
---

# New-VBRComputerGFSOptions

## Short Description
Defines settings of GFS retention for Veeam Agent backup jobs.

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

## Syntax
```
New-VBRComputerGFSOptions [-GFSWeeklyOptions <VBRComputerGFSWeeklyOptions>]
 [-GFSMonthlyOptions <VBRComputerGFSMonthlyOptions>] [-GFSYearlyOptions <VBRComputerGFSYearlyOptions>]
 [-ReadEntireRestorePoint] [<CommonParameters>]
```

## Detailed Description
This cmdlet creates the `VBRComputerGFSOptions` object. This object contains GFS retention settings that you can apply to Veeam Agent backup jobs.

For more information on GFS retention, see the [GFS Retention Policy](https://helpcenter.veeam.com/docs/vbr/userguide/backup_copy_gfs.html?ver=13) section of the User Guide for VMware vSphere.

## Parameters

<table style="width:100%;" class="Blue_Table">
      <tr style="vertical-align:top">
        <th style="width:20%;">
          <p>Parameter</p>
        </th>
        <th style="width:20%;">
          <p>Description</p>
        </th>
        <th style="width:20%;">
          <p>Type</p>
        </th>
        <th style="width:10%;">
          <p>Required</p>
        </th>
        <th style="width:10%;">
          <p>Position</p>
        </th>
        <th style="width:10%;">
          <p>Accept Pipeline Input</p>
        </th>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">GFSMonthlyOptions</span></p>
        </td>
        <td>
          <p>Specifies settings of a monthly GFS retention. The cmdlet will define GFS retention with these settings.</p><p>Accepts the <code>VBRComputerGFSMonthlyOptions</code> object. To create this object, run the <a href="new-vbrcomputergfsmonthlyoptions.md"><code>New-VBRComputerGFSMonthlyOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRComputerGFSMonthlyOptions</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">GFSWeeklyOptions</span></p>
        </td>
        <td>
          <p>Specifies settings of a weekly GFS retention. The cmdlet will define GFS retention with these settings.</p><p>Accepts the <code>VBRComputerGFSWeeklyOptions</code> object. To create this object, run the <a href="new-vbrcomputergfsweeklyoptions.md"><code>New-VBRComputerGFSWeeklyOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRComputerGFSWeeklyOptions</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">GFSYearlyOptions</span></p>
        </td>
        <td>
          <p>Specifies settings of a yearly GFS retention. The cmdlet will define GFS retention with these settings.</p><p>Accepts the <code>VBRComputerGFSYearlyOptions</code> object. To create this object, run the <a href="new-vbrcomputergfsyearlyoptions.md"><code>New-VBRComputerGFSYearlyOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRComputerGFSYearlyOptions</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">ReadEntireRestorePoint</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will process the most recent restore point instead of waiting for the current backup file to become available.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
    </table>

`<CommonParameters>`

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see [ Microsoft Docs](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-7).

## Output Object
This cmdlet returns the `VBRComputerGFSOptions` object that contains settings of GFS retention for Veeam Agent backup jobs.

## Examples

::: example
### Defining GFS Retention Policy for Veeam Agent Backup Jobs

This example shows how to define GFS retention settings for Veeam Agent backup jobs. The cmdlet will define the GFS retention with the following weekly, monthly and yearly settings:

- Weekly: every Wednesday, keep backups for 3 weeks.
- Monthly: every first week of the month, keep backups for 3 months.
- Yearly: every November, keep backups for 2 years.

```
$weekly = New-VBRComputerGFSWeeklyOptions -RetentionPeriod 3 -SelectedDay Wednesday
$monthly = New-VBRComputerGFSMonthlyOptions -RetentionPeriod 3 -SelectedWeek First
$yearly = New-VBRComputerGFSYearlyOptions -RetentionPeriod 2 -SelectedMonth November
New-VBRComputerGFSOptions -GFSWeeklyOptions $weekly -GFSMonthlyOptions $monthly -GFSYearlyOptions $yearly
```

Perform the following steps:

1. Run the [`New-VBRComputerGFSWeeklyOptions`](new-vbrcomputergfsweeklyoptions.md) cmdlet. Specify the `RetentionPeriod` and the `SelectedDay` parameter values. Save the result to the `$weekly` variable.
2. Run the [`New-VBRComputerGFSMonthlyOptions`](new-vbrcomputergfsmonthlyoptions.md) cmdlet. Specify the `RetentionPeriod` and the `SelectedWeek` parameter values. Save the result to the `$monthly` variable.
3. Run the [`New-VBRComputerGFSYearlyOptions`](new-vbrcomputergfsyearlyoptions.md) cmdlet. Specify the `RetentionPeriod` and the `SelectedMonth` parameter values. Save the result to the `$yearly` variable.
4. Run the `New-VBRComputerGFSOptions` cmdlet. Specify the following settings:

   - Set the `$weekly` variable as the `GFSWeeklyOptions` parameter value.
   - Set the `$monthly` variable as the `GFSMonthlyOptions` parameter value.
   - Set the `$yearly` variable as the `GFSYearlyOptions` parameter value.

:::

## Related Commands

- [`New-VBRComputerGFSWeeklyOptions`](new-vbrcomputergfsweeklyoptions.md)
- [`New-VBRComputerGFSMonthlyOptions`](new-vbrcomputergfsmonthlyoptions.md)
- [`New-VBRComputerGFSYearlyOptions`](new-vbrcomputergfsyearlyoptions.md)