Partager via

Disable-ServiceFabricNode

  • Référence
Module:
ServiceFabric

Désactive un nœud Service Fabric.

Syntaxe

Disable-ServiceFabricNode
       [-NodeName] <String>
       [-Intent] <NodeDeactivationIntent>
       [-Force]
       [-TimeoutSec <Int32>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

L’applet de commande Disable-ServiceFabricNode informe Service Fabric avant qu’une action d’administration soit effectuée sur un nœud susceptible d’affecter les réplicas sur le nœud.

Par exemple, avant de redémarrer un nœud, la désactivation du nœud avec l’intention informe Service Fabric de fermer correctement les réplicas sur le nœud. Vous devez attendre que le nœud soit désactivé avant de redémarrer le nœud. Utilisez l’applet de commande Get-ServiceFabricNode pour afficher l’état de désactivation du nœud. Service Fabric garantit que les services restent disponibles même si ces réplicas sont fermés. Le nœud reste dans l’état de désactivation jusqu’à ce qu’il soit sûr de le désactiver sans affecter la disponibilité du service. Une fois le redémarrage terminé, le nœud peut être activé à l’aide de l’applet de commande Enable-ServiceFabricNode, qui informe Service Fabric que le nœud peut désormais être utilisé pour placer des réplicas.

Pour gérer les clusters Service Fabric, démarrez Windows PowerShell à l’aide de l’option Exécuter en tant qu’administrateur. Avant d’effectuer une opération sur un cluster Service Fabric, établissez une connexion au cluster à l’aide de l’applet de commande Connect-ServiceFabricCluster.

Exemples

Exemple 1 : Désactiver un nœud avec le redémarrage de l’intention

PS C:\> Disable-ServiceFabricNode -NodeName "DB.41" -Intent Restart

Cette commande désactive un nœud portant le nom de nœud DB.41 avec le redémarrage de l’intention.

Paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Force

Force l’exécution de la commande sans demander la confirmation de l’utilisateur.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Intent

Spécifie l’intention du nœud de désactivation. L’intention détermine l’action effectuée par Service Fabric pour le nœud. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Pause. Aucun nouveau réplica n’est placé sur le nœud. Les réplicas existants continuent d’être exécutés. Vous pouvez spécifier ce paramètre pour déboguer des réplicas qui s’exécutent sur le nœud.
  • Redémarrer. Les réplicas existants sur le nœud sont fermés. Les réplicas ne sont pas déplacés vers un autre nœud. Vous pouvez spécifier ce paramètre lorsqu’un redémarrage de nœud est requis pour installer un correctif.
  • RemoveData. Spécifie que les données sur le nœud doivent être définitivement perdues. Cette applet de commande crée des copies des réplicas qui s’exécutent sur le nœud sur d’autres nœuds pour garantir la haute disponibilité. Vous pouvez spécifier ce paramètre lorsque le disque dur est réimagené.
  • RemoveNode. Spécifie que les données sur le nœud doivent être définitivement perdues. Cette applet de commande crée des copies des réplicas qui s’exécutent sur le nœud sur d’autres nœuds pour garantir la haute disponibilité. Vous pouvez spécifier ce paramètre lorsque le nœud est supprimé du cluster.
Type:NodeDeactivationIntent
Valeurs acceptées:Invalid, Pause, Restart, RemoveData, RemoveNode
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-NodeName

Spécifie le nom d’un nœud Service Fabric. L’applet de commande désactive le nœud que vous spécifiez.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-TimeoutSec

Spécifie le délai d’expiration, en secondes, pour l’opération.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Sorties

System.Object