Note
Access to this page requires authorization. You can try signing in or .
Access to this page requires authorization. You can try .
Remove-ClusterNode
- Module:
- FailoverClusters Module
Removes a node from a failover cluster.
Syntax
Default (Default)
Remove-ClusterNode
[[-Name] <StringCollection>]
[-Force]
[-Wait <Int32>]
[-IgnoreStorageConnectivityLoss]
[-CleanupDisks]
[-InputObject <PSObject>]
[-Cluster <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
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.
Examples
Example 1
Remove-ClusterNode -Name node4
This example removes the node named node4 from the local cluster.
Example 2
Remove-ClusterNode -Name node4 -Force
This example removes the node named node4 from the local cluster without prompting for
confirmation.
Parameters
-CleanupDisks
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.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Cluster
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.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Confirm
Prompts you for confirmation before running the cmdlet.
Parameter properties
| Type: | SwitchParameter |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | cf |
Parameter sets
-Force
Runs the cmdlet without prompting for confirmation. By default the cmdlet will ask for confirmation from the user before proceeding.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-IgnoreStorageConnectivityLoss
Indicates that this cmdlet doesn't check whether the cluster node contains non-shared storage, if Storage Spaces Direct is enabled. If you don't specify this parameter, the cmdlet checks whether this node has any Storage Spaces Direct storage. If this cmdlet finds Storage Spaces Direct storage, it prompts you for confirmation before it removes the node.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-InputObject
Specifies the cluster node to remove.
Parameter properties
| Type: | PSObject |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Name
Specifies the name of the cluster node to remove.
Parameter properties
| Type: | StringCollection |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Wait
Specifies the time in seconds to wait for the cmdlet. If the Wait parameter isn't specified,
then the cmdlet waits for completion. If -Wait 0 is specified, then the call is initiated and the
cmdlet returns without waiting.
Parameter properties
| Type: | Int32 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet isn't run.
Parameter properties
| Type: | SwitchParameter |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | wi |
Parameter sets
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
Inputs
Microsoft.FailoverClusters.PowerShell.ClusterNode
Related Links
Feedback
Was this page helpful?