Install-SCVMHostCluster

Syntax

Install-SCVMHostCluster
       -VMHost <Host[]>
       -ClusterName <String>
       -Credential <VMMCredential>
       [-ClusterIPAddress <String[]>]
       [-ClusterIPAddressPool <StaticIPAddressPool[]>]
       [-ClusterReserve <Int32>]
       [-Description <String>]
       [-VMMServer <ServerConnection>]
       [-SetQuorumNodeMajority]
       [-SetQuorumDisk <ClientObject>]
       [-SkipValidation]
       [-JobGroup <Guid>]
       [-EnableS2D]
       [-RunAsynchronously]
       [-PROTipID <Guid>]
       [-JobVariable <String>]
       [<CommonParameters>]

Install-SCVMHostCluster
       -VMHost <Host[]>
       -VMHostCluster <HostCluster>
       -Credential <VMMCredential>
       [-VMMServer <ServerConnection>]
       [-SkipValidation]
       [-JobGroup <Guid>]
       [-EnableS2D]
       [-RunAsynchronously]
       [-PROTipID <Guid>]
       [-JobVariable <String>]
       [<CommonParameters>]

Install-SCVMHostCluster
       -PhysicalComputerConfig <PhysicalComputerConfig[]>
       -VMHostCluster <HostCluster>
       -Credential <VMMCredential>
       [-VMMServer <ServerConnection>]
       [-SkipValidation]
       [-JobGroup <Guid>]
       [-EnableS2D]
       [-RunAsynchronously]
       [-PROTipID <Guid>]
       [-JobVariable <String>]
       [<CommonParameters>]

Install-SCVMHostCluster
       -PhysicalComputerConfig <PhysicalComputerConfig[]>
       -ClusterName <String>
       -Credential <VMMCredential>
       [-ClusterIPAddress <String[]>]
       [-ClusterIPAddressPool <StaticIPAddressPool[]>]
       [-ClusterReserve <Int32>]
       [-Description <String>]
       [-VMMServer <ServerConnection>]
       [-SetQuorumNodeMajority]
       [-SkipValidation]
       [-JobGroup <Guid>]
       [-EnableS2D]
       [-RunAsynchronously]
       [-PROTipID <Guid>]
       [-JobVariable <String>]
       [<CommonParameters>]

Description

The Install-SCVMHostCluster cmdlet creates a failover cluster from Hyper-V hosts managed by Virtual Machine Manager (VMM). Install-SCVMHostCluster can also add a node to an existing cluster.

Examples

Example 1: Create a cluster from managed hosts

PS C:\> $RunAsAcct = Get-SCRunAsAccount -Name "RunAsAccount01"
PS C:\> $HostGroup = Get-SCVMHostGroup -Name "New York"
PS C:\> $Nodes = Get-SCVMHost | where {$_.Name -like "HostClus*" -and $_.VMHostGroup -eq $HostGroup}
PS C:\> Install-SCVMHostCluster -VMHost $Nodes -ClusterName "Cluster01" -Credential $RunAsAcct

The first command gets the Run As account named RunAsAccount01 and stores it in the $RunAsAcct variable.

The second command gets the host group object named New York and stores the object in the $HostGroup variable.

The third command gets the cluster nodes that begin with the name HostClus in the host group stored in $HostGroup. The command then stores the nodes in the $Nodes variable.

The last command creates the cluster and names it Cluster01.

Example 2: Create a hyper converge cluster from managed hosts

PS C:\> $RunAsAcct = Get-SCRunAsAccount -Name "RunAsAccount01"
PS C:\> $HostGroup = Get-SCVMHostGroup -Name "New York"
PS C:\> $Nodes = Get-SCVMHost | where {$_.Name -like "HostClus*" -and $_.VMHostGroup -eq $HostGroup}
PS C:\> Install-SCVMHostCluster -VMHost $Nodes -ClusterName "Cluster01" -Credential $RunAsAcct -EnableS2D

The first command gets the Run As account named RunAsAccount01, and then stores it in the $RunAsAcct variable.

The second command gets the host group object named New York, and then stores it in the $HostGroup variable.

The third command gets the cluster nodes that begin with the name HostClus in the host group stored in $HostGroup. The command stores the nodes in the $Nodes variable.

The last command creates hyper converged cluster and names it Cluster01.

Parameters

-ClusterIPAddress

-ClusterIPAddressPool

-ClusterName

-ClusterReserve

-Credential

-DCBSettings

-Description

-EnableS2D

-JobGroup

-JobVariable

-PhysicalComputerConfig

-PROTipID

-RunAsynchronously

-SetQuorumDisk

-SetQuorumNodeMajority

-SkipValidation

-VMHost

-VMHostCluster

-VMMServer

Outputs

VMHostCluster

This cmdlet returns a VMHostCluster object.

Related Links

• Add-SCVMHostCluster
• Get-SCVMHostCluster
• Move-SCVMHostCluster
• Read-SCVMHostCluster
• Remove-SCVMHostCluster
• Set-SCVMHostCluster
• Test-SCVMHostCluster
• Uninstall-SCVMHostCluster