Start-ClusterNode

Article
07/03/2012

Start-ClusterNode

Start the Cluster service on a node in a failover cluster.

Syntax

Start-ClusterNode [-InputObject <psobject>] [[-Name] <StringCollection>] [-Cluster <string>] [-FixQuorum] [-Wait <int>] [<CommonParameters>]

InputObject
Name
Cluster
FixQuorum
Wait

Detailed Description

If this is the first node started, it will wait for other nodes to join. The cluster will begin to run when a quorum has formed.
You can also use this cmdlet with the -FixQuorum option to force quorum, that is, force the start of a cluster node even if quorum has not been achieved. When you force quorum on a given node, the copy of the cluster configuration that is on that node will be treated as the authoritative copy and will be replicated to all other nodes. Therefore, forcing quorum should be considered a last resort, because some cluster configuration changes could be lost. The ability to force quorum can be especially useful in a multi-site cluster if the primary site (with the majority of nodes) becomes unavailable, and you need to bring the secondary site (with a minority of nodes) into service. Similarly, the ability to force quorum makes it possible to start a cluster that uses the Node and File Share Majority quorum option when none of the available cluster nodes contains a current copy of the cluster configuration.

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

FixQuorum

Forces quorum on this node, which means that the copy of the cluster configuration that is on this node will be treated as the authoritative copy and will be replicated to all other nodes. Forcing quorum should be considered a last resort. [Alias: fq]

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

InputObject

Specifies the cluster node to start.

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 start.

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

Wait

Specifies the time in seconds to wait for the operation. If this parameter is not specified the operation waits for completion. If "-Wait 0" is specified the call is initiated and the cmdlet returns right away.

Default Value: **

Data Type: int

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

Microsoft.FailoverClusters.PowerShell.ClusterNode

Return Type

Microsoft.FailoverClusters.PowerShell.ClusterNode

Examples

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

Command Prompt: C:\PS>

 
Start-ClusterNode node3 
 
Name                                                  State 
----                                                  ----- 
node3                                               Joining

Description

-----------

This command starts the Cluster service on node3 of the local cluster.

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

Command Prompt: C:\PS>

 
Start-ClusterNode node1 -Cluster cluster2 
 
Name                                                  State 
----                                                  ----- 
node1                                               Joining

Description

-----------

This command starts the Cluster service on node1 of cluster2.

-------------------------- EXAMPLE 3 --------------------------

Command Prompt: C:\PS>

 
Start-ClusterNode -FixQuorum 
 
Name                                                  State 
----                                                  ----- 
node1                                               Joining

Description

-----------

This command forces the local node and the local cluster to start, even if quorum has not been achieved. If quorum has not been achieved, the copy of the cluster configuration that is on the local node will be treated as the authoritative copy and will be replicated to all other nodes. This command should be considered a last resort, because some cluster configuration changes could be lost.

Start-ClusterNode