This is an archive version of the document. To get the most up-to-date information, see the current version.

Add-VBRHvCluster

In this article

Short Description

Adds a Hyper-V cluster to Veeam Backup & Replication.

Applies to

Platform: Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus

Syntax

Add-VBRHvCluster -Name <String> -User <String> -Password <String> [-Description <String>] [-WarningAction <ActionPreference>] [-WarningVariable <String>] [<CommonParameters>]

-OR-

Add-VBRHvCluster -Name <String> [-Description <String>] -Credentials <CCredentials> [-WarningAction <ActionPreference>] [-WarningVariable <String>] [<CommonParameters>]

Related Commands

Get-VBRCredentials

Detailed Description

This cmdlet adds Hyper-V clusters to the Veeam Backup & Replication managing console.

If you include your virtual machines in clusters, you need to add the clusters to Veeam Backup & Replication to be able to manage your virtual infrastructure via Veeam Backup & Replication console. When you add a cluster, you start managing the VMs that are part of the cluster automatically.

When you remove a Hyper-V cluster from Veeam Backup & Replication managing console, the VMs that are part of the cluster are removed too. If you want to manage individual VMs with Veeam Backup & Replication, you need to add them as standalone Hyper-V hosts.

Run Add-VBRHvHost to add a standalone Hyper-V host to Veeam Backup & Replication.

When adding a new Hyper-V cluster, you will need to provide either username and password or credentials. This cmdlet provides parameter sets for both scenarios accordingly. When you provide authentication with the Hyper-V cluster, you get equal rights for all clustered VMs.

Parameters

Parameter	Description	Required	Position	Accept Pipeline Input	Accept Wildcard Characters
Name	Specifies the string with the DNS name of the added Hyper-V cluster.	True	Named	False	False
User	Specifies the user name you want to use for authenticating with the Hyper-V cluster. If you use the Username/Password scenario, the -Credentials parameter must be omitted.	True	Named	False	False
Password	Specifies the password you want to use for authenticating with the Hyper-V cluster. If you use the Username/Password scenario, the -Credentials parameter must be omitted.	True	Named	False	False
Description	Specifies the description of the Hyper-V cluster. If not set, Veeam Backup & Replication will enter date and time of creation by default.	False	Named	False	False
Credentials	Specifies the credentials you want to use for authenticating with the Hyper-V cluster. If you use the Credentials scenario, the -User and -Password parameters must be omitted.	True	Named	False	False

This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.

Example 1

This command adds a new Hyper-V cluster named "HYPCLUSTER01" using username and password. The user name is "Administrator", and the password is "Password". The description is "Hyper-V Cluster 01".

Add-VBRHvCluster -Name "HYPCLUSTER01" -User Administrator -Password Password -Description "Hyper-V Cluster 01"

Example 2

This command adds a new Hyper-V cluster named "HYPCLUSTER01" using credentials. The credentials object is obtained with Get-VBRCredentials and assigned to the $Administrator variable beforehand. The description is "Hyper-V Cluster 01".

Add-VBRHvCluster -Name "HYPCLUSTER01" -Description "Hyper-V Cluster 01" -Credentials $Administrator