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

# New-VBRJobScriptOptions

## Short Description
Creates new job script options.

**Platform**: VMware, Hyper-V

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

## Syntax
```
New-VBRJobScriptOptions [-PreScriptEnabled] [-PreCommand <String>] [-PostScriptEnabled] [-PostCommand <String>]
 [-Day <DayOfWeek[]>] [-Periodicity <VBRPeriodicityType>] [-Frequency <UInt32>] [<CommonParameters>]
```

## Detailed Description
This cmdlet creates the [`VBRJobScriptOptions`](vbrjobscriptoptions.md) object. This object contains pre-job and post-job script settings for backup jobs and replication jobs. You can use this object later to apply these settings to a job.

## 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">Day</span></p>
        </td>
        <td>
          <p>Specifies the value for the <code>Periodicity</code> parameter (the <code>Days</code> mode).</p><p>Specifies the days of week when the script will run.</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">Frequency</span></p>
        </td>
        <td>
          <p>Specifies the value for the <code>Periodicity</code> parameter (the <code>Cycles</code> mode).</p><p>The number of job runs after which the script must run.</p><p>Default: 1 backup session</p>
        </td>
        <td style="width:10%;">
          <p><code>UInt32</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">Periodicity</span></p>
        </td>
        <td>
          <p>Specifies the script run mode:</p><ul><li><code>Cycles</code>: use this option to run the script after a set number of job runs</li><li><code>Days</code>: use this option to run the script on set days</li></ul><p>Use the <code>Day</code> and the <code>Frequency</code> parameters to set the values.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRPeriodicityType</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">PostCommand</span></p>
        </td>
        <td>
          <p>Specifies the path to the post-job script.</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">PostScriptEnabled</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will run a script after the job.</p><p>Use the <code>PostCommand</code> parameter to set the path to the script.</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">PreCommand</span></p>
        </td>
        <td>
          <p>Specifies the path to the pre-job script.</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">PreScriptEnabled</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will run a script before the job.</p><p>Use the <code>PreCommand</code> parameter to set the path to the script.</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
[`VBRJobScriptOptions`](vbrjobscriptoptions.md)

## Examples

::: example
### Configuring Script Settings

This example shows how to configure script settings with the following options:

- A script runs before job and after job.
- Scripts run on Mondays.

```
$scriptoptions = New-VBRJobScriptOptions -PreScriptEnabled -PreCommand "C:\scripts\pre-script.bat" -PostScriptEnabled -PostCommand "C:\scripts\pre-script.bat" -Periodicity Days -Day Monday
```

Perform the following steps:

1. Run the `New-VBRJobScriptOptions` cmdlet. Specify the following settings:

   - Provide the `PreScriptEnabled` parameter.
   - Specify the `PreCommand` parameter value.
   - Provide the `PostScriptEnabled` parameter.
   - Specify the `PostCommand` parameter value.
   - Set the `Days` option for the `Periodicity` parameter.
   - Specify the `Day` parameter value.

   Save the result to the `$scriptoptions` variable.

:::