New-Cluster

Name	Type	Description	Required?	Pipeline Input	Default Value
Name	String	Specifies the name of the new cluster.	true	False
Confirm	SwitchParameter	If the value is $true, indicates that the cmdlet asks for confirmation before running. If the value is $false, the cmdlet runs without asking for user confirmation.	false	False
CryptoMode	CryptoMode	Specifies the cluster encryption mode. When set to OnDemand, hosts in the cluster are not required to be in a cryptographically "Safe" state. When set to ForceEnable, all hosts in the cluster are forced to be in a cryptographically "Safe", that is, vCenter Server has installed a host key on the host.	false	False
DrsAutomationLevel	DrsAutomationLevel	Specifies a DRS automation level. The valid values are FullyAutomated, Manual, and PartiallyAutomated.	false	False
DrsEnabled	SwitchParameter	If specified, enables VMware DRS.	false	False
DrsMode	DrsMode	This parameter is deprecated and scheduled for removal. Use the DrsAutomationLevel parameter instead. Specifies a DRS mode. The valid values are FullyAutomated, Manual, and PartiallyAutomated.	false	False
EVCMode	String	Specifies the VMware EVC mode of the newly created cluster. If not specified or set to $null, EVC is disabled.	false	False
HAAdmissionControlEnabled	SwitchParameter	Indicates that virtual machines cannot be powered on if they violate availability constraints.	false	False
HAEnabled	SwitchParameter	If specified, enables VMware HA.	false	False
HAFailoverLevel	Int32	Specifies a configured failover level. This is the number of physical host failures that can be tolerated without impacting the ability to meet minimum thresholds for all running virtual machines. The valid values are in the range of 1 to 4.	false	False
HAIsolationResponse	HAIsolationResponse	Indicates that the virtual machine should be powered off if a host determines that it is isolated from the rest of the compute resource. The valid values are PowerOff and DoNothing. Passing values to this parameter through a pipeline is deprecated and will be disabled in a future release.	false	False
HARestartPriority	HARestartPriority	Specifies the cluster HA restart priority. The valid values are Disabled, Low, Medium, and High. VMware HA is a feature that detects failed virtual machines and automatically restarts them on alternative ESX hosts. Passing values to this parameter through a pipeline is deprecated and will be disabled in a future release.	false	False
Location	VIContainer	Specifies the location where you want to place the new cluster. If a data center is specified for the Location parameter, the cluster is created in its "hostFolder" folder. The "hostFolder" is a system folder and is guaranteed to exist.	true	True (ByValue)
Server	VIServer[]	Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is given to this parameter, the command runs on the default servers. For more information about default servers, see the description of the Connect-VIServer cmdlet.	false	False
VMSwapfilePolicy	VMSwapfilePolicy	Specifies the swapfile placement policy. The following values are valid: InHostDataStore - stores the swapfile in the datastore that is specified by the VMSwapfileDatastoreID property of the virtual machine host. If the VMSwapfileDatastoreID property is not set or indicates a datastore with unsufficient free space, store the swapfile in the same directory as the virtual machine. This setting might degrade the vMotion performance. WithVM - stores the swapfile in the same directory as the virtual machine.	false	False
VsanDiskClaimMode	VsanDiskClaimMode	Specifies the mode by which disks are claimed by vSAN. If not specified and VsanEnabled is specified, the assumed value is Manual.	false	False
VsanEnabled	SwitchParameter	Indicates that the vSAN feature is enabled on this cluster.	false	False
WhatIf	SwitchParameter	Indicates that the cmdlet is run only to display the changes that would be made and actually no objects are modified.	false	False

-------------------------- Example 1 --------------------------

New-Cluster -Name "MyCluster" -Location "MyDatacenter"

Creates a new cluster named "MyCluster" in the "MyDatacenter" data center.

-------------------------- Example 2 --------------------------

New-Cluster -Name "MyCluster" -Location "MyDatacenter" -HAEnabled -HAAdmissionControlEnabled -HAFailoverLevel 2 -VMSwapfilePolicy "InHostDatastore" -HARestartPriority "Low" -HAIsolationResponse "PowerOff"

Creates a new cluster named "MyCluster" in the "MyDatacenter" data center with specified VMware Hgh Availability (HA) settings.

-------------------------- Example 3 --------------------------

New-Cluster -Name "MyCluster" -Location "MyDatacenter" -DRSEnabled -DRSAutomationLevel 'Manual'

Creates a new cluster named "MyCluster" in the "MyDatacenter" data center with specified VMware Distributed Resource Scheduler (DRS) settings.

-------------------------- Example 4 --------------------------

New-Cluster -Name "MyCluster" -Location "MyDatacenter" -EVCMode 'intel-nehalem'

Creates a new cluster named "MyCluster" in the "MyDatacenter" data center with specified VMware Enhanced vMotion Compatibility (EVC) settings.

-------------------------- Example 5 --------------------------

New-Cluster -Name "MyCluster" -Location "MyDatacenter" -CryptoMode 'ForceEnable'

Creates a new cluster named "MyCluster" in the "MyDatacenter" data center with the specified cluster encryption mode.

PowerCLI Reference

Synopsis