New-Cluster
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.
Syntax
New-Cluster [-Name] <string> [-IgnoreNetwork <StringCollection>] [-Node <StringCollection>] [-NoStorage] [-StaticAddress <StringCollection>] [<CommonParameters>]
Name
IgnoreNetwork
Node
NoStorage
StaticAddress
Detailed Description
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.
Parameters
IgnoreNetwork
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 |
Name
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 |
Node
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 |
NoStorage
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 |
StaticAddress
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 |
Input Type
Return Type
Microsoft.FailoverClusters.PowerShell.Cluster
Examples
-------------------------- EXAMPLE 1 --------------------------
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.
-------------------------- EXAMPLE 2 --------------------------
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.
-------------------------- EXAMPLE 3 --------------------------
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.
-------------------------- EXAMPLE 4 --------------------------
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.
-------------------------- EXAMPLE 5 --------------------------
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.
-------------------------- EXAMPLE 6 --------------------------
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.
See Also
Reference
Get-Cluster
Remove-Cluster
Start-Cluster
Stop-Cluster
Test-Cluster