Get-ServiceFabricApplicationHealth

Obtient l’intégrité d’une application Service Fabric.

Syntaxe

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>]

Description

L’applet de commande Get-ServiceFabricApplicationHealth get-ServiceFabricApplicationHealth obtient l’état d’intégrité d’une application Service Fabric. Service Fabric signale les états d’intégrité suivants :

  • D’ACCORD. L’entité répond aux instructions d’intégrité.
  • Erreur. L’entité ne répond pas aux instructions d’intégrité.
  • Avertissement. L’entité répond aux instructions d’intégrité, mais a rencontré un problème.

Si l’entité est introuvable dans le magasin d’intégrité, cette applet de commande retourne une erreur.

Avant d’effectuer une opération sur un cluster Service Fabric, établissez une connexion au cluster à l’aide de l’applet de commande Connect-ServiceFabricCluster.

Exemples

Exemple 1 : Obtenir l’intégrité d’une application

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

Cette commande interroge l’intégrité de l’application nommée.

Exemple 2 : Obtenir l’intégrité d’une application à l’aide d’une stratégie d’intégrité personnalisée et de filtres de retour

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

Cette commande interroge l’intégrité de l’application nommée. La commande spécifie des valeurs pour la stratégie d’intégrité et utilise des filtres pour renvoyer uniquement les événements d’erreur et les enfants avec des états d’intégrité d’erreur ou d’avertissement.

Exemple 3 : Obtenir l’intégrité d’une application et exclure les statistiques d’intégrité

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

Cette commande interroge l’intégrité de l’application nommée. L’intégrité de l’application retournée n’inclut pas les statistiques d’intégrité.

Paramètres

-ApplicationName

Spécifie l’URI (Uniform Resource Identifier) d’une application Service Fabric. L’applet de commande obtient des informations d’intégrité pour l’application qui a l’URI que vous spécifiez.

Type:Uri
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ConsiderWarningAsError

Indique si cette applet de commande considère un rapport d’intégrité d’avertissement comme une erreur lors de l’évaluation de l’intégrité.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DeployedApplicationsFilter

Spécifie le filtre pour DeployedApplicationHealthState enfants en fonction de l’état d’intégrité. La valeur est obtenue à partir de membres ou d’opérations au niveau du bit sur les membres de HealthStateFilter. Seuls les enfants qui correspondent au filtre sont retournés. Tous les enfants sont utilisés pour évaluer l’état d’intégrité agrégé de l’application. Si ce n’est pas spécifié, toutes les entrées sont retournées.

Type:HealthStateFilter
Valeurs acceptées:Default, None, Ok, Warning, Error, All
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DeployedApplicationsHealthStateFilter

Ce paramètre a été déconseillé. Spécifiez le paramètre DeployedApplicationsFilter à la place.

Type:Int64
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EventsFilter

Spécifie le filtre pour la collection d’objets HealthEvent signalés sur l’application en fonction de l’état d’intégrité. La valeur peut être obtenue à partir de membres ou d’opérations au niveau du bit sur les membres de HealthStateFilter. Seuls les événements qui correspondent au filtre sont retournés. Tous les événements sont utilisés pour évaluer l’état d’intégrité agrégé de l’application. Si ce n’est pas spécifié, toutes les entrées sont retournées.

Type:HealthStateFilter
Valeurs acceptées:Default, None, Ok, Warning, Error, All
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EventsHealthStateFilter

Ce paramètre a été déconseillé. Spécifiez à la place le paramètre EventsFilter .

Type:Int64
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ExcludeHealthStatistics

Indique si les statistiques d’intégrité doivent être incluses dans le résultat de la requête. Si elle est spécifiée, les statistiques d’intégrité ne sont pas retournées dans le cadre du résultat de la requête. Sinon, le résultat de la requête inclut les statistiques d’intégrité de l’application, qui contiennent des informations sur le nombre de services, de partitions et de réplicas de cette application dans les états Ok, Avertissement et Erreur.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MaxPercentUnhealthyDeployedApplications

Spécifie le pourcentage maximal toléré d’instances d’application non saines déployées sur les nœuds du cluster. S’il existe plus d’applications déployées avec une erreur d’état d’intégrité que tolérée, l’état d’intégrité de l’application est une erreur. Si vous ne spécifiez pas ce paramètre, l’évaluation d’intégrité utilise la valeur fournie dans le manifeste de l’application.

Type:Byte
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MaxPercentUnhealthyPartitionsPerService

Spécifie le pourcentage maximal toléré de partitions de service non saines. S’il existe plus de partitions avec une erreur d’état d’intégrité que tolérée, l’état d’intégrité des services est une erreur. Si vous ne spécifiez pas ce paramètre, l’évaluation d’intégrité utilise la valeur fournie dans le manifeste de l’application.

Type:Byte
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MaxPercentUnhealthyReplicasPerPartition

Spécifie le pourcentage maximal toléré de réplicas de partition non sains. S’il existe plus de réplicas avec une erreur d’état d’intégrité que toléré, l’état d’intégrité de la partition est une erreur. Si vous ne spécifiez pas ce paramètre, l’évaluation d’intégrité utilise la valeur fournie dans le manifeste de l’application.

Type:Byte
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MaxPercentUnhealthyServices

Spécifie le pourcentage maximal toléré de services non sains dans une application. S’il existe plus de services avec une erreur d’état d’intégrité que toléré, l’état d’intégrité de l’application est une erreur. Si vous ne spécifiez pas ce paramètre, l’évaluation d’intégrité utilise la valeur fournie dans le manifeste de l’application.

Type:Byte
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ServicesFilter

Spécifie le filtre pour ServiceHealthState enfants en fonction de l’état d’intégrité. La valeur peut être obtenue à partir de membres ou d’opérations au niveau du bit sur les membres de HealthStateFilter. Seuls les enfants qui correspondent au filtre sont retournés. Tous les enfants sont utilisés pour évaluer l’état d’intégrité agrégé de l’application. Si ce n’est pas spécifié, toutes les entrées sont retournées.

Type:HealthStateFilter
Valeurs acceptées:Default, None, Ok, Warning, Error, All
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ServicesHealthStateFilter

Ce paramètre a été déconseillé. Spécifiez à la place le paramètre ServicesFilter .

Type:Int64
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-TimeoutSec

Spécifie le délai d’expiration, en secondes, pour l’opération.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

System.Uri

Sorties

System.Object