Delen via

Send-ServiceFabricApplicationHealthReport

  • Referentie
Module:
ServiceFabric

Hiermee wordt een statusrapport verzonden over een Service Fabric-toepassing.

Syntaxis

Send-ServiceFabricApplicationHealthReport
    [-ApplicationName] <Uri>
    -HealthState <HealthState>
    -SourceId <String>
    -HealthProperty <String>
    [-Description <String>]
    [-TimeToLiveSec <Int32>]
    [-RemoveWhenExpired]
    [-SequenceNumber <Int64>]
    [-Immediate]
    [-TimeoutSec <Int32>]
    [<CommonParameters>]

Description

De cmdlet Send-ServiceFabricApplicationHealthReport verzendt een statusrapport in een Service Fabric-toepassing.

De toepassing moet al aanwezig zijn in het statusarchief. Gebruik de cmdlet Get-ServiceFabricApplicationHealth om te controleren of deze bestaat.

De cmdlet verzendt het rapport na een interval dat is opgegeven door de parameter HealthReportSendIntervalInSec van de cmdlet Connect-ServiceFabricCluster . De clusterverbinding moet gedurende deze periode actief worden gehouden. Met deze cmdlet wordt een rapport asynchroon verzonden, dus deze cmdlet kan een waarde van succes verzenden, zelfs als de verwerking mislukt. Als een entiteit bijvoorbeeld wordt verwijderd of als gevolg van een ongeldige parameter, zoals een verlopen volgnummer, kan het statusarchief het rapport weigeren.

Als u wilt zien of het rapport is toegepast in het statusarchief, gebruikt u de cmdlet Get-ServiceFabricApplicationHealth en controleert u of het rapport wordt weergegeven in de sectie HealthEvents .

Als u Service Fabric-clusters wilt beheren, start u Windows PowerShell met behulp van de optie Uitvoeren als administrator. Voordat u een bewerking uitvoert op een Service Fabric-cluster, maakt u een verbinding met het cluster met behulp van de cmdlet Connect-ServiceFabricCluster en vervolgens de cmdlet Get-ServiceFabricClusterConnection .

Voorbeelden

Voorbeeld 1: Rapport foutstatusrapport met oneindige TTL

PS C:\> Send-ServiceFabricApplicationHealthReport -ApplicationName fabric:/MyApplication -SourceId "MyWatchdog" -HealthProperty "Availability" -HealthState Error

Met deze opdracht wordt een statusrapport verzonden over de toepassing met de naam fabric:/MyApplication van de bron MyWatchDog. Het statusrapport bevat informatie over de beschikbaarheid van de status van de status van de eigenschap Fout, met oneindige TTL.

Voorbeeld 2: Rapportwaarschuwing geldig voor opgegeven TTL

PS C:\> Send-ServiceFabricApplicationHealthReport -ApplicationName fabric:/MyApplication -SourceId "MyWatchdog" -HealthProperty "Availability" -HealthState Warning -TimeToLiveSec 10 -RemoveWhenExpired

Met deze opdracht wordt een statusrapport verzonden over de toepassing met de naam fabric:/MyApplication van de bron MyWatchDog. Het statusrapport bevat informatie over de beschikbaarheid van de statuseigenschap in een waarschuwingsstatus. Het rapport blijft 10 seconden in het statusarchief, waarna het automatisch wordt verwijderd.

Parameters

-ApplicationName

Hiermee geeft u de URI (Uniform Resource Identifier) van een Service Fabric-toepassing op. De cmdlet verzendt een statusrapport over de toepassing met de URI die u opgeeft.

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

-Description

Hiermee geeft u door mensen leesbare informatie op over de voorwaarde die het rapport heeft geactiveerd. De parameters SourceId, HealthProperty en HealthState 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 de markering [Afgekapt], om aan te geven dat de 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 op unieke wijze. Het rapport overschrijft eventuele vorige rapporten met dezelfde waarden voor de parameters SourceId en HealthProperty op dezelfde entiteit.

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 het gebatcheerd 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. De Powershell-fabric-client stelt standaard HealthReportSentInterval in op 0, zodat rapporten onmiddellijk worden verzonden.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
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 time-to-live van het rapport verloopt. De rapporten die worden verwijderd wanneer ze zijn 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

-SequenceNumber

Hiermee geeft u het volgnummer dat is gekoppeld aan het statusrapport. Als u geen waarde voor deze parameter opgeeft, wordt het volgnummer automatisch ingesteld. Als u een volgnummer opgeeft, moet deze waarde hoger zijn dan een eerder reeksnummer dat is ingesteld op 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, op 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 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.Uri

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