Restart-ServiceFabricNode
Restartuje uzel Service Fabric, aby simuloval selhání uzlu clusteru.
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
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žby při selhání. Další informace najdete 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 parametr, rutina náhodně vybere oddíl.
- Pokud je služba stavová služba a žádný z parametrů Primary, RandomSecondary a ReplicaOrInstanceId parametry, rutina náhodně vybere repliku bez ohledu na svou 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 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, CommandCompletionMode parametr je zadán s hodnotou Verify, příkaz čeká na restartování cílového uzlu před dokončením.
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, CommandCompletionMode parametr 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ěřit, aby rutina čekala na dokončení restartování, a DoNotVerify, aby se rutina vrátila bez čekání na dokončení restartování.
Typ: | CompletionMode |
Přípustné hodnoty: | Invalid, DoNotVerify, Verify |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-CreateFabricDump
Označuje, že by se měl vytvořit výpis stavu procesu pro Fabric.exe v zadaném uzlu.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-NodeInstanceId
Určuje ID instance uzlu.
Pokud nezadáte hodnotu 0, musí zadané ID instance uzlu odpovídat aktuálně běžícímu uzlu.
Id instancí uzlu získáte spuštěním Get-ServiceFabricNode cílového uzlu.
Například pro uzel N0050 příkaz Get-ServiceFabricNode -NodeName "N0050"
vrátí Node objekt, který obsahuje ID instance uzlu.
Typ: | BigInteger |
Position: | 1 |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-NodeName
Určuje název uzlu Service Fabric. Rutina restartuje zadaný uzel.
Typ: | String |
Position: | 0 |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-PartitionId
Určuje ID oddílu oddílu oddílu služby Service Fabric. Rutina restartuje uzel, který je hostitelem repliky nebo instance tohoto oddílu.
Typ: | Guid |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | 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.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-PartitionKindNamed
Označuje, že parametr PartitionKey určuje klíč oddílu pro službu, která používá schéma dělení pojmenované.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-PartitionKindSingleton
Označuje, že služba zadaná v parametru ServiceName používá oddíl Singleton.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-PartitionKindUniformInt64
Označuje, že parametr PartitionKey určuje klíč oddílu pro službu, která používá schéma dělení UniformInt64.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-ReplicaKindPrimary
Označuje, že tato rutina restartuje uzel, který je hostitelem primární repliky zadaného oddílu.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-ReplicaKindRandomSecondary
Označuje, že tato rutina restartuje uzel, který je hostitelem náhodné sekundární repliky zadaného oddílu.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-ReplicaOrInstanceId
Určuje repliku služby Service Fabric nebo ID instance. Rutina restartuje uzel, který je hostitelem zadané repliky nebo instance.
Typ: | Int64 |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-ServiceName
Určuje název služby Service Fabric. Rutina restartuje uzel, který je hostitelem repliky nebo instance této služby.
Typ: | Uri |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-TimeoutSec
Určuje časový limit operace v sekundách.
Typ: | Int32 |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | 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