Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

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

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.