---
title: "Set-VBRJobAdvancedViOptions"
description: "This cmdlet sets special options for the selected VMware job. To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameters values with new values."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/set-vbrjobadvancedvioptions.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Jobs > Advanced Job Options > Set-VBRJobAdvancedViOptions"
dateModified: "2026-08-19"
---

# Set-VBRJobAdvancedViOptions

## Short Description
Customizes VMware job settings.

**Platform**: VMware

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

## Syntax
```
Set-VBRJobAdvancedViOptions -Job <CBackupJob[]> [-ExcludeSwapFile <Boolean>] [-VmAttributeName <String>]
 [-SetResultsToVmAttribute <Boolean>] [-EnableChangeTracking <Boolean>] [-UseChangeTracking <Boolean>]
 [-VMToolsQuiesce <Boolean>] [<CommonParameters>]
```

## Detailed Description
This cmdlet sets special options for the selected VMware job.

::: note

To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameters values 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">EnableChangeTracking</span></p>
        </td>
        <td>
          <p>Defines whether the changed block tracking will be enabled.</p><ul><li><code>True</code>: the changed block tracking will be enabled.</li><li><code>False</code>: the changed block tracking will be disabled.</li></ul><p>Default: <code>True</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>Boolean</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">ExcludeSwapFile</span></p>
        </td>
        <td>
          <p>Defines whether the swap file will be excluded from backup.</p><ul><li><code>True</code>: the swap file will be excluded from backup.</li><li><code>False</code>: the swap file will not be excluded from backup.</li></ul><p>Default: <code>True</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>Boolean</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">Job</span></p>
        </td>
        <td>
          <p>Specifies the array of jobs. The cmdlet will modify advanced VMware backup options of these jobs.</p><p>Accepts the <code>CBackupJob[]</code> object. To create this object, run the <a href="get-vbrjob.md"><code>Get-VBRJob</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CBackupJob[]</code></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">SetResultsToVmAttribute</span></p>
        </td>
        <td>
          <p>Defines whether the job results will be written to custom attributes field of the VM.</p><ul><li><code>True</code>: the job results will be written to custom attributes field of the VM.</li><li><code>False</code>: the job results will not be written to custom attributes field of the VM.</li></ul>
        </td>
        <td style="width:10%;">
          <p><code>Boolean</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">UseChangeTracking</span></p>
        </td>
        <td>
          <p>Defines whether the changed block tracking will be used even if CBT is disabled on the ESXi host.</p><ul><li><code>True</code>: the changed block tracking will be used.</li><li><code>False</code>: the changed block tracking will not be used.</li></ul><p>Default: <code>True</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>Boolean</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">VmAttributeName</span></p>
        </td>
        <td>
          <p>Specifies the custom attributes field name.</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">VMToolsQuiesce</span></p>
        </td>
        <td>
          <p>Defines whether the VMware quiescence mechanism will be enabled.</p><ul><li><code>True</code>: the VMware quiescence mechanism will be enabled.</li><li><code>False</code>: the VMware quiescence mechanism will not be enabled.</li></ul><p>Use this mechanism if the application-aware processing cannot be used.</p><p>Default: <code>False</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>Boolean</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
### Editing Advanced Job Settings to Specific Backup Job [Using Pipeline]

This example shows how to edit the advanced job settings to backup job named `Backup Job 01`:

- The VMware quiescence is enabled.
- The changed block data is enabled.
- The CBT is forced to use despite the ESXi host settings.
- The swap file is excluded form backup.

```
Get-VBRJob -Name "Backup Job 01" | Set-VBRJobAdvancedViOptions -VMToolsQuiesce $True -EnableChangeTracking $True -UseChangeTracking $True -ExcludeSwapFile $True
```

Perform the following steps:

1. Run the [`Get-VBRJob`](get-vbrjob.md) cmdlet. Specify the `Name` parameter value.
2. Pipe the cmdlet output to the `Set-VBRJobAdvancedViOptions` cmdlet. Specify the following settings:

   - Provide the `$True` value for the `VmToolsQuiesce` parameter.
   - Provide the `$True` value for the `EnableChangeTracking` parameter.
   - Provide the `$True` value for the `UseChangeTracking` parameter.
   - Provide the `$True` value for the `ExcludeSwapFile` parameter.

:::

## Related Commands

[`Get-VBRJob`](get-vbrjob.md)