---
title: "Set-VBRBackupWindowOptions"
description: "Modifies job backup window settings. Platform: VMware, Hyper-V Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet modifies the job backup window settings."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/set-vbrbackupwindowoptions.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Jobs > Job Schedule > Set-VBRBackupWindowOptions"
dateModified: "2026-08-19"
---

# Set-VBRBackupWindowOptions

## Short Description
Modifies job backup window settings.

**Platform**: VMware, Hyper-V

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

## Syntax
```
Set-VBRBackupWindowOptions -Options <VBRBackupWindowOptions> -FromDay <DayOfWeek> -FromHour <Int32>
 -ToDay <DayOfWeek> -ToHour <Int32> [-Enabled] [-PassThru] [<CommonParameters>]
```

## Detailed Description
This cmdlet modifies the job backup window settings. You can use it to extend the existing backup window or remove specific days and hours from it. To modify settings, you must specify new values for the necessary parameters.

::: important

To modify the backup windows settings, you must provide the `PassThru` parameter in your scripts. If you omit this parameter, the backup window settings will not be modified.

:::

::: note

To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameters values with new values. The parameters that you omit will remain unchanged.

:::

## 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">Enabled</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will extend the backup window or will remove specific days and hours from it.</p><p>If you set this parameter to the <code>Enabled:$false</code> value, the cmdlet will remove the specified time period from the backup window.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>True</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">FromDay</span></p>
        </td>
        <td>
          <p>Specifies the day of the week on which the backup window opens. The cmdlet will extend the backup window with this day or will remove that day from the backup window.</p><p>Default: <code>Sunday</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>DayOfWeek</code></p>
        </td>
        <td style="width:10%;">
          <p>True</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">FromHour</span></p>
        </td>
        <td>
          <p>Specifies the hour on which the backup window opens. The cmdlet will add this hour to the existing backup window or will remove that hour from the backup window.</p><p>Default: <code>0</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</code></p>
        </td>
        <td style="width:10%;">
          <p>True</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">Options</span></p>
        </td>
        <td>
          <p>Specifies the backup window settings that you want to modify.</p><p>Accepts the <a href="vbrbackupwindowoptions.md"><code>VBRBackupWindowOptions</code></a> object. To create this object, run the <a href="new-vbrbackupwindowoptions.md"><code>New-VBRBackupWindowOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrbackupwindowoptions.md"><code>VBRBackupWindowOptions</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName, ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">PassThru</span></p>
        </td>
        <td>
          <p>Defines that the command will return the output object to the Windows PowerShell console.</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">ToDay</span></p>
        </td>
        <td>
          <p>Specifies the day of the week on which the backup window ends. The cmdlet will extend the backup window with this day or will remove that day from the backup window.</p><p>Default: <code>Saturday</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>DayOfWeek</code></p>
        </td>
        <td style="width:10%;">
          <p>True</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">ToHour</span></p>
        </td>
        <td>
          <p>Specifies the hour on which the backup window ends. The cmdlet will add this hour to the existing backup window or will remove that hour from the backup window.</p><p>Default: <code>23</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</code></p>
        </td>
        <td style="width:10%;">
          <p>True</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).

## Examples

::: example
### Example 1. Removing Specific Hours from Backup Window

This example shows how to modify the job backup window settings. The cmdlet will specify the time when the backup job is not allowed to run.

- The [`New-VBRBackupWindowOptions`](new-vbrbackupwindowoptions.md) cmdlet defines the following backup window settings: the job is allowed to run from 10:00 AM till 22.59 PM on Monday, Tuesday, Wednesday and Thursday.
- The `Set-VBRBackupWindowOptions` cmdlet modifies these settings. The job is not allowed to run from 10.00 AM till 12.59 AM on Tuesday and Wednesday.

```
$job = Get-VBRJob -Name "Backup Job"
$windowoptions = New-VBRBackupWindowOptions -FromDay Monday -FromHour 10 -ToDay Thursday -ToHour 22 -Enabled
$windowoptions = Set-VBRBackupWindowOptions -Options $windowoptions -FromDay Tuesday -FromHour 10 -ToDay Wednesday -ToHour 12 -Enabled:$false -PassThru
Set-VBRJobSchedule -Job $job -PeriodicallySchedule $windowoptions -Periodicaly -FullPeriod 6 -PeriodicallyKind Hours
```

Perform the following steps:

1. Run the [`Get-VBRJob`](get-vbrjob.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$job` variable.
2. Run the [`New-VBRBackupWindowOptions`](new-vbrbackupwindowoptions.md) cmdlet. Specify the following settings:

   - Specify the `FromDay` parameter value.
   - Specify the `FromHour` parameter value.
   - Specify the `ToDay` parameter value.
   - Specify the `ToHour` parameter value.
   - Provide the `Enabled` parameter.

   Save the result to the `$windowoptions` variable.

3. Run the `Set-VBRBackupWindowOptions` cmdlet. Specify the following settings:

   - Set the `$windowoptions` variable as the `Options` parameter value.
   - Specify the `FromDay` parameter value.
   - Specify the `FromHour` parameter value.
   - Specify the `ToDay` parameter value.
   - Specify the `ToHour` parameter value.
   - Provide the `$false` value for the `Enabled` parameter.
   - Provide the `PassThru` parameter.

   Save the result to the `$windowoptions` variable.

4. Run the [`Set-VBRJobSchedule`](set-vbrjobschedule.md) cmdlet. Specify the following settings:

   - Set the `$job` variable as the `Job` parameter value.
   - Set the `$windowoptions` variable as the `PeriodicallySchedule` parameter value.
   - Provide the `Periodicaly` parameter.
   - Specify the `FullPeriod` parameter value.
   - Set the `Hours` option for the `PeriodicallyKind` parameter.

:::

::: example
### Example 2. Extending Backup Window

This example shows how to modify the job backup window settings. The cmdlet will extend the backup window to specify when the backup job is allowed to run.

- The [`New-VBRBackupWindowOptions`](new-vbrbackupwindowoptions.md) cmdlet defines the following backup window settings: the job is allowed to run from 10:00 AM till 22.59 PM on Monday, Tuesday, Wednesday and Thursday.
- The `Set-VBRBackupWindowOptions` cmdlet modifies these settings. The backup window is extended from 10.00 AM till 12.59 AM on Friday and Saturday.

```
$job = Get-VBRJob -Name "Backup Job"
$windowoptions = New-VBRBackupWindowOptions -FromDay Monday -FromHour 10 -ToDay Thursday -ToHour 22 -Enabled
$windowoptions = Set-VBRBackupWindowOptions -Options $windowoptions -FromDay Friday -FromHour 10 -ToDay Saturday -ToHour 12 -Enabled -PassThru
Set-VBRJobSchedule -Job $job -Periodicaly -FullPeriod 6 -PeriodicallyKind Hours -PeriodicallySchedule $windowoptions
```

Perform the following steps:

1. Run the [`Get-VBRJob`](get-vbrjob.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$job` variable.
2. Run the [`New-VBRBackupWindowOptions`](new-vbrbackupwindowoptions.md) cmdlet. Specify the following settings:

   - Specify the `FromDay` parameter value.
   - Specify the `FromHour` parameter value.
   - Specify the `ToDay` parameter value.
   - Specify the `ToHour` parameter value.
   - Provide the `Enabled` parameter.

   Save the result to the `$windowoptions` variable.

3. Run the `Set-VBRBackupWindowOptions` cmdlet. Specify the following settings:

   - Set the `$windowoptions` variable as the `Options` parameter value.
   - Specify the `FromDay` parameter value.
   - Specify the `FromHour` parameter value.
   - Specify the `ToDay` parameter value.
   - Specify the `ToHour` parameter value.
   - Provide the `Enabled` parameter.
   - Provide the `PassThru` parameter.

   Save the result to the `$windowoptions` variable.

4. Run the [`Set-VBRJobSchedule`](set-vbrjobschedule.md) cmdlet. Specify the following settings:

   - Set the `$job` variable as the `Job` parameter value.
   - Provide the `Periodicaly` parameter.
   - Specify the `FullPeriod` parameter value.
   - Set the `Hours` option for the `PeriodicallyKind` parameter.
   - Set the `$windowoptions` variable as the `PeriodicallySchedule` parameter value.

:::

## Related Commands

- [`New-VBRBackupWindowOptions`](new-vbrbackupwindowoptions.md)
- [`Set-VBRJobSchedule`](set-vbrjobschedule.md)
- [`Get-VBRJob`](get-vbrjob.md)