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