Sdílet prostřednictvím


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