Send-ServiceFabricServiceHealthReport
Hiermee wordt een statusrapport verzonden over een Service Fabric-service.
Syntaxis
Send-ServiceFabricServiceHealthReport
[-ServiceName] <Uri>
-HealthState <HealthState>
-SourceId <String>
-HealthProperty <String>
[-Description <String>]
[-TimeToLiveSec <Int32>]
[-RemoveWhenExpired]
[-SequenceNumber <Int64>]
[-Immediate]
[-TimeoutSec <Int32>]
[<CommonParameters>] Description
De cmdlet Send-ServiceFabricServiceHealthReport verzendt een statusrapport op een Service Fabric-service.
De service moet al aanwezig zijn in het statusarchief. Als u wilt controleren of deze bestaat, gebruikt u de cmdlet Get-ServiceFabricServiceHealth en geeft u de parameter ServiceName op. U kunt ook de cmdlet Get-ServiceFabricApplicationHealth gebruiken om de toepassingsgegevens op te halen en vervolgens de sectie servicestatussen te controleren om de gewenste service te vinden.
Het rapport wordt verzonden na het aantal seconden dat is opgegeven in de parameter HealthReportSendIntervalInSec van de cmdlet Connect-ServiceFabricCluster . De clusterverbinding moet gedurende deze periode actief worden gehouden.
De cmdlet kan slagen, maar het rapport wordt asynchroon verzonden, zodat de verwerking kan mislukken. Als u wilt zien of het rapport is toegepast in het statusarchief, gebruikt u de cmdlet Get-ServiceFabricServiceHealth en controleert u of het rapport wordt weergegeven in de sectie HealthEvents.
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: Rapport foutstatusrapport met oneindige TTL
PS C:\> Send-ServiceFabricServiceHealthReport -ServiceName fabric:/MyApplication/MyService -SourceId "MyWatchdog" -HealthProperty "Availability" -HealthState Error -Description "The service is not available."Met deze opdracht wordt een statusrapport verzonden voor de service met de naam fabric:/MyApplication/MyService van de bron MyWatchDog. Het statusrapport bevat informatie over de beschikbaarheid van de status van de status van de eigenschap Fout, met oneindige TTL. Met deze opdracht krijgt u ook een beschrijving voor de fout.
Voorbeeld 2: Rapportwaarschuwing geldig voor opgegeven TTL
PS C:\> Send-ServiceFabricServiceHealthReport -ServiceName fabric:/MyApplication/MyService -SourceId "MyWatchdog" -HealthProperty "PrivateData" -HealthState Warning -TimeToLiveSec 10 -RemoveWhenExpired -Description "Accessing private data in database MyServicePrivateData is slow."Met deze opdracht wordt een statusrapport verzonden over de service met de naam fabric:/MyApplication/MyService van de bron MyWatchdog. Het statusrapport bevat informatie over de statuseigenschap PrivateData in een waarschuwingsstatus met 10 seconden TTL en markeert het rapport voor verwijdering na verlooptijd.
Parameters
-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.
| 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 |
-ServiceName
Hiermee geeft u de URI (Uniform Resource Identifier) van een Service Fabric-service op.
| Type: | Uri |
| Position: | 0 |
| Default value: | None |
| Vereist: | True |
| 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