Add-ClusterNode
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>]
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 <string>
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.
Attributes
| Name | Value |
|---|---|
|
Required? |
false |
|
Accept wildcard characters? |
false |
|
Accept Pipeline Input? |
false |
|
Position? |
named |
-InputObject <psobject>
Specifies the cluster to add the new cluster node to.
Attributes
| Name | Value |
|---|---|
|
Required? |
false |
|
Accept wildcard characters? |
false |
|
Accept Pipeline Input? |
true (ByValue) |
|
Position? |
named |
-Name <StringCollection>
Specifies the name of the cluster node to add.
Attributes
| Name | Value |
|---|---|
|
Required? |
false |
|
Accept wildcard characters? |
false |
|
Accept Pipeline Input? |
false |
|
Position? |
1 |
-CommonParameter
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see About Common Parameter
Input and Return Types
The input type is the type of the objects that you can pipe to the cmdlet. The return type is the type of the objects that the cmdlet emits.
Input Type | Microsoft.FailoverClusters.PowerShell.Cluster. |
Return Type | Microsoft.FailoverClusters.PowerShell.ClusterNode. |
Examples
EXAMPLE 1
C:\PS> Add-ClusterNode node4 Name State ---- ----- node4 Up
Description
-----------
This command adds node4 to the local cluster.
EXAMPLE 2
C:\PS> Get-Cluster cluster1 | Add-ClusterNode node3 Name State ---- ----- node3 Up
Description
-----------
This command adds node3 to cluster1.
See Also