Send-ServiceFabricClusterHealthReport
Hiermee wordt een statusrapport verzonden op een Service Fabric-cluster.
Syntax
Send-ServiceFabricClusterHealthReport
-HealthState <HealthState>
-SourceId <String>
-HealthProperty <String>
[-Description <String>]
[-TimeToLiveSec <Int32>]
[-RemoveWhenExpired]
[-SequenceNumber <Int64>]
[-Immediate]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Description
De cmdlet Send-ServiceFabricClusterHealthReport verzendt een statusrapport op een Service Fabric-cluster.
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 tijd actief worden gehouden. De opdracht wordt op de client geƫvalueerd zonder te verwijzen naar uitvoering in het statusarchief. Het rapport wordt mogelijk niet toegepast in het statusarchief, zelfs niet als de opdracht is geslaagd. Het statusarchief kan bijvoorbeeld het rapport afwijzen vanwege een ongeldige parameter, zoals een verlopen volgnummer.
Als u wilt zien of het rapport is toegepast in het statusarchief, gebruikt u de cmdlet Get-ServiceFabricClusterHealth 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 rapporteren met oneindige TTL
PS C:\> Send-ServiceFabricClusterHealthReport -SourceId "MyWatchdog" -HealthProperty "Availability" -HealthState Error
Met deze opdracht wordt een statusrapport op het cluster verzonden vanuit de bron-MyWatchdog. Het statusrapport bevat informatie over de beschikbaarheid van de statuseigenschap in de status Fout, met oneindige TTL.
Voorbeeld 2: Rapportwaarschuwing geldig voor opgegeven TTL
PS C:\> Send-ServiceFabricClusterHealthReport -SourceId "MyWatchdog" -HealthProperty "EnoughNodes" -HealthState Warning -TimeToLiveSec 10 -RemoveWhenExpired -SequenceNumber 1344
Met deze opdracht wordt een statusrapport op het cluster verzonden vanuit de bron-MyWatchDog. Het statusrapport bevat informatie over de statuseigenschap EnoughNodes in een waarschuwingsstatus . Het rapport blijft 10 seconden in de statusopslag, waarna het automatisch wordt verwijderd. Met de opdracht geeft u de parameter SequenceNumber op. Het volgnummer moet hoger zijn dan eventuele eerder gerapporteerde volgnummers voor dezelfde SourceId en Eigenschap, of het rapport wordt geweigerd vanwege verouderingen.
Parameters
-Description
Hiermee geeft u menselijke leesbare informatie 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 een markering [Afgekapt], om aan te geven dat gebruikers die afkapping hebben plaatsgevonden. De totale tekenreeksgrootte is 4096 tekens, dus minder dan 4096 tekens uit de oorspronkelijke tekenreeks worden bewaard.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 eerdere rapporten met dezelfde waarden voor de parameters SourceId en HealthProperty op dezelfde entiteit.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-HealthState
Hiermee geeft u een HealthState-object op dat de gerapporteerde status vertegenwoordigt.
Type: | HealthState |
Accepted values: | Invalid, Ok, Warning, Error, Unknown |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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 statusrapportageberichten kan optimaliseren naar het statusarchief en de verwerking van statusrapporten. Standaard stelt de PowerShell-fabricclient HealthReportSentInterval in op 0, zodat rapporten onmiddellijk worden verzonden.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 gedurende een bepaalde periode of voor het wissen van rapporten uit Health Store.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 reeksnummer opgeeft, moet deze waarde hoger zijn dan een eerdere reeksnummer dat is ingesteld op dezelfde SourceId en HealthProperty, of wordt het rapport geweigerd vanwege verouderingen.
Type: | Int64 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SourceId
Hiermee geeft u de id op van de bron die het rapport heeft geactiveerd.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TimeoutSec
Hiermee geeft u de time-outperiode, in seconden, voor de bewerking op.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Invoerwaarden
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