---
title: "Set-VBOBackupWindowSettings"
description: "This cmdlet modifies the backup window settings. You can use a backup window object when creating or modifying backup job and backup copy job schedule settings."
canonical: "https://helpcenter.veeam.com/docs/vbo365/powershell/set-vbobackupwindowsettings.html"
breadcrumb: "PowerShell Reference > Veeam Backup for Microsoft 365 PowerShell Reference > Data Backup > Backup Job Schedule > Set-VBOBackupWindowSettings"
dateModified: "2026-08-21"
---

# Set-VBOBackupWindowSettings

## Short Description
Modifies the backup window settings.

## Syntax
```
Set-VBOBackupWindowSettings -Settings <VBOBackupWindowSettings> -FromDay <DayOfWeek> -FromHour <Int32>
 -ToDay <DayOfWeek> -ToHour <Int32> [-Enabled] [<CommonParameters>]
```

## Detailed Description
This cmdlet modifies the backup window settings. You can use a backup window object when creating or modifying backup job and backup copy job schedule settings. For more information on how to create backup job and backup copy job schedule settings, see the [`New-VBOJobSchedulePolicy`](new-vbojobschedulepolicy.md) and [`New-VBOCopyJobSchedulePolicy`](new-vbocopyjobschedulepolicy.md) cmdlets.

To modify settings, you need to enter the necessary parameters 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 create a backup window with allowed backup hours.</p><p>Default: <em>False</em></p><p>If this parameter is set to <em>false</em>, the cmdlet will create a backup window with prohibited backup hours.</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.</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.</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">Settings</span></p>
        </td>
        <td>
          <p>Specifies a backup window that you want to modify.</p><p>Accepts the <a href="vbobackupwindowsettings.md"><code>VBOBackupWindowSettings</code></a> object.</p><p>To create this object, run the <a href="new-vbobackupwindowsettings.md"><code>New-VBOBackupWindowSettings</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbobackupwindowsettings.md"><code>VBOBackupWindowSettings</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">ToDay</span></p>
        </td>
        <td>
          <p>Specifies the day of the week on which the backup window ends.</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.</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 the [About Common Parameters](http://go.microsoft.com/fwlink/p/?LinkID=113216) section of Microsoft Learn.

## Examples

::: example
### Example 1: Adding Allowed Backup Hours to Backup Window

This example shows how to add allowed backup hours to the backup window of the existing job.

```
$job = Get-VBOJob -Name "ABC: Sales"
$schedule = $job.SchedulePolicy
$awindow = $schedule.BackupWindowSettings
$newawindow = Set-VBOBackupWindowSettings -Settings $awindow -FromDay Saturday -FromHour 8 -ToDay Saturday -ToHour 17 -Enabled:$true
$newschedule = Set-VBOJobSchedulePolicy -Policy $schedule -BackupWindowEnabled -BackupWindowSettings $newawindow
Set-VBOJob -Job $job -SchedulePolicy $newschedule
```

Perform the following steps:

1. Get the backup window of the existing job:

   1. Run the [`Get-VBOJob`](get-vbojob.md) cmdlet to get a backup job whose backup window settings you want to modify. Save the result to the `$job` variable.
   2. Get the job schedule settings. Use the `SchedulePolicy` property of the job object saved to the `$job` variable. Save the result to the `$schedule` variable.
   3. Get the backup window. Use the `BackupWindowSettings` property of the schedule policy object saved to the `$schedule` variable. Save the result to the `$awindow` variable.

2. Run the `Set-VBOBackupWindowSettings` cmdlet with the `$awindow` variable to modify the backup window settings. Save the result to the `$newawindow` variable.
3. Apply the new backup window settings to the backup job schedule:

   1. Run the [`Set-VBOJobSchedulePolicy`](set-vbojobschedulepolicy.md) cmdlet with the `$schedule` and `$newawindow` variables to modify the job schedule settings. Save the result to the `$newschedule` variable.
   2. Run the [`Set-VBOJob`](set-vbojob.md) cmdlet with the `$job` and `$newschedule` variables.

:::

::: example
### Example 2: Adding Prohibited Backup Hours to Backup Window

This example shows how to add prohibited backup hours to the backup window of the existing job.

```
$job = Get-VBOJob -Name "ABC: Sales"
$schedule = $job.SchedulePolicy
$pwindow = $schedule.BackupWindowSettings
$newpwindow = Set-VBOBackupWindowSettings -Settings $pwindow -FromDay Monday -FromHour 12 -ToDay Monday -ToHour 13 -Enabled:$false
$newschedule = Set-VBOJobSchedulePolicy -Policy $schedule -BackupWindowEnabled -BackupWindowSettings $newpwindow
Set-VBOJob -Job $job -SchedulePolicy $newschedule
```

Perform the following steps:

1. Get the backup window of the existing job:

   1. Run the [`Get-VBOJob`](get-vbojob.md) cmdlet to get a backup job whose backup window settings you want to modify. Save the result to the `$job` variable.
   2. Get the job schedule settings. Use the `SchedulePolicy` property of the job object saved to the `$job` variable. Save the result to the `$schedule` variable.
   3. Get the backup window. Use the `BackupWindowSettings` property of the schedule policy object saved to the `$schedule` variable. Save the result to the `$pwindow` variable.

2. Run the `Set-VBOBackupWindowSettings` cmdlet with the `$pwindow` variable to modify the backup window settings. Save the result to the `$newpwindow` variable.
3. Apply the new backup window settings to the backup job schedule:

   1. Run the [`Set-VBOJobSchedulePolicy`](set-vbojobschedulepolicy.md) cmdlet with the `$schedule` and `$newpwindow` variables to modify the job schedule settings. Save the result to the `$newschedule` variable.
   2. Run the [`Set-VBOJob`](set-vbojob.md) cmdlet with the `$job` and `$newschedule` variables.

:::

## Related Commands

- [`Set-VBOJobSchedulePolicy`](set-vbojobschedulepolicy.md)
- [`Get-VBOJob`](get-vbojob.md)
- [`Set-VBOJob`](set-vbojob.md)