Suspend-ClusterNode
Suspend-ClusterNode
Suspends activity on a failover cluster node, that is, pauses the node.
Syntaxe
Parameter Set: InputObject
Suspend-ClusterNode [[-Name] <StringCollection> ] [[-TargetNode] <String> ] [-Cluster <String> ] [-Drain] [-ForceDrain] [-InputObject <PSObject> ] [-Wait] [-Confirm] [-WhatIf] [ <CommonParameters>]
Description détaillée
The Suspend-ClusterNode cmdlet suspends activity on a failover cluster node, that is, pauses the node. If you use the Drain parameter, clustered roles currently running on the node will be drained before the node is paused.
Pausing (suspending) a node is usually done when applying software updates to the node. If you need to perform extensive diagnosis or maintenance on a cluster node, it might be more workable to stop (not pause) the Cluster service on that node.
Paramètres
-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.
Alias |
none |
Requis ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Drain
Specifies that all of the workloads are gracefully moved to other nodes while maintaining the highest levels of availability and using the best placement logic.
Alias |
none |
Requis ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-ForceDrain
Alias |
none |
Requis ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-InputObject<PSObject>
Specifies the cluster node to suspend (with or without draining), or the cluster on which to run the cmdlet.
Alias |
none |
Requis ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
true (ByValue) |
Accepter les caractères génériques ? |
false |
-Name<StringCollection>
Specifies the name of the cluster node to suspend (with or without draining).
Alias |
none |
Requis ? |
false |
Position ? |
1 |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-TargetNode<String>
Specifies a node to which to drain the workloads.
Alias |
none |
Requis ? |
false |
Position ? |
2 |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Wait
Specifies the time in seconds to wait for the cmdlet. If the Wait parameter is not specified, then the call is initiated and the cmdlet returns without waiting. If specified with no value, then the cmdlet waits for completion.. If -Wait 0 is specified, then the call is initiated and the cmdlet returns without waiting.
Alias |
none |
Requis ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Confirm
Vous invite à confirmer l'exécution de l'applet de commande.
Requis ? |
false |
Position ? |
named |
Valeur par défaut |
false |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-WhatIf
Indique ce qui se produit en cas d'exécution de l'applet de commande. L'applet de commande n'est pas exécutée.
Requis ? |
false |
Position ? |
named |
Valeur par défaut |
false |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez . about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Entrées
Le type d'entrée correspond au type des objets que vous pouvez adresser à l'applet de commande.
- Microsoft.FailoverClusters.PowerShell.Cluster
- Microsoft.FailoverClusters.PowerShell.ClusterNode
Sorties
Le type de sortie correspond au type des objets que l'applet de commande émet.
- Microsoft.FailoverClusters.PowerShell.ClusterNode
Exemples
EXAMPLE 1
This example pauses the node named node1 on the local cluster.
PS C:\> Suspend-ClusterNode node1
EXAMPLE 2
This example pauses the node named node2 on the cluster named cluster2.
PS C:\> Suspend-ClusterNode node2 -Cluster cluster2
EXAMPLE 3
This example pauses the node named node1 and moves the workloads from it to the node named node2.
PS C:\> Suspend-ClusterNode -Name node1 -Target node2 -Drain
EXAMPLE 4
This example provides a preview of the operation that will be performed on the node named node1.
PS C:\> Suspend-ClusterNode node1 -Drain -Whatif