Partager via

Start-ServiceFabricNodeTransition

  • Référence
Module:
ServiceFabric

Lance une opération pour démarrer ou arrêter un nœud de cluster Service Fabric.

Syntaxe

Start-ServiceFabricNodeTransition
     [-Stop]
     -OperationId <Guid>
     -NodeName <String>
     -NodeInstanceId <BigInteger>
     -StopDurationInSeconds <Int32>
     [-TimeoutSec <Int32>]
     [<CommonParameters>]
Start-ServiceFabricNodeTransition
     [-Start]
     -OperationId <Guid>
     -NodeName <String>
     -NodeInstanceId <BigInteger>
     [-TimeoutSec <Int32>]
     [<CommonParameters>]

Description

L’applet de commande Start-ServiceFabricNodeTransition lance une opération asynchrone pour démarrer ou arrêter un nœud de cluster Service Fabric.

La spécification du paramètre Arrêter place un nœud de cluster Service Fabric dans un état arrêté. Un nœud est un processus, et non une machine virtuelle ou un ordinateur. La machine virtuelle ou l’ordinateur continue à s’exécuter une fois le nœud arrêté. Dans l’état arrêté, le nœud n’est pas membre du cluster et ne peut pas héberger les services. Un nœud arrêté simule un nœud qui est hors connexion ou hors connexion.

La spécification du paramètre Démarrer démarre un nœud qui a été arrêté.

Lorsque cette applet de commande est retournée avec succès, le système a accepté l’opération. Toutefois, cela n’implique pas que l’opération a terminé. Pour obtenir des informations sur l’état actuel de l’opération, exécutez l'Get-ServiceFabricNodeTransitionProgress cmdlet.

L’applet de commande Start-ServiceFabricNodeTransition est préférée aux applets de commande Start-ServiceFabricNode et stop-ServiceFabricNode , qui sont obsolètes. Évitez de mélanger l’utilisation de cette applet de commande avec Start-ServiceFabricNode et Stop-ServiceFabricNode. Si un nœud a déjà été arrêté à l’aide de Stop-ServiceFabricNode, commencez-le à utiliser Start-ServiceFabricNode avant d’utiliser Start-ServiceFabricNodeTransition. Utilisez start-ServiceFabricNodeTransition à partir de là.

Pour plus d’informations, consultez Remplacer le nœud de démarrage et arrêter les API de nœud par l’API Transition de nœud.

Exemples

Exemple 1 : Arrêter un nœud Service Fabric

PS C:\> Start-ServiceFabricNodeTransition -Stop -OperationId 097b03e3-760a-419c-9fce-e83f8cc0894b -NodeName N0050 -NodeInstanceId 131242467532403195 -StopDurationInSeconds 3600

Cette commande lance une opération pour arrêter un nœud Service Fabric pendant une heure. Après une heure, le nœud démarre automatiquement. Effectuez le suivi de la valeur OperationId . Vous pouvez l’utiliser pour exécuter Get-ServiceFabricNodeTransitionProgress.

Exemple 2 : Démarrer un nœud Service Fabric

PS C:\> Start-ServiceFabricNodeTransition -Start -OperationId 6d1bf9a1-9733-4d83-be59-0acea3be57a7 -NodeName N0050 -NodeInstanceId 131242467532403195

Cette commande lance une opération pour démarrer un nœud Service Fabric arrêté.

Paramètres

-NodeInstanceId

Spécifie l’ID de l’instance de nœud que cette applet de commande démarre ou arrête. Pour obtenir des ID d’instance de nœud, exécutez Get-ServiceFabricNode pour le nœud cible. Par exemple, pour le nœud N0050, la commande Get-ServiceFabricNode -NodeName "N0050" retourne un objet Node qui contient l’ID d’instance de nœud.

Type:BigInteger
Position:Named
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 du nœud Service Fabric que cette applet de commande démarre ou arrête. Pour obtenir des nœuds Service Fabric dans votre cluster, exécutez l’applet de commande Get-ServiceFabricNode Get-ServiceFabricNode.

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

-OperationId

Spécifie un ID unique qui identifie l’opération. Utilisez la même valeur pour cette applet de commande, qui lance l’opération et Get-ServiceFabricNodeTransitionProgress, qui obtient la progression de l’opération.

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

-Start

Indique que cette applet de commande démarre un nœud arrêté.

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

-Stop

Indique que cette applet de commande arrête un nœud en cours d’exécution.

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

-StopDurationInSeconds

Spécifie la durée, en secondes, pour conserver un nœud arrêté une fois l’opération arrêtée. Après cette période, le nœud démarre automatiquement.

La valeur minimale est 600. La valeur maximale est 14400.

Vous devez spécifier le paramètre Arrêter pour spécifier une durée d’arrêt.

Type:Int32
Position:Named
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 la valeur de délai d’attente, en secondes, pour cette applet de commande.

Il ne s’agit pas de la durée pendant laquelle le nœud arrêté reste arrêté. Pour contrôler la durée d’arrêt d’un nœud, utilisez le paramètre StopDurationInSeconds.

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

Entrées

None

Sorties

System.Object