Send-ServiceFabricPartitionHealthReport

Reference

Modul:: ServiceFabric

Odešle zprávu o stavu v oddílu služby Service Fabric.

Syntax

Send-ServiceFabricPartitionHealthReport
    [-PartitionId] <Guid>
    -HealthState <HealthState>
    -SourceId <String>
    -HealthProperty <String>
    [-Description <String>]
    [-TimeToLiveSec <Int32>]
    [-RemoveWhenExpired]
    [-SequenceNumber <Int64>]
    [-Immediate]
    [-TimeoutSec <Int32>]
    [<CommonParameters>]

Description

Rutina Send-ServiceFabricPartitionHealthReport odešle zprávu o stavu v oddílu služby Service Fabric.

Oddíl už musí existovat v úložišti stavu. Pokud chcete zkontrolovat, jestli existuje, použijte rutinu Get-ServiceFabricPartitionHealth a zadejte ID oddílu. Případně můžete použít rutinu Get-ServiceFabricServiceHealth a zkontrolovat oddíl stavů oddílů a najít oddíl.

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

Rutina může vrátit úspěch, ale sestava se odešle asynchronně, takže zpracování může selhat. Pokud chcete zjistit, jestli se sestava použila v úložišti stavu, použijte rutinu Get-ServiceFabricPartitionHealth a zkontrolujte, jestli se sestava zobrazí v části HealthEvents.

Před provedením jakékoli operace v clusteru Service Fabric vytvořte připojení ke clusteru pomocí rutiny Connect-ServiceFabricCluster .

Příklady

Příklad 1: Sestava stavu chyby s nekonečným TTL

PS C:\> Send-ServiceFabricPartitionHealthReport -PartitionId 869dd2e9-fdda-42a5-ad96-4b71c795dfd3 -SourceId "MyWatchdog" -HealthProperty "Availability" -HealthState Error

Tento příkaz odešle zprávu o stavu zadaného oddílu ze zdrojového myWatchdogu. Sestava stavu obsahuje informace o dostupnosti vlastnosti stavu ve stavu chyby s neomezenou hodnotu TTL.

Příklad 2: Upozornění sestavy platné pro zadanou hodnotu TTL a jeho odebrání po vypršení platnosti

PS C:\> Send-ServiceFabricPartitionHealthReport -PartitionId 869dd2e9-fdda-42a5-ad96-4b71c795dfd3 -SourceId "MyWatchdog" -HealthProperty "ReplicaSet" -HealthState Warning -TimeToLiveSec 10 -RemoveWhenExpired -Description "The communication between replicas have high latency."

Tento příkaz odešle zprávu o stavu zadaného oddílu ze zdrojového myWatchdogu. Sestava stavu obsahuje informace o vlastnosti Health ReplicaSet ve stavu upozornění s 10 sekund TTL. Sestava je označena k odebrání po vypršení platnosti.

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í. Když se zkrátí, popis končí značkou "[Zkráceno]", aby značil 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 sestava má 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ávkot podle konfigurace HealthReportSendInterval. Toto je doporučené nastavení, protože umožňuje klientovi stavu optimalizovat zprávy o stavu pro ukládání 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

-PartitionId

Určuje ID oddílu Service Fabric.

Type:	Guid
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-RemoveWhenExpired

Označuje, že se sestava odebere z úložiště stavu, když vyprší její platnost. Pokud tento parametr nezadáte, entita se považuje za chybový stav, když vyprší platnost času sestavy naživo. Sestavy, které jsou odebrány při vypršení platnosti, se dají použít pro podmínky, které jsou platné jenom po 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é ke zprávě o stavu. Pokud pro tento parametr nezadáte hodnotu, nastaví se pořadové číslo 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 zdroje a HealthProperty nebo je sestava odmítnuta kvůli zastaralému stavu.

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 zadaný parametr RemoveWhenExpired . V opačném případě se entita vyhodnotí jako chyba kvůli sestavě s prošlou 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.Guid

System.Fabric.Health.HealthState

System.String

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