Send-ServiceFabricDeployedServicePackageHealthReport
Odešle zprávu o stavu balíčku služby nasazené službou Service Fabric.
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
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 zkontrolujte oddíl stavu nasazeného balíčku služby a vyhledejte balíček služby.
Rutina odešle sestavu po intervalu určeném parametrem HealthReportSendIntervalInSec rutiny Connect-ServiceFabricCluster . Během této doby musí být připojení ke clusteru aktivní. Příkaz se vyhodnocuje na 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. Například úložiště stavu může sestavu odmítnout z důvodu neplatného parametru, například zastaralého pořadového čísla.
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 pak 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 stav Paměť ve stavu chyby ze zdrojového myWatchdog s nekonečným TTL. Popis není zadán a pořadové číslo se nastaví automaticky.
Příklad 2: Upozornění sestavy platné pro zadanou hodnotu TTL a odebrání po 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 10
Tento 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 zdrojového myWatchdog s 10 sekund TTL. Po vypršení platnosti sestavy se odebere z úložiště stavu a nebude mít vliv na vyhodnocení stavu. Tento příkaz také obsahuje 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.
Type: | Uri |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Description
Určuje čitelné informace o podmínce, která sestavu aktivovala. Parametry SourceId, HealthProperty a HealthState plně popisují sestavu.
Maximální délka řetězce popisu je 4096 znaků. Pokud je zadaný řetězec delší, automaticky se zkrátí. Při zkrácení končí popis značkou [Zkráceno]" a značí tak uživatelům, ž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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 parametry SourceId a HealthProperty ve stejné entitě.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-HealthState
Určuje objekt HealthState , který představuje hlášený stav.
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
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 co nejdříve odeslat. Pokud není zadáno, sestava se odešle na základě nastavení klienta stavu. Proto se bude dávková podle konfigurace HealthReportSendInterval. Toto je doporučené nastavení, protože umožňuje klientovi stavu optimalizovat zprávy o sestavách 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, takže se sestavy odesílají okamžitě.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NodeName
Určuje název uzlu Service Fabric. Rutina odešle zprávu o stavu balíčku služby nasazeného na zadaný uzel.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RemoveWhenExpired
Označuje, že sestava se po vypršení platnosti odebere z úložiště stavu. Pokud tento parametr nezadáte, entita se považuje za chybový stav, když vyprší platnost času sestavy naživo. Sestavy, které se odeberou, když vypršela platnost, se dají použít pro podmínky, které jsou platné jenom po určitou dobu, nebo pro vymazání sestav ze služby Health Store.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SequenceNumber
Určuje pořadové číslo přidružené k sestavě stavu. Pokud pro tento parametr nezadáte hodnotu, 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é Id SourceId a HealthProperty nebo je sestava odmítnuta kvůli nestaralosti.
Type: | Int64 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServiceManifestName
Určuje název manifestu služby Service Fabric. Společně s ApplicationName a NodeName tato hodnota jednoznačně identifikuje entitu stavu nasazeného balíčku služby.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServicePackageActivationId
ID aktivace nasazeného balíčku ServicePackage. To lze získat pomocí dotazu Get-ServiceFabricDeployedServicePackage.
Pokud je hodnota ServicePackageActivationMode zadaná v době vytvoření služby (pomocí New-ServiceFabricService
) SharedProcess (nebo pokud není zadána, v takovém případě je nastavena na SharedProcess), pak hodnota ServicePackageActivationId je vždy prázdný řetězec a není nutné ho zadat. Další informace o ID aktivace balíčku služby najdete v tématu [Model hostování Service Fabric][1].
Type: | String |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SourceId
Určuje identifikátor zdroje, který sestavu aktivoval.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TimeoutSec
Určuje časový limit operace v sekundách.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeToLiveSec
Určuje hodnotu TTL (Time to Live) sestavy v sekundách. Pokud vyprší platnost hodnoty TTL, sestava se odebere z úložiště stavu, pokud je zadán parametr RemoveWhenExpired . V opačném případě se entita vyhodnotí jako chyba z důvodu sestavy s vypršenou platností. Výchozí hodnota je Nekonečné.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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