Send-ServiceFabricDeployedServicePackageHealthReport
Skickar en hälsorapport på ett Service Fabric-distribuerat tjänstpaket.
Syntax
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
Cmdleten Send-ServiceFabricDeployedServicePackageHealthReport skickar en hälsorapport i ett Service Fabric-distribuerat tjänstpaket.
Det distribuerade tjänstpaketet måste redan finnas i hälsoarkivet. Om du vill kontrollera om tjänsten finns använder du cmdleten Get-ServiceFabricDeployedServicePackageHealth. Ange programnamn, tjänstpaketnamn och nodnamn. Du kan också använda cmdleten Get-ServiceFabricDeployedApplicationHealth. Ange programmets namn och nodnamn och kontrollera avsnittet om hälsotillstånd för distribuerade tjänstpaket för att hitta tjänstpaketet.
Cmdleten skickar rapporten efter ett intervall som anges av parametern HealthReportSendIntervalInSec för cmdleten Connect-ServiceFabricCluster. Klusteranslutningen måste hållas vid liv under den här tiden. Kommandot utvärderas på klienten utan referens till att köras i hälsoarkivet. Rapporten kanske inte tillämpas i hälsoarkivet även om kommandot returnerar lyckat resultat. Hälsoarkivet kan till exempel avvisa rapporten på grund av en ogiltig parameter, till exempel ett inaktuellt sekvensnummer.
Om du vill se om rapporten tillämpades i hälsoarkivet använder du cmdleten Get-ServiceFabricDeployedServicePackageHealth och kontrollerar att rapporten visas i avsnittet HealthEvents.
Om du vill hantera Service Fabric-kluster startar du Windows PowerShell med alternativet Kör som administratör. Innan du utför någon åtgärd i ett Service Fabric-kluster upprättar du en anslutning till klustret med hjälp av cmdleten Connect-ServiceFabricCluster och sedan cmdleten Get-ServiceFabricClusterConnection.
Exempel
Exempel 1: Rapportera felhälsorapport med oändlig TTL
PS C:\> Send-ServiceFabricDeployedServicePackageHealthReport -ApplicationName fabric:/MyApplication -NodeName "Node01" -ServiceManifestName "MyServiceManifest" -HealthProperty "Memory" -HealthState Error -SourceId "MyWatchdog"Det här kommandot skickar en hälsorapport för ett distribuerat tjänstpaket för programmet med namnet fabric:/MyApplication på noden Node01 för tjänstmanifestet med namnet MyServiceManifest. Hälsorapporten innehåller information om hälsoegenskapen Minne i feltillstånd från källan MyWatchdog, med oändlig TTL. Beskrivningen anges inte och sekvensnumret anges automatiskt.
Exempel 2: Rapportvarningen är giltig för angiven TTL och tar bort den när den upphör att gälla
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 10Det här kommandot skickar en hälsorapport för ett distribuerat tjänstpaket för programmet med namnet fabric:/MyApplication för tjänstmanifestet med namnet MyServiceManifest på noden Node01. Hälsorapporten innehåller information om hälsoegenskapen CustomSetup- i ett varningstillstånd från källan MyWatchdog, med 10 sekunders TTL. När rapporten har upphört att gälla tas den bort från hälsoarkivet och påverkar inte längre hälsoutvärderingen. Det här kommandot ger också en beskrivning av varningen.
Parametrar
-ApplicationName
Anger URI (Uniform Resource Identifier) för ett Service Fabric-program. Cmdleten skickar en hälsorapport för programmet som har den URI som du anger.
| Typ: | Uri |
| Position: | 0 |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-Description
Anger läsbar information om det villkor som utlöste rapporten. Parametrarna SourceId, HealthPropertyoch HealthState beskriver rapporten fullständigt.
Den maximala stränglängden för beskrivningen är 4 096 tecken. Om den angivna strängen är längre trunkeras den automatiskt. När beskrivningen trunkeras avslutas den med en markör, "[Trunkerad]", för att indikera för användarna att trunkeringen inträffade. Den totala strängstorleken är 4 096 tecken, så mindre än 4 096 tecken från den ursprungliga strängen behålls.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-HealthProperty
Anger rapportens egenskap. Tillsammans med parametern SourceId identifierar den här egenskapen rapporten unikt. Rapporten åsidosätter alla tidigare rapporter med samma värden för parametrarna SourceId och HealthProperty på samma entitet.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-HealthState
Anger ett HealthState- objekt som representerar det rapporterade hälsotillståndet.
| Typ: | HealthState |
| Godkända värden: | Invalid, Ok, Warning, Error, Unknown |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-Immediate
Anger om rapporten ska skickas till hälsoarkivet omedelbart. Detta är användbart för kritiska rapporter som ska skickas så snart som möjligt. Om den inte anges skickas rapporten baserat på hälsoklientinställningarna. Därför batchas den enligt konfigurationen HealthReportSendInterval. Det här är den rekommenderade inställningen eftersom den gör det möjligt för hälsoklienten att optimera hälsorapporteringsmeddelanden till hälsoarkivet samt bearbetning av hälsorapporter. Som standard anger Powershell fabric-klienten HealthReportSentInterval till 0, så rapporter skickas omedelbart.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-NodeName
Anger namnet på en Service Fabric-nod. Cmdleten skickar en hälsorapport för ett tjänstpaket som distribueras på den nod som du anger.
| Typ: | String |
| Position: | 2 |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-RemoveWhenExpired
Anger att rapporten tas bort från hälsoarkivet när den upphör att gälla. Om du inte anger den här parametern anses entiteten vara i feltillstånd när rapporttiden för live upphör att gälla. De rapporter som tas bort när de har upphört att gälla kan användas för villkor som endast är giltiga under en tidsperiod eller för att rensa rapporter från Hälsoarkivet.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-SequenceNumber
Anger det sekvensnummer som är associerat med hälsorapporten. Om du inte anger något värde för den här parametern anges sekvensnumret automatiskt. Om du anger ett sekvensnummer måste det värdet vara högre än något tidigare sekvensnummer som angetts på samma SourceId och HealthProperty, eller så avvisas rapporten på grund av inaktuellhet.
| Typ: | Int64 |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-ServiceManifestName
Anger namnet på ett Service Fabric-tjänstmanifest. Tillsammans med ApplicationName och NodeNameidentifierar det här värdet unikt den distribuerade hälsoentiteten för tjänstpaket.
| Typ: | String |
| Position: | 1 |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-ServicePackageActivationId
Aktiverings-ID:t för den distribuerade ServicePackage. Detta kan hämtas med hjälp av frågan Get-ServiceFabricDeployedServicePackage.
Om ServicePackageActivationMode som angavs när tjänsten skapades (med hjälp av New-ServiceFabricService) är SharedProcess (eller om den inte har angetts, i vilket fall den som standard SharedProcess), är värdet för ServicePackageActivationId alltid en tom sträng och behöver inte anges. Mer information om aktiverings-ID för tjänstpaket finns i [Service Fabric Hosting Model][1].
| Typ: | String |
| Position: | 3 |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-SourceId
Anger identifieraren för källan som utlöste rapporten.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-TimeoutSec
Anger tidsgränsen i sekunder för åtgärden.
| Typ: | Int32 |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-TimeToLiveSec
Anger TTL (Time to Live) för rapporten i sekunder. När TTL upphör att gälla tas rapporten bort från hälsoarkivet om parametern RemoveWhenExpired anges. I annat fall utvärderas entiteten vid Fel på grund av att rapporten har upphört att gälla. Standardvärdet är Oändligt.
| Typ: | Int32 |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
Indata
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]]
Utdata
System.Object