---
title: "New-VBOBackupWindowSettings"
description: "This cmdlet creates a backup window for a backup job or a backup copy job. The backup window sets a time period within which the job must be completed."
canonical: "https://helpcenter.veeam.com/docs/vbo365/powershell/new-vbobackupwindowsettings.html"
breadcrumb: "PowerShell Reference > Veeam Backup for Microsoft 365 PowerShell Reference > Data Backup > Backup Job Schedule > New-VBOBackupWindowSettings"
dateModified: "2026-08-21"
---

# New-VBOBackupWindowSettings

## Short Description
Creates a backup window.

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

## Detailed Description
This cmdlet creates a backup window for a backup job or a backup copy job. The backup window sets a time period within which the job must be completed.

You can use a backup window object when creating or modifying backup or backup copy job schedule settings.

## 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">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.

## Output Object
The cmdlet returns the [`VBOBackupWindowSettings`](vbobackupwindowsettings.md) object that contains the backup window settings.

## Examples

::: example
### Example 1: Creating Backup Window with Allowed Hours

This example shows how to create a backup window with allowed backup hours from 8 AM on Monday to 5 PM on Saturday and add it to the new job schedule.

```
$awindow = New-VBOBackupWindowSettings -FromDay Monday -FromHour 8 -ToDay Saturday -ToHour 17 -Enabled:$true
$daily = New-VBOJobSchedulePolicy -Type Daily -DailyType Everyday -DailyTime 08:00:00 -BackupWindowSettings $awindow
$job = Get-VBOJob -Name "ABC: Sales"
Set-VBOJob -Job $job -SchedulePolicy $daily
```

Perform the following steps:

1. Run the `New-VBOBackupWindowSettings` cmdlet to create a backup window within which the backup job is allowed to run. Save the result to the `$awindow` variable.
2. Run the [`New-VBOJobSchedulePolicy`](new-vbojobschedulepolicy.md) cmdlet with the `$awindow` variable to create the job schedule. Save the result to the `$daily` variable.
3. Run the [`Get-VBOJob`](get-vbojob.md) cmdlet to get a backup job whose schedule settings you want to modify. Save the result to the `$job` variable.
4. Run the [`Set-VBOJob`](set-vbojob.md) cmdlet with the `$job` and `$daily` variables to apply new schedule settings to the backup job.

:::

::: example
### Example 2: Creating Backup Window with Prohibited Hours

This example shows how to create a backup window with prohibited backup hours from 8 AM to 5 PM on Monday and add it to the new job schedule.

```
$pwindow = New-VBOBackupWindowSettings -FromDay Monday -FromHour 8 -ToDay Monday -ToHour 17 -Enabled:$false
$daily = New-VBOJobSchedulePolicy -Type Daily -DailyType Everyday -DailyTime 08:00:00 -BackupWindowSettings $pwindow
$job = Get-VBOJob -Name "ABC: Sales"
Set-VBOJob -Job $job -SchedulePolicy $daily
```

Perform the following steps:

1. Run the `New-VBOBackupWindowSettings` cmdlet to create a backup window within which the backup job is not allowed to run. Save the result to the `$pwindow` variable.
2. Run the [`New-VBOJobSchedulePolicy`](new-vbojobschedulepolicy.md) cmdlet with the `$pwindow` variable to create the job schedule. Save the result to the `$daily` variable.
3. Run the [`Get-VBOJob`](get-vbojob.md) cmdlet to get a backup job whose schedule settings you want to modify. Save the result to the `$job` variable.
4. Run the [`Set-VBOJob`](set-vbojob.md) cmdlet with the `$job` and `$daily` variables to apply new schedule settings to the backup job.

:::

::: example
### Example 3: Adding New Backup Window to Existing Backup Job Schedule

This example shows how to create a backup window and add it to the existing job schedule.

```
$job = Get-VBOJob -Name "ABC: Sales"
$schedule = $job.schedulepolicy
$bw = New-VBOBackupWindowSettings -FromDay Friday -FromHour 2 -ToDay Monday -ToHour 3 -Enabled:$true
$newschedule = Set-VBOJobSchedulePolicy -Policy $schedule -BackupWindowEnabled -BackupWindowSettings $bw
Set-VBOJob -Job $job -SchedulePolicy $newschedule
```

Perform the following steps:

1. Run the [`Get-VBOJob`](get-vbojob.md) cmdlet to get a backup job whose schedule 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. Run the `New-VBOBackupWindowSettings` cmdlet to create a backup window. Save the result to the `$bw` variable.
4. Run the [`Set-VBOJobSchedulePolicy`](set-vbojobschedulepolicy.md) cmdlet with the `$bw` variable to modify the job schedule settings. Save the result to the `$newschedule` variable.
5. Run the [`Set-VBOJob`](set-vbojob.md) cmdlet with the `$job` and `$newschedule` variables to apply new schedule settings to the backup job.

:::

## Related Commands

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