Get-ServiceFabricServiceHealth

  • Referenz
Modul:
ServiceFabric

Ruft den Status eines Service Fabric-Diensts ab.

Syntax

Get-ServiceFabricServiceHealth
   [-ServiceName] <Uri>
   [-ConsiderWarningAsError <Boolean>]
   [-MaxPercentUnhealthyPartitionsPerService <Byte>]
   [-MaxPercentUnhealthyReplicasPerPartition <Byte>]
   [-EventsHealthStateFilter <Int64>]
   [-EventsFilter <HealthStateFilter>]
   [-PartitionsHealthStateFilter <Int64>]
   [-PartitionsFilter <HealthStateFilter>]
   [-ExcludeHealthStatistics]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-ServiceFabricServiceHealth ruft den Status eines Service Fabric-Diensts ab. Wenn Sie einen Dienst angeben, der im Integritätsspeicher nicht vorhanden ist, gibt dieses Cmdlet eine Ausnahme zurück.

Bevor Sie einen Vorgang auf einem Service Fabric-Cluster ausführen, stellen Sie mithilfe des Cmdlets Connect-ServiceFabricCluster eine Verbindung mit dem Cluster her.

Beispiele

Beispiel 1: Abfragen des Status eines Diensts

PS C:\> Get-ServiceFabricServiceHealth -ServiceName fabric:/myapp/persistenttodolist/svc1

Dieser Befehl ruft den Status des angegebenen Diensts ab.

Beispiel 2: Abrufen des Status eines Diensts mit benutzerdefinierter Integritätsrichtlinie und Rückgabefiltern

PS C:\> Get-ServiceFabricServiceHealth -ServiceName fabric:/myapp/persistenttodolist/svc1 -ConsiderWarningAsError $True -EventsFilter Error -PartitionsFilter 'Warning,Error'

Dieser Befehl fragt den Status des angegebenen Diensts ab. Es stellt Werte für die Integritätsrichtlinie bereit. Es verwendet Filter, um nur Fehlerereignisse und untergeordnete Elemente mit Statusstatus "Error" oder "Warning" zurückzugeben.

Beispiel 3: Abfragen des Status eines Diensts und Ausschließen der Integritätsstatistiken

PS C:\> Get-ServiceFabricServiceHealth -ServiceName fabric:/myapp/persistenttodolist/svc1 -ExcludeHealthStatistics

Dieser Befehl ruft den Status des angegebenen Diensts ab. Der zurückgegebene Dienststatus enthält nicht die Dienststatusstatistiken.

Parameter

-ConsiderWarningAsError

Gibt an, ob ein Warnungsstatusbericht während der Integritätsbewertung als Fehler behandelt werden soll.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EventsFilter

Gibt den Filter für die Auflistung von HealthEvent- basierend auf dem Integritätszustand an. Der Wert kann aus Membern oder bitweisen Vorgängen für Elemente von HealthStateFilterabgerufen werden. Es werden nur Ereignisse zurückgegeben, die dem Filter entsprechen. Alle Ereignisse werden verwendet, um den aggregierten Integritätszustand auszuwerten. Wenn nicht angegeben, werden alle Einträge zurückgegeben.

Typ:HealthStateFilter
Zulässige Werte:Default, None, Ok, Warning, Error, All
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EventsHealthStateFilter

Dieser Parameter ist veraltet. Geben Sie stattdessen den EventsFilter Parameter an.

Typ:Int64
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ExcludeHealthStatistics

Gibt an, ob die Integritätsstatistiken in das Abfrageergebnis einbezogen werden sollen. Wenn angegeben, werden die Integritätsstatistiken nicht als Teil des Abfrageergebnisses zurückgegeben. Andernfalls enthält das Abfrageergebnis die Dienststatusstatistiken, die Informationen dazu enthalten, wie viele Partitionen und Replikate dieses Diensts in "Ok", "Warnung" und "Fehler" enthalten.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MaxPercentUnhealthyPartitionsPerService

Gibt den maximalen tolerierten Prozentsatz der fehlerhaften Partitionen in einem Dienst an. Wenn mehr Partitionen mit einem Integritätsstatusfehler vorhanden sind als toleriert, ist der Integritätsstatus des Diensts ein Fehler.

Typ:Byte
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MaxPercentUnhealthyReplicasPerPartition

Gibt den maximal tolerierten Prozentsatz der fehlerhaften Partitionsreplikate an. Wenn mehr Replikate mit einem Integritätsstatusfehler vorhanden sind als toleriert, ist der Integritätszustand der Partition ein Fehler.

Typ:Byte
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PartitionsFilter

Gibt den Filter für PartitionHealthState untergeordneten Elemente basierend auf dem Integritätszustand an. Der Wert kann aus Membern oder bitweisen Vorgängen für Elemente von HealthStateFilterabgerufen werden. Nur untergeordnete Elemente, die dem Filter entsprechen, werden zurückgegeben. Alle untergeordneten Elemente werden verwendet, um den Aggregierten Integritätsstatus der Entität auszuwerten. Wenn nicht angegeben, werden alle Einträge zurückgegeben.

Typ:HealthStateFilter
Zulässige Werte:Default, None, Ok, Warning, Error, All
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PartitionsHealthStateFilter

Dieser Parameter ist veraltet. Geben Sie stattdessen den PartitionsFilter Parameter an.

Typ:Int64
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ServiceName

Gibt den URI eines Service Fabric-Diensts an.

Typ:Uri
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-TimeoutSec

Gibt den Timeoutzeitraum für den Vorgang in Sekunden an.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

System.Uri

Ausgaben

System.Object