Send-ServiceFabricDeployedServicePackageHealthReport
Odešle zprávu o stavu balíčku nasazené služby Service Fabric.
Syntaxe
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
Rutina Send-ServiceFabricDeployedServicePackageHealthReport odešle zprávu o stavu nasazeného balíčku služby Service Fabric.
Nasazený balíček služby už musí existovat v úložišti stavu. Pokud chcete zkontrolovat, jestli služba existuje, použijte rutinu Get-ServiceFabricDeployedServicePackageHealth. Zadejte název aplikace, název balíčku služby a název uzlu. Alternativně můžete použít rutinu Get-ServiceFabricDeployedApplicationHealth. Zadejte název aplikace a název uzlu a v části Stav nasazeného balíčku služby vyhledejte balíček služby.
Rutina odešle sestavu po intervalu určeném rutinou HealthReportSendIntervalInSec rutiny Connect-ServiceFabricClus ter. Během této doby musí být připojení ke clusteru aktivní. Příkaz se vyhodnotí v klientovi bez odkazu na spuštění v úložišti stavu. Sestava se nemusí použít v úložišti stavu, i když příkaz vrátí úspěch. Úložiště stavu může například odmítnout sestavu kvůli neplatnému parametru, jako je zastaralé pořadové číslo.
Pokud chcete zjistit, jestli se sestava použila v úložišti stavu, použijte rutinu Get-ServiceFabricDeployedServicePackageHealth a zkontrolujte, jestli se sestava zobrazí v části HealthEvents.
Pokud chcete spravovat clustery Service Fabric, spusťte Windows PowerShell pomocí možnosti Spustit jako správce. Před provedením jakékoli operace v clusteru Service Fabric vytvořte připojení ke clusteru pomocí rutiny Connect-ServiceFabricCluster a potom rutiny Get-ServiceFabricClusterConnection.
Příklady
Příklad 1: Hlášení zprávy o stavu chyby s nekonečným TTL
PS C:\> Send-ServiceFabricDeployedServicePackageHealthReport -ApplicationName fabric:/MyApplication -NodeName "Node01" -ServiceManifestName "MyServiceManifest" -HealthProperty "Memory" -HealthState Error -SourceId "MyWatchdog"Tento příkaz odešle zprávu o stavu nasazeného balíčku služby pro aplikaci s názvem fabric:/MyApplication na uzlu s názvem Node01 pro manifest služby s názvem MyServiceManifest. Sestava stavu obsahuje informace o vlastnosti stavu Paměť ve stavu Chyby ze zdrojového myWatchdogu s nekonečným TTL. Popis není uveden a pořadové číslo se nastaví automaticky.
Příklad 2: Upozornění na hlášení platné pro zadanou hodnotu TTL a jeho odebrání při vypršení platnosti
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 10Tento příkaz odešle zprávu o stavu nasazeného balíčku služby pro aplikaci s názvem fabric:/MyApplication pro manifest služby s názvem MyServiceManifest na uzlu s názvem Node01. Sestava stavu obsahuje informace o vlastnosti stavu CustomSetup ve stavu upozornění ze zdroje MyWatchdog s 10 sekund TTL. Po vypršení platnosti sestavy se odebere z úložiště stavu a už nebude mít vliv na vyhodnocení stavu. Tento příkaz také poskytuje popis upozornění.
Parametry
-ApplicationName
Určuje identifikátor URI (Uniform Resource Identifier) aplikace Service Fabric. Rutina odešle zprávu o stavu pro aplikaci, která má zadaný identifikátor URI.
| Typ: | Uri |
| Position: | 0 |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-Description
Určuje čitelné informace o podmínce, která sestavu aktivovala. Parametry SourceId, HealthPropertya Health State plně popisují sestavu.
Maximální délka řetězce popisu je 4096 znaků. Pokud je zadaný řetězec delší, automaticky se zkrátí. Po zkrácení popis končí značkou [Zkráceno]", která uživatelům indikuje, že došlo ke zkrácení. Celková velikost řetězce je 4096 znaků, takže se zachová méně než 4096 znaků z původního řetězce.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-HealthProperty
Určuje vlastnost sestavy. Společně s parametrem SourceId tato vlastnost jedinečně identifikuje sestavu. Sestava přepíše všechny předchozí sestavy se stejnými hodnotami pro SourceId a HealthProperty parametry stejné entity.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-HealthState
Určuje HealthState objekt, který představuje hlášený stav.
| Typ: | HealthState |
| Přípustné hodnoty: | Invalid, Ok, Warning, Error, Unknown |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-Immediate
Určuje, jestli se má sestava okamžitě odeslat do úložiště stavu. To je užitečné pro kritické sestavy, které by se měly odesílat co nejdříve. Pokud není zadáno, sestava se odešle na základě nastavení klienta stavu. Proto bude dávková podle konfigurace HealthReportSendInterval. Toto je doporučené nastavení, protože umožňuje klientovi stavu optimalizovat zprávy sestav o stavu do úložiště stavu a zpracování sestav stavu. Ve výchozím nastavení klient prostředků infrastruktury PowerShellu nastaví HealthReportSentInterval na hodnotu 0, aby se sestavy odesílaly okamžitě.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-NodeName
Určuje název uzlu Service Fabric. Rutina odešle zprávu o stavu balíčku služby nasazeného v zadaném uzlu.
| Typ: | String |
| Position: | 2 |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-RemoveWhenExpired
Označuje, že se sestava po vypršení platnosti odebere z úložiště stavu. Pokud tento parametr nezadáte, entita se při vypršení doby živého přenosu sestavy považuje za chybový stav. Sestavy, které jsou po vypršení platnosti odebrány, lze použít pro podmínky, které jsou platné pouze po určitou dobu nebo pro vymazání sestav z Úložiště stavu.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-SequenceNumber
Určuje pořadové číslo přidružené k sestavě stavu. Pokud nezadáte hodnotu pro tento parametr, pořadové číslo se nastaví automaticky. Pokud zadáte pořadové číslo, musí být tato hodnota vyšší než jakékoli předchozí pořadové číslo nastavené na stejné SourceId a HealthPropertynebo je sestava odmítnuta z důvodu neagrese.
| Typ: | Int64 |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-ServiceManifestName
Určuje název manifestu služby Service Fabric. Společně s ApplicationName a NodeNametato hodnota jednoznačně identifikuje entitu stavu nasazeného balíčku služby.
| Typ: | String |
| Position: | 1 |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-ServicePackageActivationId
ID aktivace nasazeného servicepackage. To lze získat pomocí dotazu Get-ServiceFabricDeployedServicePackage.
Pokud ServicePackageActivationMode zadaný při vytváření služby (pomocí New-ServiceFabricService) je SharedProcess (nebo pokud není zadaný, v takovém případě se ve výchozím nastavení SharedProcess), pak hodnota ServicePackageActivationId je vždy prázdný řetězec a nemusí být zadán. Další informace o ID aktivace balíčku služby najdete v tématu [Model hostování Service Fabric][1].
| Typ: | String |
| Position: | 3 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-SourceId
Určuje identifikátor zdroje, který sestavu aktivoval.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-TimeoutSec
Určuje časový limit operace v sekundách.
| Typ: | Int32 |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-TimeToLiveSec
Určuje hodnotu TTL (Time to Live) sestavy v sekundách. Po vypršení platnosti hodnoty TTL se sestava odebere z úložiště stavu, pokud je zadaný parametr RemoveWhenExpired. V opačném případě se entita vyhodnotí jako chyba kvůli sestavě s vypršenou platností. Výchozí hodnota je Nekonečná.
| Typ: | Int32 |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
Vstupy
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]]
Výstupy
System.Object