Udostępnij za pośrednictwem


Restart-ServiceFabricNode

Uruchamia ponownie węzeł usługi Service Fabric, aby zasymulować awarię węzła klastra.

Składnia

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

Opis

Polecenie cmdlet Restart-ServiceFabricNode powoduje ponowne uruchomienie węzła usługi Service Fabric przez ponowne uruchomienie procesu Fabric.exe, który hostuje węzeł. To polecenie cmdlet symuluje błędy węzła usługi Service Fabric w klastrze, które testują ścieżki odzyskiwania w trybie failover usługi. Aby uzyskać więcej informacji, zobacz Używanie akcji testowych.

Węzeł usługi Service Fabric do ponownego uruchomienia można określić w następujący sposób:

  • Określ nazwę węzła i opcjonalnie identyfikator wystąpienia węzła.
  • Określ stanową replikę usługi lub wystąpienie usługi bezstanowej i zezwłań, aby polecenie cmdlet zidentyfikowało i ponownie uruchomiło węzeł, który go hostuje. Warto zwrócić uwagę na niejawne zachowania w przypadku wyboru repliki/wystąpienia:
    • Jeśli usługa nie używa partycji Singleton i nie określono parametru PartitionId ani PartitionKey , polecenie cmdlet losowo wybiera partycję.
    • Jeśli usługa jest usługą stanową i żadne z parametrów Primary, RandomSecondary i ReplicaOrInstanceId nie są określone, polecenie cmdlet losowo wybiera replikę, niezależnie od jej roli.
    • Jeśli usługa jest usługą bezstanową, a nie określono parametru ReplicaOrInstanceId , polecenie cmdlet losowo wybiera wystąpienie.

Jeśli określisz wartość inną niż zero dla parametru NodeInstanceId , ten identyfikator jest porównywany z identyfikatorem aktywnego węzła. Jeśli identyfikatory nie są zgodne, proces nie zostanie uruchomiony ponownie i wystąpi błąd. Nieaktualny komunikat może spowodować ten błąd.

Jeśli określisz parametr CreateFabricDump , to polecenie cmdlet powoduje awarię procesu Fabric.exe w określonym węźle podczas ponownego uruchamiania. Ta awaria tworzy zrzut procesu dla Fabric.exe.

Przed wykonaniem dowolnej operacji w klastrze usługi Service Fabric nawiąż połączenie z klastrem przy użyciu polecenia cmdlet Connect-ServiceFabricCluster .

Przykłady

Przykład 1: Ponowne uruchamianie węzła, który hostuje replikę podstawową

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

To polecenie uruchamia ponownie węzeł hostujący replikę podstawową partycji o nazwie Partition3. Ponieważ parametr CommandCompletionMode jest określony z wartością Verify, polecenie czeka na ponowne uruchomienie węzła docelowego przed jego ukończeniem.

Przykład 2. Ponowne uruchamianie określonego węzła

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

To polecenie powoduje ponowne uruchomienie węzła o nazwie Node01. Ponieważ parametr CommandCompletionMode jest określony z wartością DoNotVerify, polecenie nie czeka na ponowne uruchomienie węzła przed jego ukończeniem.

Parametry

-CommandCompletionMode

Określa, czy akcja czeka na zakończenie ponownego uruchomienia. Określ pozycję Weryfikuj , aby polecenie cmdlet czekało na zakończenie ponownego uruchomienia, i doNotVerify , aby polecenie cmdlet zostało zwrócone bez oczekiwania na zakończenie ponownego uruchomienia.

Typ:CompletionMode
Dopuszczalne wartości:Invalid, DoNotVerify, Verify
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-CreateFabricDump

Wskazuje, że należy utworzyć zrzut procesu dla Fabric.exe w określonym węźle.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-NodeInstanceId

Określa identyfikator wystąpienia węzła. Jeśli nie określisz wartości 0, określony identyfikator wystąpienia węzła musi być zgodny z aktualnie uruchomionym węzłem. Aby uzyskać identyfikatory wystąpień węzła, uruchom polecenie Get-ServiceFabricNode dla węzła docelowego. Na przykład dla węzła N0050 polecenie Get-ServiceFabricNode -NodeName "N0050" zwraca obiekt Node zawierający identyfikator wystąpienia węzła.

Typ:BigInteger
Position:1
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-NodeName

Określa nazwę węzła usługi Service Fabric. Polecenie cmdlet ponownie uruchamia określony węzeł.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-PartitionId

Określa identyfikator partycji partycji usługi Service Fabric. Polecenie cmdlet uruchamia ponownie węzeł hostujący replikę lub wystąpienie tej partycji.

Typ:Guid
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-PartitionKey

Określa klucz partycji dla partycji usługi Service Fabric. Polecenie cmdlet identyfikuje partycję mapowania tego klucza partycji na i ponownie uruchamia węzeł hostujący replikę lub wystąpienie tej partycji.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-PartitionKindNamed

Wskazuje, że parametr PartitionKey określa klucz partycji dla usługi, która używa schematu partycjonowania nazwanego.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PartitionKindSingleton

Wskazuje, że usługa określona w parametrze ServiceName używa partycji Singleton.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PartitionKindUniformInt64

Wskazuje, że parametr PartitionKey określa klucz partycji dla usługi, która używa schematu partycjonowania UniformInt64.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ReplicaKindPrimary

Wskazuje, że to polecenie cmdlet ponownie uruchamia węzeł hostujący replikę podstawową określonej partycji.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ReplicaKindRandomSecondary

Wskazuje, że to polecenie cmdlet ponownie uruchamia węzeł, który hostuje losową replikę pomocniczą określonej partycji.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ReplicaOrInstanceId

Określa replikę usługi Service Fabric lub identyfikator wystąpienia. Polecenie cmdlet uruchamia ponownie węzeł hostujący określoną replikę lub wystąpienie.

Typ:Int64
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ServiceName

Określa nazwę usługi Service Fabric. Polecenie cmdlet uruchamia ponownie węzeł hostujący replikę lub wystąpienie tej usługi.

Typ:Uri
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-TimeoutSec

Określa limit czasu dla operacji w sekundach.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

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

Dane wyjściowe

System.Object