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