Delen via

Send-ServiceFabricDeployedServicePackageHealthReport

  • Referentie
Module:
ServiceFabric

Hiermee wordt een statusrapport verzonden over een servicepakket dat is geïmplementeerd in Service Fabric.

Syntaxis

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

Description

De cmdlet Send-ServiceFabricDeployedServicePackageHealthReport verzendt een statusrapport over een service fabric-geïmplementeerd servicepakket.

Het geïmplementeerde servicepakket moet al aanwezig zijn in het statusarchief. Gebruik de cmdlet Get-ServiceFabricDeployedServicePackageHealth om te controleren of de service bestaat. Geef de naam van de toepassing, de naam van het servicepakket en de naam van het knooppunt op. U kunt ook de cmdlet Get-ServiceFabricDeployedApplicationHealth gebruiken. Geef de naam en knooppuntnaam van de toepassing op en controleer de sectie statusstatussen van het geïmplementeerde servicepakket om het servicepakket te vinden.

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-ServiceFabricDeployedServicePackageHealth 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-ServiceFabricDeployedServicePackageHealthReport -ApplicationName fabric:/MyApplication -NodeName "Node01" -ServiceManifestName "MyServiceManifest" -HealthProperty "Memory" -HealthState Error -SourceId "MyWatchdog"

Met deze opdracht wordt een statusrapport verzonden over een geïmplementeerd servicepakket voor de toepassing met de naam fabric:/MyApplication op het knooppunt Node01 voor het servicemanifest met de naam MyServiceManifest. Het statusrapport bevat informatie over de statuseigenschap Geheugen in een foutstatus van de bron MyWatchdog, met oneindige TTL. De beschrijving wordt niet opgegeven en het volgnummer wordt automatisch ingesteld.

Voorbeeld 2: Rapportwaarschuwing geldig voor de opgegeven TTL en verwijderen wanneer deze verloopt

PS C:\> Send-ServiceFabricDeployedServicePackageHealthReport -ApplicationName fabric:/MyApplication -ServiceManifestName MyServiceManifest -NodeName "Node01" -HealthProperty "CustomSetup" -HealthState Warning -SourceId MyWatchdog -RemoveWhenExpired -Description "The setup has completed with some warnings." -TimeToLiveSec 10

Met deze opdracht wordt een statusrapport verzonden over een geïmplementeerd servicepakket voor de toepassing met de naam fabric:/MyApplication voor het servicemanifest met de naam MyServiceManifest op het knooppunt node01. Het statusrapport bevat informatie over de statuseigenschap CustomSetup in een waarschuwingsstatus van de bron MyWatchdog, met 10 seconden TTL. Nadat het rapport is verlopen, wordt het verwijderd uit het statusarchief en heeft dit geen invloed meer op de statusevaluatie. Deze opdracht geeft ook een beschrijving van de waarschuwing.

Parameters

-ApplicationName

Hiermee geeft u de URI (Uniform Resource Identifier) van een Service Fabric-toepassing op. De cmdlet verzendt een statusrapport voor 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 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
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 eerdere 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 op 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 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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-NodeName

Hiermee geeft u de naam van een Service Fabric-knooppunt. De cmdlet verzendt een statusrapport voor een servicepakket dat is geïmplementeerd op het knooppunt dat u opgeeft.

Type:String
Position:2
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 gedurende 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 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
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ServiceManifestName

Hiermee geeft u de naam van een Service Fabric-servicemanifest. Samen met ApplicationName en NodeName identificeert deze waarde de entiteit voor de status van het geïmplementeerde servicepakket.

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

-ServicePackageActivationId

De activerings-id van de geïmplementeerde ServicePackage. Dit kan worden verkregen met behulp van de query Get-ServiceFabricDeployedServicePackage.

Als ServicePackageActivationMode die is opgegeven op het moment dat de service wordt gemaakt (met behulp van New-ServiceFabricService) SharedProcess is (of als deze niet is opgegeven, in welk geval deze standaard wordt ingesteld op SharedProcess), is de waarde van ServicePackageActivationId altijd een lege tekenreeks en hoeft niet te worden opgegeven. Zie [Service Fabric Hosting Model][1] voor meer informatie over de activerings-id van het servicepakket.

Type:String
Position:3
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 op.

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.String

System.Fabric.Health.HealthState

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