---
title: "New-VBRJobOptions"
description: "Creates new job options. Platform: VMware, Hyper-V Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet provides the following parameter sets: AllParameterSets (Default) ForBackupJob ForReplicaJob This cmdlet re"
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/new-vbrjoboptions.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Jobs > Job Options > New-VBRJobOptions"
dateModified: "2026-08-19"
---

# New-VBRJobOptions

## Short Description
Creates new job options.

**Platform**: VMware, Hyper-V

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

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>AllParameterSets (Default)</code></p>

```
New-VBRJobOptions [<CommonParameters>]
```
  </li>
  <li>
    <p><code>ForBackupJob</code></p>

```
New-VBRJobOptions [-ForBackupJob] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>ForReplicaJob</code></p>

```
New-VBRJobOptions [-ForReplicaJob] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet returns the `CJobOptions` object. This object contains the default settings of the job you want to edit. You can customize any setting that you want to apply to a backup job, replication job or selected VMs.

Run the [`Set-VBRJobOptions`](set-vbrjoboptions.md) cmdlet to apply the modified options 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">ForBackupJob</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will return default settings for backup job.</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">ForReplicaJob</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will return default settings for replication job.</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).

## Examples

::: example
### Defining Retention Policy for Backup Job

This example shows how to define the retention policy for a backup job.

```
$retention = New-VBRJobOptions -ForBackupJob
$retention.BackupStorageOptions.RetainCycles = 7
$job = Get-VBRJob -Name "ABC Backup"
Set-VBRJobOptions -Job $job -Options $retention
```

Perform the following steps:

1. Run the `New-VBRJobOptions` cmdlet. Provide the `ForBackupJob` parameter. Save the result to the `$retention` variable.
2. Specify the `RetainCycles` parameter of the `BackupStorageOptions` object for the `$retention` variable.
3. Run the [`Get-VBRJob`](get-vbrjob.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$job` variable.
4. Run the [`Set-VBRJobOptions`](set-vbrjoboptions.md) cmdlet. Set the `$job` variable as the `Job` parameter value. Set the `$retention` variable as the `Options` parameter value.

:::

## Related Commands

- [`Get-VBRJob`](get-vbrjob.md)
- [`Set-VBRJobOptions`](set-vbrjoboptions.md)