Restart-ServiceFabricNode
Start een Service Fabric-knooppunt opnieuw op om een clusterknooppuntfout te simuleren.
Syntaxis
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
De cmdlet Restart-ServiceFabricNode start een Service Fabric-knooppunt opnieuw door het Fabric.exe proces dat als host fungeert voor het knooppunt opnieuw op te starten. Met deze cmdlet worden Fouten in het Service Fabric-knooppunt in het cluster gesimuleerd, waarmee de failoverherstelpaden van uw service worden getest. Zie Testacties gebruiken voor meer informatie.
Het Service Fabric-knooppunt dat opnieuw moet worden opgestart, kan op de volgende manieren worden opgegeven:
- Geef de naam van het knooppunt en eventueel de id van het knooppuntexemplaren op.
- Geef een stateful servicereplica of stateless service-exemplaar op en laat de cmdlet het knooppunt identificeren en opnieuw starten dat als host fungeert. Het impliciete gedrag voor replica-/exemplaarselectie is de moeite waard om te noteren:
- Als de service geen Singleton-partitie gebruikt en de parameter PartitionId of PartitionKey niet is opgegeven, kiest de cmdlet willekeurig een partitie.
- Als de service een stateful service is en geen van de parameters Primary, RandomSecondary en ReplicaOrInstanceId zijn opgegeven, kiest de cmdlet willekeurig een replica, ongeacht de rol.
- Als de service een staatloze service is en de parameter ReplicaOrInstanceId niet is opgegeven, kiest de cmdlet willekeurig een exemplaar.
Als u een niet-nulwaarde opgeeft voor de parameter NodeInstanceId , wordt die id vergeleken met de actieve knooppunt-id. Als de id's niet overeenkomen, wordt het proces niet opnieuw gestart en treedt er een fout op. Een verlopen bericht kan deze fout veroorzaken.
Als u de parameter CreateFabricDump opgeeft, zorgt deze cmdlet ervoor dat het Fabric.exe proces vastloopt op het opgegeven knooppunt tijdens het opnieuw opstarten. Deze crash maakt een procesdump voor Fabric.exe.
Voordat u een bewerking uitvoert op een Service Fabric-cluster, maakt u een verbinding met het cluster met behulp van de cmdlet Connect-ServiceFabricCluster .
Voorbeelden
Voorbeeld 1: Een knooppunt dat als host fungeert voor een primaire replica opnieuw starten
PS C:\> Restart-ServiceFabricNode -ReplicaKindPrimary -PartitionKindNamed -PartitionKey "Partition3" -CommandCompletionMode Verify
Met deze opdracht start u het knooppunt opnieuw op dat als host fungeert voor de primaire replica van de partitie met de naam Partition3. Omdat de parameter CommandCompletionMode is opgegeven met de waarde Verify, wacht de opdracht totdat het doelknooppunt opnieuw wordt opgestart voordat deze is voltooid.
Voorbeeld 2: Een opgegeven knooppunt opnieuw starten
PS C:\> Restart-ServiceFabricNode -NodeName "Node01" -CommandCompletionMode DoNotVerify
Met deze opdracht wordt het knooppunt met de naam Node01 opnieuw gestart. Omdat de parameter CommandCompletionMode is opgegeven met een waarde van DoNotVerify, wacht de opdracht niet totdat het knooppunt opnieuw wordt opgestart voordat het is voltooid.
Parameters
-CommandCompletionMode
Hiermee geeft u op of de actie wacht totdat het opnieuw opstarten is voltooid. Geef Controleren op om de cmdlet te laten wachten tot het opnieuw opstarten is voltooid en DoNotVerify om de cmdlet te laten terugkeren zonder te wachten tot het opnieuw opstarten is voltooid.
Type: | CompletionMode |
Geaccepteerde waarden: | Invalid, DoNotVerify, Verify |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-CreateFabricDump
Geeft aan dat er een procesdump moet worden gemaakt voor Fabric.exe op het opgegeven knooppunt.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-NodeInstanceId
Hiermee geeft u een knooppuntexemplaren-id op.
Tenzij u 0 opgeeft, moet de knooppuntexemplaren-id die u opgeeft overeenkomen met het knooppunt dat momenteel wordt uitgevoerd.
Voer Get-ServiceFabricNode uit voor het doelknooppunt om exemplaar-id's van knooppunten te verkrijgen.
Voor het knooppunt N0050 retourneert de opdracht Get-ServiceFabricNode -NodeName "N0050"
bijvoorbeeld een Node-object dat de exemplaar-id van het knooppunt bevat.
Type: | BigInteger |
Position: | 1 |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-NodeName
Hiermee geeft u de naam van een Service Fabric-knooppunt. De cmdlet start het knooppunt dat u opgeeft opnieuw op.
Type: | String |
Position: | 0 |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-PartitionId
Hiermee geeft u de partitie-id van een Service Fabric-servicepartitie. De cmdlet start een knooppunt opnieuw op dat als host fungeert voor een replica of exemplaar van deze partitie.
Type: | Guid |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-PartitionKey
Hiermee geeft u een partitiesleutel voor een Service Fabric-servicepartitie. De cmdlet identificeert de partitie die deze partitiesleutel toewijst aan een knooppunt dat als host fungeert voor een replica of exemplaar van die partitie.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-PartitionKindNamed
Geeft aan dat de parameter PartitionKey een partitiesleutel opgeeft voor een service die gebruikmaakt van een benoemd partitioneringsschema.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-PartitionKindSingleton
Geeft aan dat de service die is opgegeven in de parameter ServiceName gebruikmaakt van een Singleton-partitie.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-PartitionKindUniformInt64
Geeft aan dat de parameter PartitionKey een partitiesleutel opgeeft voor een service die gebruikmaakt van uniformInt64-partitioneringsschema.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-ReplicaKindPrimary
Geeft aan dat met deze cmdlet het knooppunt opnieuw wordt opgestart dat als host fungeert voor de primaire replica van de opgegeven partitie.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-ReplicaKindRandomSecondary
Geeft aan dat met deze cmdlet het knooppunt opnieuw wordt opgestart dat als host fungeert voor een willekeurige secundaire replica van de opgegeven partitie.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-ReplicaOrInstanceId
Hiermee geeft u een Service Fabric-servicereplica of exemplaar-id op. De cmdlet start het knooppunt opnieuw op dat als host fungeert voor de opgegeven replica of het opgegeven exemplaar.
Type: | Int64 |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-ServiceName
Hiermee geeft u de naam van een Service Fabric-service. De cmdlet start een knooppunt opnieuw op dat als host fungeert voor een replica of exemplaar van deze service.
Type: | Uri |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-TimeoutSec
Hiermee geeft u de time-outperiode, in seconden, op voor de bewerking.
Type: | Int32 |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
Invoerwaarden
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]]
Uitvoerwaarden
System.Object