---
title: "Set-VBRScriptProcessingOptions"
description: "This cmdlet modifies pre-freeze and post-thaw scripts settings for the protected computer OS quiescence. To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameter values with new values."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/set-vbrscriptprocessingoptions.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Veeam Agent Management > Working with Veeam Agent Backup Jobs and Policies > Veeam Agent Job Guest Processing Options > Set-VBRScriptProcessingOptions"
dateModified: "2026-08-19"
---

# Set-VBRScriptProcessingOptions

## Short Description
Modifies pre-freeze and post-thaw scripts settings for Veeam Agent backup jobs.

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

## Syntax
```
Set-VBRScriptProcessingOptions -Options <VBRScriptProcessingOptions> [-Credentials <CCredentials>]
 [-ProcessingAction <VBRGeneralProcessingAction>] [-ScriptPrefreezeCommand <String>]
 [-ScriptPostthawCommand <String>] [-ScriptPreJobCommand <String>] [-ScriptPostJobCommand <String>] [<CommonParameters>]
```

## Detailed Description
This cmdlet modifies pre-freeze and post-thaw scripts settings for the protected computer OS quiescence.

::: note

To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameter 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">Credentials</span></p>
        </td>
        <td>
          <p>Specifies the user account credentials with local administrator privileges on the VM guest OS. Veeam Backup & Replication will use these credentials to run pre-freeze and post-thaw scripts.</p><p>By default, Veeam Agent for Microsoft Windows will use the credentials that you specified for the protection group.</p><p><strong>Note</strong>: This option works for Veeam Agent jobs that back up Windows computers only.</p>
        </td>
        <td style="width:10%;">
          <p><code>CCredentials</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">Options</span></p>
        </td>
        <td>
          <p>Specifies script processing options that you want to modify.</p><p>Accepts the <code>VBRScriptProcessingOptions</code> object. To get this object, run the<a href="new-vbrscriptprocessingoptions.md"><code> New-VBRScriptProcessingOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRScriptProcessingOptions</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 (ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">ProcessingAction</span></p>
        </td>
        <td>
          <p>Specifies script processing settings.</p><ul><li><code>DisableCompletely</code>: use this option if you do not want to run scripts.</li><li><code>IgnoreFailures</code>: use this option if you want to continue the backup process even if script errors occur.</li><li><code>RequireSuccess</code>: use this option if you want Veeam Backup & Replication to stop the backup process if the script fails.</li></ul><p><strong>Note</strong>: The <code>IgnoreFailures</code> option does not work for Veeam Agent backup jobs that back up Linux computers. Use the <code>RequireSuccess</code> option to enable script execution for these types of jobs.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRGeneralProcessingAction</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">ScriptPostJobCommand</span></p>
        </td>
        <td>
          <p>Specifies a post-freeze 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">ScriptPostthawCommand</span></p>
        </td>
        <td>
          <p>Specifies the path on your backup server to a local folder with the post-thaw 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">ScriptPrefreezeCommand</span></p>
        </td>
        <td>
          <p>Specifies the path on your backup server to a local folder with the pre-freeze 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">ScriptPreJobCommand</span></p>
        </td>
        <td>
          <p>Specifies a post-thaw 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>
    </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
This cmdlet returns the `VBRScriptProcessingOptions` object that contains pre-freeze and post-thaw scripts settings for Veeam Agent backup jobs.

## Examples

::: example
### Modifying Script Processing Settings for Veeam Agent Job (Windows)

This example shows how to modify the existing script processing settings for a Veeam Agent job that backs up Windows computers.

```
$script = New-VBRScriptProcessingOptions -ProcessingAction IgnoreFailures -ScriptPrefreezeCommand "C:\script\pre-script.bat" -ScriptPostthawCommand "C:\script\post-script.bat"
Set-VBRScriptProcessingOptions -Options $script -ProcessingAction RequireSuccess
```

Perform the following steps:

1. Run the [`New-VBRScriptProcessingOptions`](new-vbrscriptprocessingoptions.md) cmdlet. Set the `IgnoreFailures` option for the `ProcessingAction` parameter. Specify the `ScriptPrefreezeCommand` and `ScriptPostthawCommand` parameter values. Save the result to the `$script` variable.
2. Run the `Set-VBRScriptProcessingOptions` cmdlet. Set the `$script` variable as the `Options` parameter value. Set the `RequireSuccess` option for the `ProcessingAction` parameter.

:::

## Related Commands

[`New-VBRScriptProcessingOptions`](new-vbrscriptprocessingoptions.md)