Send-ServiceFabricNodeHealthReport

Reference

Modul:: ServiceFabric

Odešle zprávu o stavu na uzlu Service Fabric.

Syntax

Send-ServiceFabricNodeHealthReport
    [-NodeName] <String>
    -HealthState <HealthState>
    -SourceId <String>
    -HealthProperty <String>
    [-Description <String>]
    [-TimeToLiveSec <Int32>]
    [-RemoveWhenExpired]
    [-SequenceNumber <Int64>]
    [-Immediate]
    [-TimeoutSec <Int32>]
    [<CommonParameters>]

Description

Rutina Send-ServiceFabricNodeHealthReport odešle sestavu stavu na uzlu Service Fabric.

Uzel již musí existovat v úložišti stavu. Pokud chcete zkontrolovat, jestli existuje, použijte rutinu Get-ServiceFabricNodeHealth . Alternativně můžete použít rutinu Get-ServiceFabricNode . Pokud rutina získá uzel a uzel má platný stav, pak uzel existuje v úložišti stavu.

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-ServiceFabricNodeHealth 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-ServiceFabricNodeHealthReport -NodeName "Node01" -SourceId "MyWatchdog" -HealthProperty "Firewall" -HealthState Error -Description "Firewall rules were not correctly applied"

Tento příkaz odešle zprávu o stavu na uzlu s názvem Node01 ze zdroje s názvem MyWatchdog. Sestava stavu obsahuje informace o vlastnosti stav firewall ve stavu chyby s nekonečnou hodnotu TTL.

Příklad 2: Upozornění sestavy platné pro zadanou hodnotu TTL

PS C:\> Send-ServiceFabricNodeHealthReport -NodeName "Node01" -SourceId "MyWatchdog" -HealthProperty "CPU" -HealthState Warning -Description "CPU has been more than 90% for the last hour." -TimeToLiveSec 10 -RemoveWhenExpired

Tento příkaz odešle zprávu o stavu na uzlu s názvem Node01 ze zdroje s názvem MyWatchdog. Sestava stavu obsahuje informace o procesoru vlastnosti stavu ve stavu upozornění. Příkaz také poskytne popis upozornění, nastaví hodnotu TTL na 10 sekund a nakonfiguruje, aby se sestava po vypršení platnosti odebrala.

Parametry

-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 na zadaný uzel.

Type:	String
Position:	0
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

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