Restart-ServiceFabricNode

  • Référence
Module:
ServiceFabric

Redémarre un nœud Service Fabric pour simuler une défaillance de nœud de cluster.

Syntaxe

Restart-ServiceFabricNode
       [-NodeName] <String>
       [[-NodeInstanceId] <BigInteger>]
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -PartitionId <Guid>
       -ServiceName <Uri>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -PartitionId <Guid>
       -ServiceName <Uri>
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -PartitionId <Guid>
       -ServiceName <Uri>
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -PartitionId <Guid>
       -ServiceName <Uri>
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Description

L’applet de commande Restart-ServiceFabricNode redémarre un nœud Service Fabric en redémarrant le processus Fabric.exe qui héberge le nœud. Cette applet de commande simule les échecs de nœud Service Fabric dans le cluster, qui testent les chemins de récupération de basculement de votre service. Pour plus d’informations, consultez Utilisation d’actions de test.

Le nœud Service Fabric à redémarrer peut être spécifié de la manière suivante :

  • Spécifiez le nom du nœud et éventuellement l’ID d’instance de nœud.
  • Spécifiez un réplica de service avec état ou une instance de service sans état et laissez l’applet de commande identifier et redémarrer le nœud qui l’héberge. Les comportements implicites folowing pour la sélection de réplica/instance valent la peine de noter :
    • Si le service n’utilise pas de partition Singleton et ni l'PartitionId ni paramètre PartitionKey est spécifié, l’applet de commande sélectionne une partition de manière aléatoire.
    • Si le service est un service avec état et qu’aucunprincipal , RandomSecondary et paramètres ReplicaOrInstanceId sont spécifiés, l’applet de commande sélectionne de façon aléatoire un réplica, quel que soit son rôle.
    • Si le service est un service sans état et que le paramètre ReplicaOrInstanceId n’est pas spécifié, l’applet de commande sélectionne de façon aléatoire une instance.

Si vous spécifiez une valeur non nulle pour le paramètre NodeInstanceId , cet ID est comparé à l’ID de nœud actif. Si les ID ne correspondent pas, le processus n’est pas redémarré et une erreur se produit. Un message obsolète peut provoquer cette erreur.

Si vous spécifiez le paramètre CreateFabricDump, cette applet de commande entraîne le blocage du processus Fabric.exe sur le nœud spécifié pendant le redémarrage. Ce blocage crée un vidage de processus pour Fabric.exe.

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 : Redémarrer un nœud qui héberge un réplica principal

PS C:\> Restart-ServiceFabricNode -ReplicaKindPrimary -PartitionKindNamed -PartitionKey "Partition3" -CommandCompletionMode Verify

Cette commande redémarre le nœud qui héberge le réplica principal de la partition nommée Partition3. Comme le paramètre CommandCompletionMode est spécifié avec la valeur Verify, la commande attend que le nœud cible redémarre avant qu’il ne se termine.

Exemple 2 : Redémarrer un nœud spécifié

PS C:\> Restart-ServiceFabricNode -NodeName "Node01" -CommandCompletionMode DoNotVerify

Cette commande redémarre le nœud nommé Node01. Étant donné que le paramètre CommandCompletionMode est spécifié avec la valeur DoNotVerify, la commande n’attend pas que le nœud redémarre avant sa fin.

Paramètres

-CommandCompletionMode

Spécifie si l’action attend la fin du redémarrage. Spécifiez Vérifier pour que l’applet de commande attend la fin du redémarrage, et DoNotVerify pour retourner l’applet de commande sans attendre la fin du redémarrage.

Type:CompletionMode
Valeurs acceptées:Invalid, DoNotVerify, Verify
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-CreateFabricDump

Indique qu’un vidage de processus doit être créé pour Fabric.exe sur le nœud spécifié.

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

-NodeInstanceId

Spécifie un ID d’instance de nœud. Sauf si vous spécifiez 0, l’ID d’instance de nœud que vous spécifiez doit correspondre au nœud en cours d’exécution. 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:1
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-NodeName

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

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

-PartitionId

Spécifie l’ID de partition d’une partition de service Service Fabric. L’applet de commande redémarre un nœud qui héberge un réplica ou une instance de cette partition.

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

-PartitionKey

Spécifie une clé de partition pour une partition de service Service Fabric. L’applet de commande identifie la partition à laquelle cette clé de partition est mappée et redémarre un nœud qui héberge un réplica ou une instance de cette partition.

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

-PartitionKindNamed

Indique que le paramètre PartitionKey spécifie une clé de partition pour un service qui utilise le schéma de partitionnement nommé.

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

-PartitionKindSingleton

Indique que le service spécifié dans le paramètre ServiceName utilise une partition Singleton.

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

-PartitionKindUniformInt64

Indique que le paramètre PartitionKey spécifie une clé de partition pour un service qui utilise le schéma de partitionnement UniformInt64.

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

-ReplicaKindPrimary

Indique que cette applet de commande redémarre le nœud qui héberge le réplica principal de la partition spécifiée.

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

-ReplicaKindRandomSecondary

Indique que cette applet de commande redémarre le nœud qui héberge un réplica secondaire aléatoire de la partition spécifiée.

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

-ReplicaOrInstanceId

Spécifie un réplica de service Service Fabric ou un ID d’instance. L’applet de commande redémarre le nœud qui héberge le réplica ou l’instance spécifié.

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

-ServiceName

Spécifie le nom d’un service Service Fabric. L’applet de commande redémarre un nœud qui héberge un réplica ou une instance de ce service.

Type:Uri
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
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

Entrées

System.String

System.Nullable`1[[System.Numerics.BigInteger, System.Numerics, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

System.Guid

System.Uri

System.Nullable`1[[System.Int64, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Sorties

System.Object