Set-VBRHvCluster

Short Description

Modifies settings of a Hyper-V cluster.

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

Syntax

This cmdlet provides the following parameter sets:

Credentials (Default)

Set-VBRHvCluster -Server <CHost> [-Description <String>] [-Credentials <CCredentials>] [<CommonParameters>]
AddCredentials

Set-VBRHvCluster -Server <CHost> [-User <String>] [-Password <String>] [-Description <String>] [<CommonParameters>]

Detailed Description

Modifies settings of a Hyper-V cluster.

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
Credentials	Specifies the credentials you want to use for authenticating with the Hyper-V cluster. Accepts the `CCredentials` object. To get this object, run the `Get-VBRCredentials` cmdlet	`CCredentials`	False	Named	False
Description	Specifies the description of the Hyper-V cluster.	`String`	False	Named	False
Password	Specifies the password you want to use for authenticating with the Hyper-V cluster.	`String`	False	Named	False
Server	Specifies a Hyper-V cluster which settings you want to modify. Accepts the `CHost` object. To create this object, run the `Get-VBRServer` cmdlet.	`CHost`	True	Named	True (ByPropertyName, ByValue)
User	Specifies the user name you want to use for authenticating with the Hyper-V cluster.	`String`	False	Named	False

<CommonParameters>

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

Output Object

The cmdlet returns the CHost object that contains settings of the Hyper-V clusters added to the backup infrastructure.

Examples

Set-VBRHvCluster Example 1. Modifying Password of Hyper-V Cluster

This example shows how to change the password of the account used to add the HYPCLUSTER01 Hyper-V cluster to the backup infrastructure.

$Administrator = Get-VBRCredentials

$server = Get-VBRServer

Set-VBRHvCluster -Password "XXXXXXX" -Server $server

Perform the following steps:

Run the Get-VBRCredentials cmdlet. Save the result to the $Administrator variable.
Run the Get-VBRServer cmdlet. Save the result to the $server variable.
Run the Set-VBRHvCluster cmdlet. Specify the Password parameter value. Set the $server variable as the Server parameter value.

Set-VBRHvCluster Example 2. Modifying Credentials of Hyper-V Cluster

This example shows how modify credentials of the HYPCLUSTER01 Hyper-V cluster.

$Administrator = Get-VBRCredentials

$server = Get-VBRServer

Set-VBRHvCluster -Server $server -Credentials $Administrator

Perform the following steps:

Run the Get-VBRCredentials cmdlet. Save the result to the $Administrator variable.
Run the Get-VBRServer cmdlet. Save the result to the $server variable.
Run the Set-VBRHvCluster cmdlet. Set the $server variable as the Server parameter value. Set the $Administrator variable as the Credentials parameter value.