Restart-ServiceFabricReplica

Module:

ServiceFabric

Redémarre un réplica Service Fabric pour simuler la réouverture d’un réplica de service avec état.

Syntaxe

Restart-ServiceFabricReplica
       [-NodeName] <String>
       [-PartitionId] <Guid>
       [-ReplicaOrInstanceId] <Int64>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       [-PartitionId] <Guid>
       -ServiceName <Uri>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       [-PartitionId] <Guid>
       -ServiceName <Uri>
       [-ReplicaKindPrimary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       [-PartitionId] <Guid>
       -ServiceName <Uri>
       [-ReplicaKindRandomSecondary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       [-PartitionId] <Guid>
       -ServiceName <Uri>
       [-ReplicaOrInstanceId] <Int64>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-ReplicaKindRandomSecondary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-ReplicaKindRandomSecondary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-ReplicaKindRandomSecondary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-ReplicaKindPrimary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-ReplicaKindPrimary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-ReplicaKindPrimary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-ReplicaOrInstanceId] <Int64>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-ReplicaOrInstanceId] <Int64>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-ReplicaOrInstanceId] <Int64>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-ReplicaKindPrimary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-ReplicaKindRandomSecondary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-ReplicaOrInstanceId] <Int64>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Description

La Restart-ServiceFabricReplica cmdlet simule un échec de réplica de service en redémarrant un réplica de service persistant, en fermant le réplica, puis en le rouvrant. Utilisez cette applet de commande pour tester votre service en cas de problèmes le long du chemin de réouverture du réplica. Cette applet de commande permet de simuler le chemin temporaire d’erreur de rapport via les API clientes. Cette applet de commande est valide uniquement pour les réplicas appartenant à des services persistants avec état.

Pour spécifier le réplica à redémarrer, nous pouvons commencer par le nom du nœud ou le nom du service.

Ensuite, nous devons spécifier la partition à laquelle appartient le réplica. Nous pouvons spécifier la partition en spécifiant la paire (schéma de nommage, clé de partition) ou en spécifiant l’ID de partition. Pour plus d’informations sur le partitionnement de service Microsoft Azure Service Fabric, consultez Partitionner des services fiables Service Fabric.

Enfin, nous devrons peut-être spécifier le réplica de la partition à laquelle nous faisons référence et cela peut être effectué soit en spécifiant le rôle de réplica (réplica principal ou secondaire) soit en spécifiant l’ID de réplica.

Dans certains cas, l’utilisateur peut souhaiter redémarrer une combinaison aléatoire de partition/réplica pour un service au lieu d’une combinaison spécifique. Cela est utile pour tester vos services lorsque vous souhaitez exécuter un ensemble aléatoire de transitions pour vos services afin de simuler des défaillances réelles. Par exemple, si vous fournissez uniquement le nom du service à cette applet de commande et que vous laissez la partition et/ou les informations de réplica, l’applet de commande fera un choix aléatoire pour sélectionner une partition et un réplica en cas d’erreur. Notez que la partition ou le réplica sélectionné appartient uniquement au service spécifié.

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 réplica

PS C:\> Restart-ServiceFabricReplica -NodeName "Node07" -PartitionId 869dd2e9-fdda-42a5-ad96-4b71c795dfd3 -ReplicaOrInstanceId 12345098480948

Cette commande redémarre le réplica sur Node07 sur la partition spécifiée.

Exemple 2 : Redémarrer un réplica principal

PS C:\> Restart-ServiceFabricReplica -ReplicaKindPrimary -PartitionKindNamed -PartitionKey "Partition1" -ServiceName fabric:/App/Service

Cette commande redémarre un réplica principal sur la partition spécifiée.

Paramètres

-CommandCompletionMode

Spécifie si l’action attend la fin de l’opération de 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

-NodeName

Spécifie le nom d’un nœud Service Fabric. L’applet de commande redémarre un réplica déployé sur 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 la partition pour laquelle redémarrer le réplica.

Type:	Guid
Position:	1
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 la clé de la partition pour laquelle le réplica est redémarré.

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 cette applet de commande redémarre un réplica sur une partition nommée.

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

-PartitionKindSingleton

Indique que cette applet de commande redémarre un réplica sur une partition singleton.

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

-PartitionKindUniformInt64

Indique que cette applet de commande redémarre un réplica sur une partition UniformInt64.

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

-ReplicaKindPrimary

Indique que cette applet de commande redémarre le réplica pour le réplica principal.

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

-ReplicaKindRandomSecondary

Indique que cette applet de commande redémarre un réplica pour un réplica secondaire aléatoire.

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

-ReplicaOrInstanceId

Spécifie un réplica de service Service Fabric ou un ID d’instance.

Type:	Int64
Position:	2
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.

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.Guid

System.Uri

System.Management.Automation.SwitchParameter

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

Sorties

System.Object

Liens associés

• Connect-ServiceFabricCluster
• Get-ServiceFabricReplica
• Remove-ServiceFabricReplica