Add-ClusterNode

  • Article

Add-ClusterNode

Add a node (server) to a failover cluster. Before adding the new node, you should run validation tests on the existing nodes together with the proposed new node.

Syntax

Add-ClusterNode [[-Name] <StringCollection>] [-InputObject <psobject>] [-Cluster <string>] [<CommonParameters>]

  • Name

  • InputObject

  • Cluster

Detailed Description

Before adding the new node, you should run validation tests on the existing nodes together with the proposed new node. By running the validation tests, you can confirm that the server to be added is connected correctly to the networks and storage and that it contains the same software updates.

Parameters

Cluster

Specifies the name of the cluster to run this cmdlet on. If you type "-Cluster ." or omit the parameter, the cmdlet runs on the local cluster.

Default Value: **

Data Type: string

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

InputObject

Specifies the cluster to add the new cluster node to.

Default Value: **

Data Type: psobject

Attributes

Name Value PSMAML Attribute

Required?

false

required

Variable Length?

false

variableLength

Accept wildcard characters?

false

globbing

Accept Pipeline Input?

true (ByValue)

pipelineInput

Position?

named

position

Value Attributes

Name Value PSMAML Attribute

Required?

true

required

Variable Length?

false

variableLength

Name

Specifies the name of the cluster node to add.

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?

1

position

Value Attributes

Name Value PSMAML Attribute

Required?

true

required

Variable Length?

false

variableLength

Input Type

Microsoft.FailoverClusters.PowerShell.Cluster

Return Type

Microsoft.FailoverClusters.PowerShell.ClusterNode

Examples

-------------------------- EXAMPLE 1 --------------------------

Command Prompt: C:\PS>

 
Add-ClusterNode node4 
 
Name                                                State 
----                                                ----- 
node4                                                  Up

Description

-----------

This command adds node4 to the local cluster.

 

-------------------------- EXAMPLE 2 --------------------------

Command Prompt: C:\PS>

 
Get-Cluster cluster1 | Add-ClusterNode node3 
 
Name                                                State 
----                                                ----- 
node3                                                  Up

Description

-----------

This command adds node3 to cluster1.

See Also

Reference

Test-Cluster
Get-ClusterNode
Remove-ClusterNode
Resume-ClusterNode
Start-ClusterNode
Stop-ClusterNode
Suspend-ClusterNode

Other Resources

Online version: