Get-ServiceFabricApplicationHealth

Ruft die Integrität 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:

  • OK. 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 wurden einige Probleme aufgetreten.

Wenn die Entität im Integritätsspeicher nicht gefunden wird, gibt dieses Cmdlet einen Fehler zurück.

Bevor Sie einen Vorgang in 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 ruft die Integrität der benannten Anwendung ab.

Beispiel 2: Abrufen der Integrität einer Anwendung mithilfe von benutzerdefinierten Integritätsrichtlinien und Rückgabefiltern

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

Dieser Befehl ruft die Integrität der benannten Anwendung ab. Der Befehl gibt Werte für Integritätsrichtlinie an und verwendet Filter, um nur Fehlerereignisse und untergeordnete Elemente mit Fehler- oder Warnungsstatus zurückzugeben.

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

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

Dieser Befehl ruft die Integrität der benannten Anwendung ab. Die zurückgegebene Anwendungsintegrität enthält keine Integritätsstatistiken.

Parameter

-ApplicationName

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

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

-ConsiderWarningAsError

Gibt an, ob dieses Cmdlet einen Warnungsstatusbericht als Fehler bei der Integritätsbewertung betrachtet.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeployedApplicationsFilter

Gibt den Filter für BereitgestelltApplicationHealthState-Untergeordnete basierend auf dem Integritätszustand an. Der Wert wird aus Mitgliedern oder Bitzeigervorgängen für Elemente von HealthStateFilter abgerufen. Nur untergeordnete Elemente, die dem Filter entsprechen, werden zurückgegeben. Alle untergeordneten Elemente werden verwendet, um den Aggregatstatus der Anwendung zu bewerten. Ist kein Filter angegeben, werden alle Einträge zurückgegeben.

Type:HealthStateFilter
Accepted values:Default, None, Ok, Warning, Error, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeployedApplicationsHealthStateFilter

Dieser Parameter wurde veraltet. Geben Sie stattdessen den Parameter "DeployedApplicationsFilter " an.

Type:Int64
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EventsFilter

Gibt den Filter für die Auflistung von HealthEvent-Objekten an, die auf der Grundlage des Integritätszustands der Anwendung gemeldet wurden. Der Wert kann von Mitgliedern oder Bitzeigervorgängen auf Mitgliedern von HealthStateFilter abgerufen werden. Es werden nur Ereignisse zurückgegeben, die dem Filter entsprechen. Alle Ereignisse werden verwendet, um den Status der aggregierten Integrität der Anwendung zu bewerten. Ist kein Filter angegeben, werden alle Einträge zurückgegeben.

Type:HealthStateFilter
Accepted values:Default, None, Ok, Warning, Error, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EventsHealthStateFilter

Dieser Parameter wurde veraltet. Geben Sie stattdessen den Parameter "EventsFilter " an.

Type:Int64
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcludeHealthStatistics

Gibt an, ob die Integritätsstatistiken in das Abfrageergebnis einbezogen werden sollen. Wenn angegeben, werden die Integritätsstatistiken nicht als Teil des Abfrageergebniss zurückgegeben. Andernfalls enthält das Abfrageergebnis die Anwendungsintegritätsstatistiken, die Informationen über die Anzahl von Diensten, Partitionen und Replikaten dieser Anwendung in "Ok", "Warnung" und "Fehler" enthalten.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxPercentUnhealthyDeployedApplications

Gibt den maximal zulässigen Prozentsatz von nicht ungesunden 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 Fehler. Wenn Sie diesen Parameter nicht angeben, verwendet die Integritätsbewertung den wert, der im Anwendungsmanifest bereitgestellt wird.

Type:Byte
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxPercentUnhealthyPartitionsPerService

Gibt den maximal zulässigen Prozentsatz von unintegritätslosen Dienstpartitionen an. Wenn mehr Partitionen mit Integritätsstatusfehler vorhanden sind als toleriert, ist der Integritätszustand der Dienste Fehler. Wenn Sie diesen Parameter nicht angeben, verwendet die Integritätsbewertung den wert, der im Anwendungsmanifest bereitgestellt wird.

Type:Byte
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxPercentUnhealthyReplicasPerPartition

Gibt den maximalen tolerierten Prozentsatz von ungesunden Partitionsreplikaten an. Wenn mehr Replikate mit Integritätsstatusfehler vorhanden sind als toleriert, ist der Integritätszustand der Partition Fehler. Wenn Sie diesen Parameter nicht angeben, verwendet die Integritätsbewertung den wert, der im Anwendungsmanifest bereitgestellt wird.

Type:Byte
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxPercentUnhealthyServices

Gibt den maximal zulässigen Prozentsatz von ungesunden Diensten in einer Anwendung an. Wenn mehr Dienste mit Integritätsstatusfehler vorhanden sind als toleriert, ist der Integritätszustand der Anwendung fehler. Wenn Sie diesen Parameter nicht angeben, verwendet die Integritätsbewertung den wert, der im Anwendungsmanifest bereitgestellt wird.

Type:Byte
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServicesFilter

Gibt den Filter für ServiceHealthState-Untergeordnete basierend auf dem Integritätszustand an. Der Wert kann von Mitgliedern oder Bitzeigervorgängen auf Mitgliedern von HealthStateFilter abgerufen werden. Nur untergeordnete Elemente, die dem Filter entsprechen, werden zurückgegeben. Alle untergeordneten Elemente werden verwendet, um den Status der anwendung aggregierten Integrität zu bewerten. Ist kein Filter angegeben, werden alle Einträge zurückgegeben.

Type:HealthStateFilter
Accepted values:Default, None, Ok, Warning, Error, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServicesHealthStateFilter

Dieser Parameter wurde veraltet. Geben Sie stattdessen den Parameter "ServicesFilter " an.

Type:Int64
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TimeoutSec

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

System.Uri

Ausgaben

System.Object