New-Cluster
Create a new failover cluster. Before you can create a cluster, you must connect the hardware (servers, networks, and storage), and run the validation tests.
New-Cluster [-Name] <string> [-IgnoreNetwork <StringCollection>] [-Node <StringCollection>] [-NoStorage] [-StaticAddress <StringCollection>] [<CommonParameters>]
Name
IgnoreNetwork
Node
NoStorage
StaticAddress
Use Test-Cluster to run the validation tests. That will confirm that your hardware and settings are compatible with failover clustering. There are four types of tests: Inventory, System Configuration, Network, and Storage.
Specifies which networks to ignore during the operation. Networks with DHCP enabled are always included. Other networks need a static address to be specified using the -StaticAddress parameter or should be explicitly ignored with this -IgnoreNetwork parameter.
Default Value: **
Data Type: StringCollection
Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
false |
required |
Variable Length? |
false |
variableLength |
Accept wildcard characters? |
false |
globbing |
Accept Pipeline Input? |
false |
pipelineInput |
Position? |
named |
position |
Value Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
true |
required |
Variable Length? |
false |
variableLength |
Specifies the name of the cluster to create.
Default Value: **
Data Type: string
Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
true |
required |
Variable Length? |
false |
variableLength |
Accept wildcard characters? |
false |
globbing |
Accept Pipeline Input? |
false |
pipelineInput |
Position? |
1 |
position |
Value Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
true |
required |
Variable Length? |
false |
variableLength |
Specifies a comma-separated list of cluster node names to create the cluster on. If this parameter is not specified a one node cluster is created on the local host.
Default Value: **
Data Type: StringCollection
Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
false |
required |
Variable Length? |
false |
variableLength |
Accept wildcard characters? |
false |
globbing |
Accept Pipeline Input? |
false |
pipelineInput |
Position? |
named |
position |
Value Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
true |
required |
Variable Length? |
false |
variableLength |
Causes the cluster creation to ignore shared storage. The cluster created at the end of the operation will not have shared storage. This can later be added using the "Get-ClusterAvailableDisk | Add-ClusterDisk" command.
Default Value: **
Data Type: SwitchParameter
Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
false |
required |
Variable Length? |
false |
variableLength |
Accept wildcard characters? |
false |
globbing |
Accept Pipeline Input? |
false |
pipelineInput |
Position? |
named |
position |
Value Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
false |
required |
Variable Length? |
false |
variableLength |
Specifies the static address(es) to use during the operation. Networks with DHCP enabled are always included. Other networks need a static address to be specified using the -StaticAddress parameter or should be explicitly ignored with this -IgnoreNetwork parameter.
Default Value: **
Data Type: StringCollection
Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
false |
required |
Variable Length? |
false |
variableLength |
Accept wildcard characters? |
false |
globbing |
Accept Pipeline Input? |
false |
pipelineInput |
Position? |
named |
position |
Value Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
true |
required |
Variable Length? |
false |
variableLength |
Command Prompt: C:\PS>
New-Cluster -Name cluster1 -Node node1,node2,node3,node4
Name
----
cluster1
Description
-----------
This command creates a four-node cluster named cluster1, using default settings for IP addressing.
Command Prompt: C:\PS>
New-Cluster -Name cluster1 -Node node1,node2 -NoStorage
Name
----
cluster1
Description
-----------
This command creates a two-node cluster named cluster1. The cluster will not have any clustered storage (disk resources). You can add storage later using Get-ClusterAvailableDisk with Add-ClusterDisk.
Command Prompt: C:\PS>
New-Cluster -Name cluster1 -Node node1,node2,node3,node4 -StaticAddress 2.0.0.123
Name
----
cluster1
Description
-----------
This command creates a four-node cluster named cluster1 that uses the static IP address 2.0.0.123.
Command Prompt: C:\PS>
New-Cluster -Name cluster1 -Node node1,node2,node3,node4 -StaticAddress 2.0.0.123,3.0.0.123
Name
----
cluster1
Description
-----------
This command creates a four-node cluster named cluster1 that uses the static IP addresses 2.0.0.123 3.0.0.123.
Command Prompt: C:\PS>
New-Cluster -Name cluster1 -Node node1,node2,node3,node4 -IgnoreNetwork 2.0.0.0/8
Name
----
cluster1
Description
-----------
This command creates a four-node cluster named cluster1. The cluster uses default settings for IP addressing, and does not use the network 2.0.0.0/8.
Command Prompt: C:\PS>
New-Cluster -Name cluster1 -Node node1,node2,node3,node4 -StaticAddress 2.0.0.123 -IgnoreNetwork 3.0.0.0/8
Name
----
cluster1
Description
-----------
This command creates a four-node cluster named cluster1. The cluster uses the static IP address 2.0.0.123, and does not use the network 3.0.0.0/8.
Get-Cluster
Remove-Cluster
Start-Cluster
Stop-Cluster
Test-Cluster