Delen via


Restart-ServiceFabricNode

Start een Service Fabric-knooppunt opnieuw op om een clusterknooppuntfout te simuleren.

Syntax

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
Accepted values:Invalid, DoNotVerify, Verify
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:True
Accept wildcard characters: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
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TimeoutSec

Hiermee geeft u de time-outperiode, in seconden, op voor de bewerking.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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