---
title: "New-VBRMonthlyOptions"
description: "Creates a new VBRMonthlyOptions object. Platform: VMware, Hyper-V Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet creates the VBRMonhtlyOptions object."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/new-vbrmonthlyoptions.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Jobs > Job Schedule > New-VBRMonthlyOptions"
dateModified: "2026-08-19"
---

# New-VBRMonthlyOptions

## Short Description
Creates a new [`VBRMonthlyOptions`](vbrmonthlyoptions.md) object.

**Platform**: VMware, Hyper-V

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

## Syntax
```
New-VBRMonthlyOptions [-Period <TimeSpan>] [-DayNumberInMonth <VBRDayNumberInMonth>] [-DayOfWeek <DayOfWeek>]
 [-Months <VBRMonth[]>] [-DayOfMonth <String>] [<CommonParameters>]
```

## Detailed Description
This cmdlet creates the [`VBRMonhtlyOptions`](vbrmonthlyoptions.md) object. This object contains the monthly schedule job settings. You can use this object to set job schedule.

## 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">DayNumberInMonth</span></p>
        </td>
        <td>
          <p>Specifies the number of day in month (for example, Saturday):</p><ul><li><code>First</code>: the job will run on the first (Saturday) of the selected months.</li><li><code>Second</code>: the job will run on the second (Saturday) of the selected months.</li><li><code>Third</code>: the job will run on the third (Saturday) of the selected months.</li><li><code>Fourth</code>: the job will run on the fourth (Saturday) of the selected months.</li><li><code>Last</code>: the job will run on the last (Saturday) of the selected months.</li><li><code>OnDay</code>: the job will run on the selected day of the selected months. Use the <code>DayOfMonth</code> parameter to specify the day.</li></ul><p>Default: <code>Fourth</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRDayNumberInMonth</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">DayOfMonth</span></p>
        </td>
        <td>
          <p>Specifies the day in month: 1–31, Last.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</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">DayOfWeek</span></p>
        </td>
        <td>
          <p>Specifies the week day for the <code>DayNumberInMonth</code> parameter.</p><p>Default: <code>Saturday</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>DayOfWeek</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">Months</span></p>
        </td>
        <td>
          <p>Specifies the months on which the job will run:</p><ul><li><code>January</code></li><li><code>February</code></li><li><code>March</code></li><li><code>April</code></li><li><code>May</code></li><li><code>June</code></li><li><code>July</code></li><li><code>August</code></li><li><code>September</code></li><li><code>October</code></li><li><code>November</code></li><li><code>December</code></li></ul><p>Default: <code>all months</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRMonth[]</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">Period</span></p>
        </td>
        <td>
          <p>Specifies the time when the job will start.</p><p>Default: <code>22:00</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>TimeSpan</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
[`VBRMonthlyOptions`](vbrmonthlyoptions.md)

## Examples

::: example
### Example 1. Creating Schedule with Specific Day and Time

This command creates the schedule for a job to run at 23:00 on the second Wednesday every month.

```
New-VBRMonthlyOptions -DayNumberInMonth Second -DayOfWeek Wednesday -Period 23:00
```

:::

::: example
### Example 2. Creating Schedule to Run at 10:00 on Last Sunday of January and July

This command creates the schedule for a job to run at 10:00 on the last Sunday of January and July.

```
New-VBRMonthlyOptions -DayNumberInMonth Last -DayOfWeek Sunday -Period 10:00 -Months January, July
```

:::