Set-VBRJobAdvancedHvOptions

Short Description

Customizes Hyper-V job settings.

Platform: Hyper-V

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

Syntax

Set-VBRJobAdvancedHvOptions -Job <CBackupJob[]> [-CanDoCrashConsistent <Boolean>]

[-EnableHvQuiescence <Boolean>] [-UseChangeTracking <Boolean>] [-ExcludeSwapFile <Boolean>] [<CommonParameters>]

Detailed Description

This cmdlet sets special options for the selected Hyper-V job.

In case you cannot use application-aware image processing, you can enable a Hyper-V quiescence mechanism to backup data that can be changed during the backup.

Read more about Hyper-V job settings in Veeam Backup & Replication User Guide for Microsoft Hyper-V.

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

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
CanDoCrashConsistent	Defines whether the job will create crash consistent backup.	`Boolean`	False	Named	False
EnableHvQuiescence	Defines whether the job will use the Hyper-V quiescence mechanism.	`Boolean`	False	Named	False
ExcludeSwapFile	Defines whether the job will exclude the swap file from backup.	`Boolean`	False	Named	False
Job	Specifies the array of jobs. The cmdlet will modify advanced Hyper-V backup options of these jobs. Accepts the `CBackupJob[]` object. To create this object, run the `Get-VBRJob` cmdlet.	`CBackupJob[]`	True	Named	True (ByPropertyName, ByValue)
UseChangeTracking	Defines whether the job will use the changed block tracking.	`Boolean`	False	Named	False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Examples

Editing Advanced Job Settings to Specific Backup Job [Using Pipeline]

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

The Hyper-V quiescence is enabled.
The crash consistent backup is enabled.
The changed block data is enabled.
The swap file is excluded form backup.

Get-VBRJob -Name "Backup Job 01" | Set-VBRJobAdvancedHvOptions -EnableHvQuiescence $True -CanDoCrashConsistent $True -UseChangeTracking $True -ExcludeSwapFile $True

Perform the following steps:

Run the Get-VBRJob cmdlet. Specify the Name parameter value.
Pipe the cmdlet output to the Set-VBRJobAdvancedHvOptions cmdlet. Specify the following settings:
- Provide the $True value for the EnableHVQuiescence parameter.
- Provide the $True value for the CanDoCrashConsistent parameter.
- Provide the $True value for the UseChangeTracking parameter.
- Provide the $True value for the ExcludeSwapFile parameter.

Get-VBRJob