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 obtient l’état d’intégrité d’une application Service Fabric. Service Fabric signale les états d’intégrité suivants :
- OK. 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é n’est pas trouvée 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/persistenttodolistCette commande interroge l’intégrité de l’application nommée.
Exemple 2 : Obtenir l’intégrité d’une application à l’aide de la stratégie d’intégrité personnalisée et des 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 -ExcludeHealthStatisticsCette 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 les enfants DeployedApplicationHealthState 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 cet argument 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 plutôt le paramètre DeployedApplicationsFilter .
| 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 renvoyés. Tous les événements sont utilisés pour évaluer l’état d’intégrité agrégé de l’application. Si cet argument 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 plutôt 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. Dans le cas contraire, 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 les enfants ServiceHealthState 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 cet argument 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 plutôt 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 la période 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