Restart-ServiceFabricNode

Restartuje uzel Service Fabric, aby simuloval selhání uzlu clusteru.

Syntax

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

Rutina Restart-ServiceFabricNode restartuje uzel Service Fabric restartováním procesu Fabric.exe, který je hostitelem uzlu. Tato rutina simuluje selhání uzlů Service Fabric v clusteru, které testuje cesty obnovení služeb při selhání vaší služby. Další informace naleznete v tématu Použití testovacích akcí.

Uzel Service Fabric, který se má restartovat, je možné zadat následujícími způsoby:

  • Zadejte název uzlu a volitelně ID instance uzlu.
  • Zadejte repliku stavové služby nebo instanci bezstavové služby a nechte rutinu identifikovat a restartovat uzel, který ho hostuje. Za zmínku stojí za zmínku implicitní chování pro výběr repliky nebo instance:
    • Pokud služba nepoužívá oddíl Singleton a není zadán parametr PartitionId ani PartitionKey , rutina náhodně vybere oddíl.
    • Pokud je služba stavová služba a není zadána žádná z parametrů Primary, RandomSecondary a ReplicaOrInstanceId , rutina náhodně vybere repliku bez ohledu na jeho roli.
    • Pokud je služba bezstavová služba a parametr ReplicaOrInstanceId není zadaný, rutina náhodně vybere instanci.

Pokud pro parametr NodeInstanceId zadáte nenulovou hodnotu, porovná se toto ID s ID aktivního uzlu. Pokud se ID neshodují, proces se nerestartuje a dojde k chybě. Zastaralá zpráva může způsobit tuto chybu.

Pokud zadáte parametr CreateFabricDump , tato rutina způsobí chybové ukončení procesu Fabric.exe na zadaném uzlu během restartování. Tato chyba vytvoří výpis stavu procesu pro Fabric.exe.

Před provedením jakékoli operace v clusteru Service Fabric vytvořte připojení ke clusteru pomocí rutiny Connect-ServiceFabricCluster .

Příklady

Příklad 1: Restartování uzlu, který je hostitelem primární repliky

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

Tento příkaz restartuje uzel, který je hostitelem primární repliky oddílu s názvem Partition3. Vzhledem k tomu, že parametr CommandCompletionMode je zadán s hodnotou Verify, příkaz před dokončením čeká na restartování cílového uzlu.

Příklad 2: Restartování zadaného uzlu

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

Tento příkaz restartuje uzel s názvem Node01. Vzhledem k tomu, že parametr CommandCompletionMode je zadán s hodnotou DoNotVerify, příkaz nečeká, až se uzel restartuje, než se dokončí.

Parametry

-CommandCompletionMode

Určuje, jestli akce čeká na dokončení restartování. Zadejte ověření , aby rutina čekala na dokončení restartování, a DoNotVerify , aby se rutina vrátila bez čekání na dokončení restartování.

Type:CompletionMode
Accepted values:Invalid, DoNotVerify, Verify
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CreateFabricDump

Označuje, že by se měl vytvořit výpis stavu procesu pro Fabric.exe v zadaném uzlu.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NodeInstanceId

Určuje ID instance uzlu. Pokud nezadáte hodnotu 0, musí id instance uzlu, které zadáte, odpovídat aktuálně spuštěnému uzlu. Id instancí uzlu získáte spuštěním get-ServiceFabricNode pro cílový uzel. Například pro uzel N0050 příkaz Get-ServiceFabricNode -NodeName "N0050" vrátí objekt Node , který obsahuje ID instance uzlu.

Type:BigInteger
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-NodeName

Určuje název uzlu Service Fabric. Rutina restartuje zadaný uzel.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PartitionId

Určuje ID oddílu oddílu služby Service Fabric. Rutina restartuje uzel, který je hostitelem repliky nebo instance tohoto oddílu.

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PartitionKey

Určuje klíč oddílu pro oddíl služby Service Fabric. Rutina identifikuje oddíl, na který se tento klíč oddílu mapuje, a restartuje uzel, který je hostitelem repliky nebo instance tohoto oddílu.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PartitionKindNamed

Označuje, že parametr PartitionKey určuje klíč oddílu pro službu, která používá schéma pojmenovaného dělení.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PartitionKindSingleton

Označuje, že služba zadaná v parametru ServiceName používá oddíl Singleton.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PartitionKindUniformInt64

Označuje, že parametr PartitionKey určuje klíč oddílu pro službu, která používá schéma dělení UniformInt64.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ReplicaKindPrimary

Označuje, že tato rutina restartuje uzel, který je hostitelem primární repliky zadaného oddílu.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ReplicaKindRandomSecondary

Označuje, že tato rutina restartuje uzel, který je hostitelem náhodné sekundární repliky zadaného oddílu.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ReplicaOrInstanceId

Určuje repliku služby Service Fabric nebo ID instance. Rutina restartuje uzel, který je hostitelem zadané repliky nebo instance.

Type:Int64
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ServiceName

Určuje název služby Service Fabric. Rutina restartuje uzel, který je hostitelem repliky nebo instance této služby.

Type:Uri
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TimeoutSec

Určuje časový limit operace v sekundách.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

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]]

Výstupy

System.Object