Freigeben über


Get-ServiceFabricApplicationHealth

Ruft den Status einer Service Fabric-Anwendung ab.

Syntax

Get-ServiceFabricApplicationHealth
   [-ApplicationName] <Uri>
   [-ConsiderWarningAsError <Boolean>]
   [-MaxPercentUnhealthyDeployedApplications <Byte>]
   [-MaxPercentUnhealthyServices <Byte>]
   [-MaxPercentUnhealthyPartitionsPerService <Byte>]
   [-MaxPercentUnhealthyReplicasPerPartition <Byte>]
   [-EventsHealthStateFilter <Int64>]
   [-EventsFilter <HealthStateFilter>]
   [-ServicesHealthStateFilter <Int64>]
   [-ServicesFilter <HealthStateFilter>]
   [-DeployedApplicationsHealthStateFilter <Int64>]
   [-DeployedApplicationsFilter <HealthStateFilter>]
   [-ExcludeHealthStatistics]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-ServiceFabricApplicationHealth ruft den Integritätsstatus einer Service Fabric-Anwendung ab. Service Fabric meldet die folgenden Integritätszustände:

  • OKAY. Die Entität erfüllt Integritätsrichtlinien.
  • Fehler. Die Entität erfüllt keine Integritätsrichtlinien.
  • Warnung. Die Entität erfüllt Integritätsrichtlinien, aber es gab ein Problem.

Wenn die Entität im Integritätsspeicher nicht gefunden wird, gibt dieses Cmdlet einen Fehler 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: Abrufen der Integrität einer Anwendung

PS C:\> Get-ServiceFabricApplicationHealth -ApplicationName fabric:/myapp/persistenttodolist

Dieser Befehl fragt den Status der benannten Anwendung ab.

Beispiel 2: Abrufen der Integrität einer Anwendung mit benutzerdefinierter Integritätsrichtlinie und Rückgabefiltern

PS C:\> Get-ServiceFabricApplicationHealth -ApplicationName fabric:/myapp/persistenttodolist -ConsiderWarningAsError $True -EventsFilter Error -ServicesFilter 'Error,Warning' -DeployedApplicationsFilter 'Warning,Error'

Dieser Befehl fragt den Status der benannten Anwendung ab. Der Befehl gibt Werte für die Integritätsrichtlinie an und verwendet Filter, um nur Fehlerereignisse und untergeordnete Elemente mit Status "Error" oder "Warning" zurückzugeben.

Beispiel 3: Abrufen der Integrität einer Anwendung und Ausschließen der Integritätsstatistik

PS C:\> Get-ServiceFabricApplicationHealth -ApplicationName fabric:/myapp/persistenttodolist -ExcludeHealthStatistics

Dieser Befehl fragt den Status der benannten Anwendung ab. Die zurückgegebene Anwendungsintegrität enthält nicht die Integritätsstatistiken.

Parameter

-ApplicationName

Gibt den URI (Uniform Resource Identifier) einer Service Fabric-Anwendung an. Das Cmdlet ruft Integritätsinformationen für die Anwendung ab, die den von Ihnen angegebenen URI enthält.

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

-ConsiderWarningAsError

Gibt an, ob dieses Cmdlet einen Warnungsstatusbericht während der Integritätsauswertung als Fehler betrachtet.

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

-DeployedApplicationsFilter

Gibt den Filter für DeployedApplicationHealthState untergeordneten Elemente basierend auf dem Integritätszustand an. Der Wert wird aus Membern oder bitweisen Vorgängen für Elemente von HealthStateFilterabgerufen. Nur untergeordnete Elemente, die dem Filter entsprechen, werden zurückgegeben. Alle untergeordneten Elemente werden verwendet, um den aggregierten Integritätszustand der Anwendung 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

-DeployedApplicationsHealthStateFilter

Dieser Parameter ist veraltet. Geben Sie stattdessen den parameter DeployedApplicationsFilter an.

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

-EventsFilter

Gibt den Filter für die Auflistung von HealthEvent- Objekten an, die auf der Anwendung basierend auf dem Integritätszustand gemeldet wurden. 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 der Anwendung 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 Anwendungsintegritätsstatistiken, die Informationen dazu enthalten, wie viele Dienste, Partitionen und Replikate dieser Anwendung in den Status "Ok", "Warnung" und "Fehler" enthalten.

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

-MaxPercentUnhealthyDeployedApplications

Gibt den maximalen tolerierten Prozentsatz der fehlerhaften Anwendungsinstanzen an, die auf den Knoten im Cluster bereitgestellt werden. Wenn mehr bereitgestellte Anwendungen mit Integritätsstatusfehler vorhanden sind als toleriert, ist der Integritätszustand der Anwendung ein Fehler. Wenn Sie diesen Parameter nicht angeben, verwendet die Integritätsauswertung den im Anwendungsmanifest bereitgestellten Wert.

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

-MaxPercentUnhealthyPartitionsPerService

Gibt den maximalen tolerierten Prozentsatz der fehlerhaften Dienstpartitionen an. Wenn mehr Partitionen mit Integritätsstatusfehler vorhanden sind als toleriert, ist der Integritätsstatus der Dienste ein Fehler. Wenn Sie diesen Parameter nicht angeben, verwendet die Integritätsauswertung den im Anwendungsmanifest bereitgestellten Wert.

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 Integritätsstatusfehler vorhanden sind als toleriert, ist der Integritätszustand der Partition ein Fehler. Wenn Sie diesen Parameter nicht angeben, verwendet die Integritätsauswertung den im Anwendungsmanifest bereitgestellten Wert.

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

-MaxPercentUnhealthyServices

Gibt den maximalen tolerierten Prozentsatz der fehlerhaften Dienste in einer Anwendung an. Wenn mehr Dienste mit Integritätsstatusfehler vorhanden sind als toleriert, ist der Integritätszustand der Anwendung ein Fehler. Wenn Sie diesen Parameter nicht angeben, verwendet die Integritätsauswertung den im Anwendungsmanifest bereitgestellten Wert.

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

-ServicesFilter

Gibt den Filter für ServiceHealthState- 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ätszustand der Anwendung 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

-ServicesHealthStateFilter

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

Typ:Int64
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
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