< Back
New-Cluster
Post
NAME New-Cluster
SYNOPSIS
This cmdlet creates a new cluster.
SYNTAX
New-Cluster [-Name] <String> [-DrsAutomationLevel <DrsAutomationLevel>] [-DrsEnabled] [-DrsMode <DrsMode>]
[-EVCMode <String>] [-HAAdmissionControlEnabled] [-HAEnabled] [-HAFailoverLevel <Int32>] [-HAIsolationResponse
<HAIsolationResponse>] [-HARestartPriority <HARestartPriority>] -Location <VIContainer> [-Server <VIServer[]>]
[-VMSwapfilePolicy <VMSwapfilePolicy>] [-VsanDiskClaimMode <VsanDiskClaimMode>] [-VsanEnabled] [-Confirm]
[-WhatIf] [<CommonParameters>]
DESCRIPTION
This cmdlet creates a new cluster with the provided inputs, in the location that is specified by the Location
parameter. HAEnabled is automatically set to $true if some of the HA settings, HAAdmissionControlEnabled,
HAFailoverLevel, HARestartPriority, HAIsolationResponse, are specified . DrsEnabled is automatically set to $true
if some of the DRS settings, DrsAutomationLevel, DrsMode, are specified .
PARAMETERS
-DrsAutomationLevel <DrsAutomationLevel>
Specifies a DRS (Distributed Resource Scheduler) automation level. The valid values are FullyAutomated,
Manual, and PartiallyAutomated.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-DrsEnabled [<SwitchParameter>]
Indicates that VMware DRS (Distributed Resource Scheduler) is enabled.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-DrsMode <DrsMode>
This parameter is deprecated and scheduled for removal. Use the DrsAutomationLevel parameter instead.
Specifies a DRS (Distributed Resource Scheduler) mode. The valid values are FullyAutomated, Manual, and
PartiallyAutomated.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-EVCMode <String>
Specifies the VMware Enhanced vMotion Compatibility (EVC) mode of the newly created cluster. If not specified
or set to $null, EVC is disabled.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-HAAdmissionControlEnabled [<SwitchParameter>]
Indicates that virtual machines cannot be powered on if they violate availability constraints.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-HAEnabled [<SwitchParameter>]
Indicates that VMware HA (High Availability) is enabled.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? 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
range from 1 to 4.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? 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.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? 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.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Location <VIContainer>
Specifies the location where you want to place the new cluster. If a datacenter 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.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByValue)
Accept wildcard characters? true
-Name <String>
Specifies the name of the new cluster.
Required? true
Position? 1
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Server <VIServer[]>
Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is passed to this
parameter, the command runs on the default servers. For more information about default servers, see the
description of Connect-VIServer.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? true
-VMSwapfilePolicy <VMSwapfilePolicy>
Specifies the swapfile placement policy. The following values are valid:
InHostDataStore - Store 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 VMotion performance.
WithVM - Store the swapfile in the same directory as the virtual machine.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-VsanDiskClaimMode <VsanDiskClaimMode>
Specifies the mode by which disks are claimed by the Virtual SAN. If not specified and VsanEnabled is
specified, the assumed value is Manual.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-VsanEnabled [<SwitchParameter>]
Indicates that the Virtual SAN feature is enabled on this cluster.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? 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.
Required? false
Position? named
Default value $true
Accept pipeline input? False
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Indicates that the cmdlet is run only to display the changes that would be made and actually no objects are
modified.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
The newly created Cluster object
NOTES
-------------------------- Example 1 --------------------------
New-Cluster -Name "MyCluster" -Location "MyDatacenter"
Creates a new cluster named "MyCluster" in the "MyDatacenter" datacenter.
-------------------------- 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" datacenter, with specified VMware HA (Hgh
Availability) settings.
-------------------------- Example 3 --------------------------
New-Cluster -Name "MyCluster" -Location "MyDatacenter" -DRSEnabled -DRSAutomationLevel 'Manual'
Creates a new cluster named "MyCluster" in the "MyDatacenter" datacenter, with specified VMware DRS (Distributed
Resource Scheduler) settings.
-------------------------- Example 4 --------------------------
New-Cluster -Name "MyCluster" -Location "MyDatacenter" -EVCMode 'intel-nehalem'
Creates a new cluster named "MyCluster" in the "MyDatacenter" datacenter, with specified VMware EVC (Enhanced
vMotion Compatibility) settings.
RELATED LINKS
Online Version: https://code.vmware.com/doc/preview?id= ... uster.html
Get-Cluster
Move-Cluster
Remove-Cluster
Set-Cluster
SYNOPSIS
This cmdlet creates a new cluster.
SYNTAX
New-Cluster [-Name] <String> [-DrsAutomationLevel <DrsAutomationLevel>] [-DrsEnabled] [-DrsMode <DrsMode>]
[-EVCMode <String>] [-HAAdmissionControlEnabled] [-HAEnabled] [-HAFailoverLevel <Int32>] [-HAIsolationResponse
<HAIsolationResponse>] [-HARestartPriority <HARestartPriority>] -Location <VIContainer> [-Server <VIServer[]>]
[-VMSwapfilePolicy <VMSwapfilePolicy>] [-VsanDiskClaimMode <VsanDiskClaimMode>] [-VsanEnabled] [-Confirm]
[-WhatIf] [<CommonParameters>]
DESCRIPTION
This cmdlet creates a new cluster with the provided inputs, in the location that is specified by the Location
parameter. HAEnabled is automatically set to $true if some of the HA settings, HAAdmissionControlEnabled,
HAFailoverLevel, HARestartPriority, HAIsolationResponse, are specified . DrsEnabled is automatically set to $true
if some of the DRS settings, DrsAutomationLevel, DrsMode, are specified .
PARAMETERS
-DrsAutomationLevel <DrsAutomationLevel>
Specifies a DRS (Distributed Resource Scheduler) automation level. The valid values are FullyAutomated,
Manual, and PartiallyAutomated.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-DrsEnabled [<SwitchParameter>]
Indicates that VMware DRS (Distributed Resource Scheduler) is enabled.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-DrsMode <DrsMode>
This parameter is deprecated and scheduled for removal. Use the DrsAutomationLevel parameter instead.
Specifies a DRS (Distributed Resource Scheduler) mode. The valid values are FullyAutomated, Manual, and
PartiallyAutomated.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-EVCMode <String>
Specifies the VMware Enhanced vMotion Compatibility (EVC) mode of the newly created cluster. If not specified
or set to $null, EVC is disabled.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-HAAdmissionControlEnabled [<SwitchParameter>]
Indicates that virtual machines cannot be powered on if they violate availability constraints.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-HAEnabled [<SwitchParameter>]
Indicates that VMware HA (High Availability) is enabled.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? 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
range from 1 to 4.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? 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.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? 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.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Location <VIContainer>
Specifies the location where you want to place the new cluster. If a datacenter 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.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByValue)
Accept wildcard characters? true
-Name <String>
Specifies the name of the new cluster.
Required? true
Position? 1
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Server <VIServer[]>
Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is passed to this
parameter, the command runs on the default servers. For more information about default servers, see the
description of Connect-VIServer.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? true
-VMSwapfilePolicy <VMSwapfilePolicy>
Specifies the swapfile placement policy. The following values are valid:
InHostDataStore - Store 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 VMotion performance.
WithVM - Store the swapfile in the same directory as the virtual machine.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-VsanDiskClaimMode <VsanDiskClaimMode>
Specifies the mode by which disks are claimed by the Virtual SAN. If not specified and VsanEnabled is
specified, the assumed value is Manual.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-VsanEnabled [<SwitchParameter>]
Indicates that the Virtual SAN feature is enabled on this cluster.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? 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.
Required? false
Position? named
Default value $true
Accept pipeline input? False
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Indicates that the cmdlet is run only to display the changes that would be made and actually no objects are
modified.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
The newly created Cluster object
NOTES
-------------------------- Example 1 --------------------------
New-Cluster -Name "MyCluster" -Location "MyDatacenter"
Creates a new cluster named "MyCluster" in the "MyDatacenter" datacenter.
-------------------------- 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" datacenter, with specified VMware HA (Hgh
Availability) settings.
-------------------------- Example 3 --------------------------
New-Cluster -Name "MyCluster" -Location "MyDatacenter" -DRSEnabled -DRSAutomationLevel 'Manual'
Creates a new cluster named "MyCluster" in the "MyDatacenter" datacenter, with specified VMware DRS (Distributed
Resource Scheduler) settings.
-------------------------- Example 4 --------------------------
New-Cluster -Name "MyCluster" -Location "MyDatacenter" -EVCMode 'intel-nehalem'
Creates a new cluster named "MyCluster" in the "MyDatacenter" datacenter, with specified VMware EVC (Enhanced
vMotion Compatibility) settings.
RELATED LINKS
Online Version: https://code.vmware.com/doc/preview?id= ... uster.html
Get-Cluster
Move-Cluster
Remove-Cluster
Set-Cluster