Cmdlets

Choose a cmdlet from the list on the left or search for a specific cmdlet. Choose a cmdlet from the list or search for a specific cmdlet.
About Help  Providers
 

Remove-ClusterNode

Remove-ClusterNode

microsoft.failoverclusters.powershell.dll

Synopsis

Removes a node from a failover cluster.

Syntax

Remove-ClusterNode [-Name] [-Cluster] [-Force] [-InputObject] [-Wait] [<CommonParameters>]

Detailed Description

The Remove-ClusterNode cmdlet removes a node from a failover cluster. After the node is removed, the node no longer functions as part of the cluster unless the node is added back to the cluster. Removing a node is also called evicting a node from the cluster.

Note: This cmdlet cannot be run remotely without Credential Security Service Provider (CredSSP) authentication on the server computer.

Parameters

-Cluster <String>

Specifies the name of the cluster on which to run this cmdlet. If the input for this parameter is . or it is omitted, then the cmdlet runs on the local cluster.

Aliases

None

Required?

false

Position

named

Default value

Accept pipeline input?

false

Accept wildcard characters?

false

-Force <SwitchParameter>

Runs the cmdlet without prompting for confirmation. By default the cmdlet will ask for confirmation from the user before proceeding.

Aliases

None

Required?

false

Position

named

Default value

Accept pipeline input?

false

Accept wildcard characters?

false

-InputObject <PSObject>

Specifies the cluster node to remove.

Aliases

None

Required?

false

Position

named

Default value

Accept pipeline input?

true (ByValue)

Accept wildcard characters?

false

-Name <StringCollection>

Specifies the name of the cluster node to remove.

Aliases

None

Required?

false

Position

1

Default value

Accept pipeline input?

false

Accept wildcard characters?

false

-Wait <Int32>

Specifies the time in seconds to wait for the cmdlet. If the Wait parameter is not specified, then the cmdlet waits for completion. If -Wait 0 is specified, then the call is initiated and the cmdlet returns without waiting.

Aliases

None

Required?

false

Position

named

Default value

Accept pipeline input?

false

Accept wildcard characters?

false

Input Type

Microsoft.FailoverClusters.PowerShell.ClusterNode

Return Type


Notes

None

Examples

EXAMPLE 1

This example removes the node named node4 from the local cluster.

PS C:\>Remove-ClusterNode –Name node4

EXAMPLE 2

This example removes the node named node4 from the local cluster without prompting for confirmation.

PS C:\>Remove-ClusterNode –Name node4 -Force

Online Version
Add-ClusterNode
Get-ClusterNode
Resume-ClusterNode
Start-ClusterNode
Stop-ClusterNode
Suspend-ClusterNode