Delen via

Send-ServiceFabricReplicaHealthReport

  • Referentie
Module:
ServiceFabric

Hiermee wordt een statusrapport verzonden op een Service Fabric-replica.

Syntaxis

Send-ServiceFabricReplicaHealthReport
    [-PartitionId] <Guid>
    -ReplicaId <Int64>
    -HealthState <HealthState>
    -SourceId <String>
    -HealthProperty <String>
    [-Description <String>]
    [-TimeToLiveSec <Int32>]
    [-RemoveWhenExpired]
    [-SequenceNumber <Int64>]
    [-Immediate]
    [-TimeoutSec <Int32>]
    [<CommonParameters>]
Send-ServiceFabricReplicaHealthReport
    [-PartitionId] <Guid>
    -InstanceId <Int64>
    -HealthState <HealthState>
    -SourceId <String>
    -HealthProperty <String>
    [-Description <String>]
    [-TimeToLiveSec <Int32>]
    [-RemoveWhenExpired]
    [-SequenceNumber <Int64>]
    [-Immediate]
    [-TimeoutSec <Int32>]
    [<CommonParameters>]

Description

De Send-ServiceFabricReplicaHealthReport cmdlet verzendt een statusrapport op een stateless service-exemplaar van Service Fabric of een stateful servicereplica.

Het stateless service-exemplaar of de stateful servicereplica moet al aanwezig zijn in het statusarchief. Als u wilt controleren of deze bestaat, gebruikt u de cmdlet Get-ServiceFabricReplicaHealth en geeft u de PartitionId en ReplicaOrInstanceId parameters op. U kunt ook de cmdlet Get-ServiceFabricPartitionHealth met de parameter PartitionId gebruiken en vervolgens de sectie ReplicaHealthStates controleren om de replica te vinden.

De cmdlet verzendt het rapport na een interval dat is opgegeven door de HealthReportSendIntervalInSec parameter van de Connect-ServiceFabricCluster cmdlet. De clusterverbinding moet gedurende deze tijd actief blijven.

De cmdlet kan een succes retourneren, maar het rapport wordt asynchroon verzonden, zodat de verwerking ervan kan mislukken. Als u wilt zien of het rapport is toegepast in het statusarchief, gebruikt u de cmdlet Get-ServiceFabricReplicaHealth en controleert u of het rapport wordt weergegeven in de sectie Statusgebeurtenissen.

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: Foutstatusrapport rapporteren over een stateful servicereplica met oneindige TTL

PS C:\> Send-ServiceFabricReplicaHealthReport -PartitionId 869dd2e9-fdda-42a5-ad96-4b71c795dfd3 -ReplicaId 130464806670632402 -SourceId "MyWatchdog" -HealthProperty "DiskUsage" -HealthState Error -Description "Disk is full"

Met deze opdracht wordt een statusrapport verzonden voor de opgegeven partitie voor de opgegeven stateful servicereplica van de bron MyWatchDog. Het statusrapport bevat informatie over de statuseigenschap DiskUsage met een foutstatus, met oneindige TTL. Deze opdracht geeft ook een beschrijving van de fout.

Voorbeeld 2: Rapport waarschuwingsstatusrapport over een staatloze service-instantie die geldig is voor de opgegeven TTL en verwijderen wanneer deze verloopt

PS C:\> Send-ServiceFabricReplicaHealthReport -PartitionId 1a151ac7-9c25-4528-81fc-4c6bb9909394 -InstanceId 130464806670632403 -SourceId "MyWatchdog" -HealthProperty "Resources" -HealthState Warning -Description "Access to resources is temporarily disabled" -TimeToLiveSec 10 -RemoveWhenExpired

Met deze opdracht wordt een statusrapport verzonden voor het opgegeven stateless service-exemplaar van de bron MyWatchDog. Het statusrapport bevat informatie over de statuseigenschap Resources in een waarschuwingsstatus van de bron MyWatchdog, met 10 seconden TTL. Het rapport dat is gemarkeerd voor verwijdering na verloop van tijd.

Parameters

-Description

Hiermee geeft u menselijke leesbare informatie op over de voorwaarde die het rapport heeft geactiveerd. De SourceId, HealthPropertyen HealthState parameters beschrijven het rapport volledig.

De maximale tekenreekslengte voor de beschrijving is 4096 tekens. Als de opgegeven tekenreeks langer is, wordt deze automatisch afgekapt. Wanneer de beschrijving is afgekapt, eindigt de beschrijving met een markering [Afgekapt], om aan te geven dat er een afkapping is opgetreden. De totale tekenreeksgrootte is 4096 tekens, dus minder dan 4096 tekens uit de oorspronkelijke tekenreeks worden bewaard.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-HealthProperty

Hiermee geeft u de eigenschap van het rapport. Samen met de parameter SourceId identificeert deze eigenschap het rapport uniek.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-HealthState

Hiermee geeft u een HealthState-object dat de gerapporteerde status vertegenwoordigt.

Type:HealthState
Geaccepteerde waarden:Invalid, Ok, Warning, Error, Unknown
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Immediate

Hiermee geeft u op of het rapport onmiddellijk naar het statusarchief moet worden verzonden. Dit is handig voor kritieke rapporten die zo snel mogelijk moeten worden verzonden. Als dit niet is opgegeven, wordt het rapport verzonden op basis van de statusclientinstellingen. Daarom wordt deze batched volgens de HealthReportSendInterval-configuratie. Dit is de aanbevolen instelling omdat de statusclient berichten voor statusrapportage kan optimaliseren in het statusarchief en de verwerking van statusrapporten. Standaard stelt de PowerShell-infrastructuurclient HealthReportSentInterval in op 0, zodat rapporten onmiddellijk worden verzonden.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InstanceId

Hiermee geeft u de staatloze service-exemplaar-id. De exemplaar-id is alleen geldig voor stateless services. Een rapport voor een stateful replica die gebruikmaakt van InstanceId- in plaats van ReplicaId- wordt geaccepteerd door de statusclient, maar wordt geweigerd door het statusarchief.

Type:Int64
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PartitionId

Hiermee geeft u de id van een Service Fabric-partitie.

Type:Guid
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-RemoveWhenExpired

Geeft aan dat het rapport wordt verwijderd uit het statusarchief wanneer het verloopt. Als u deze parameter niet opgeeft, wordt de entiteit als foutstatus beschouwd wanneer de tijd van het rapport voor live verloopt. De rapporten die worden verwijderd wanneer verlopen, kunnen worden gebruikt voor voorwaarden die alleen geldig zijn voor een bepaalde periode of voor het wissen van rapporten uit Health Store.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ReplicaId

Hiermee geeft u de stateful servicereplica-id. De replica-id is alleen geldig voor stateful services. Een rapport voor een staatloze instantie die gebruikmaakt van ReplicaId- in plaats van InstaceId- wordt geaccepteerd door de statusclient, maar wordt geweigerd door het statusarchief.

Type:Int64
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SequenceNumber

Hiermee geeft u het volgnummer dat aan het statusrapport is gekoppeld. Als u geen waarde voor deze parameter opgeeft, wordt het volgnummer automatisch ingesteld. Als u een volgnummer opgeeft, moet die waarde hoger zijn dan een eerder reeksnummer dat is ingesteld op dezelfde entiteit voor dezelfde SourceId en HealthProperty, of wordt het rapport geweigerd vanwege veroudering.

Type:Int64
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SourceId

Hiermee geeft u de id op van de bron die het rapport heeft geactiveerd.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-TimeoutSec

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

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TimeToLiveSec

Hiermee geeft u de Time to Live (TTL) van het rapport in seconden. Wanneer de TTL verloopt, wordt het rapport verwijderd uit het statusarchief als de parameter RemoveWhenExpired parameter is opgegeven. Anders wordt de entiteit geëvalueerd bij Fout vanwege het verlopen rapport. De standaardwaarde is Oneindig.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

System.Guid

System.Fabric.Health.HealthState

System.String

System.Nullable`1[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

System.Management.Automation.SwitchParameter

System.Nullable`1[[System.Int64, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Uitvoerwaarden

System.Object