Set-VBRHvServerVolume

Short Description

Modifies volume-specific settings for Microsoft Hyper-V hosts.

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

Syntax

Set-VBRHvServerVolume -Volume <VBRHvServerVolumeObject[]> [-VSSProvider <VSSProviderObject>]

[-MaxSnapshots <Int32>] [<CommonParameters>]

Detailed Description

This cmdlet modifies volume-specific settings for Microsoft Hyper-V hosts.

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

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
MaxSnapshots	Specifies a number of snapshots that you can store simultaneously for one volume. The cmdlet will set the specified number of snapshots for the volume.	`Int32`	False	Named	True (ByPropertyName, ByValue)
Volume	Specifies an array of volume-specific settings for Microsoft Hyper-V hosts. The cmdlet will modify these settings. Accepts the `VBRHvServerVolumeObject[]` object. To create this object, run the `Get-VBRHvServerVolume` cmdlet.	`VBRHvServerVolumeObject[]`	True	Named	True (ByPropertyName, ByValue)
VSSProvider	Specifies the VSS provider for a volume. The cmdlet will set this VSS provider to take a VSS snapshot of the volume. Accepts the `VSSProviderObject` object. To create this object, run the `Get-VBRHvVssProvider` cmdlet.	`VSSProviderObject`	False	Named	True (ByPropertyName, ByValue)

<CommonParameters>

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

Output Object

The cmdlet returns the VBRHvServerVolume object that contains volume-specific settings for Microsoft Hyper-V hosts.

Examples

Set-VBRHvServerVolume Example 1. Modifying VSS Provider Settings

This example shows how to modify volume-specific settings and set a VSS provider for a volume located on the Microsoft Hyper-V host. Veeam Backup & Replication will use the Microsoft File Share Shadow Copy provider to create VSS snapshots of the volume.

$server = Get-VBRServer -Name hyperv09.tech.local

$volume = Get-VBRHvServerVolume -Server $server

$provider = Get-VBRHvVssProvider -Server $server -Name "Microsoft File Share Shadow Copy provider"

Set-VBRHvServerVolume -Volume $volume -VSSProvider $provider

Perform the following steps:

Get the volume settings:
1. Run the Get-VBRServer cmdlet. Specify the Name parameter value. Save the result to the $server variable.
2. Run the Get-VBRHvServerVolume cmdlet. Set the $server variable as the Server parameter value. Save the result to the $volume variable.
Run the Get-VBRHvVssProvider cmdlet. Set the $server variable as the Server parameter value. Specify the Name parameter value. Save the result to the $provider variable.
Run the Set-VBRHvServerVolume cmdlet. Set the $volume variable as the Volume parameter value. Set the $provider variable as the VSSProvider parameter value.

Set-VBRHvServerVolume Example 2. Modifying Number of Snapshots

This example shows how to modify volume-specific settings and set a number of snapshots that you can store simultaneously on one volume. Veeam Backup & Replication will store a maximum 3 snapshots on the volume.

$server = Get-VBRServer -Name hyperv09.tech.local

$volume = Get-VBRHvServerVolume -Server $server

Set-VBRHvServerVolume -Volume $volume -MaxSnapshots 3

Perform the following steps:

Get the volume settings:
1. Run the Get-VBRServer cmdlet. Specify the Name parameter value. Save the result to the $server variable.
2. Run the Get-VBRHvServerVolume cmdlet. Set the $server variable as the Server parameter value. Save the result to the $volume variable.
Run the Set-VBRHvServerVolume cmdlet. Set the $volume variable as the Volume parameter value. Specify the MaxSnapshots parameter value.