New-VBRScriptProcessingOptions - Veeam Backup PowerShell Reference

New-VBRScriptProcessingOptions -ProcessingAction <VBRGeneralProcessingAction> {DisableCompletely | IgnoreFailures | RequireSuccess} [-Credentials <CCredentials>] [-ScriptPrefreezeCommand <string>] [-ScriptPostthawCommand <string>] [-ScriptPreJobCommand <string>] [-ScriptPostJobCommand <string>] [<CommonParameters>]

Parameter	Description	Type	Required	Position	Accept Pipeline Input
ProcessingAction	Specifies script processing settings: IgnoreFailures: use this option if you want to continue the backup process even if script errors occur. RequireSuccess: use this option if you want Veeam Backup & Replication to stop the backup process if the scripts fail. DisableCompletely: use this option if you do not want to run scripts. Note: The IgnoreFailures option does not work for Veeam Agent jobs that back up Linux computers. Use the RequireSuccess option to enable script execution for these types of jobs.	VBRGeneralProcessingAction	True	Named	False
Credentials	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. By default, Veeam Agent for Microsoft Windows will use the credentials that you specified for the protection group. Note: this option works for Veeam Agent jobs that back up Windows computers only.	Accepts the CCredentials object. To get this object, run the Get-VBRCredentials cmdlet.	False	Named	False
ScriptPrefreezeCommand	Specifies the path on your backup server to a local folder with the pre-freeze script.	String	False	Named	False
ScriptPostthawCommand	Specifies the path on your backup server to a local folder with the post-thaw script.	String	False	Named	False
ScriptPreJobCommand	Specifies a post-thaw script.	String	False	Named	False
ScriptPostJobCommand	Specifies a post-freeze script.	String	False	Named	False

This command creates script processing settings for a Veeam Agent job that backs up Linux computers. The job will run with the following options:

Veeam Backup & Replication will run the pre-freeze script before the job starts to quiesce the protected computer OS.
Veeam Backup & Replication will run the post-thaw script after the snapshot is created to bring the protected computer back to the initial state.

New-VBRScriptProcessingOptions -ProcessingAction RequireSuccess -ScriptPrefreezeCommand "C:\scripts\pre-script.bat" -ScriptPostthawCommand "C:\scripts\post-script.bat"

This example shows how to create script processing settings for a Veeam Agent job that backs up Windows computers. The job will run with the following options:

Veeam Backup & Replication will use the user account credentials to run pre-freeze and post-thaw scripts.
Veeam Backup & Replication will continue to run the job even if scripts fail.

$creds = Get-VBRCredentials

New-VBRScriptProcessingOptions -ProcessingAction IgnoreFailures -ScriptPrefreezeCommand "C:\script\pre-script.bat" -ScriptPostthawCommand "C:\script\post-script.bat" -Credentials $creds

Perform the following steps:

Run the Get-VBRCredentials cmdlet. Save the result to the $creds variable.
Run the New-VBRScriptProcessingOptions cmdlet. Specify the following settings:

Set the IgnoreFailures option for the ProcessingAction parameter.
Specify the ScriptPrefreezeCommand parameter value.
Specify the ScriptPostthawCommand parameter value.
Set the $creds variable as the Credentials parameter value.