.png)
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 --------------------------
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 --------------------------
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 --------------------------
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 --------------------------
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 --------------------------
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 --------------------------
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-ClusterRemove-Cluster
Start-Cluster
Stop-Cluster
Test-Cluster
Other Resources
Online version:
