Get-ServiceFabricServiceHealth

  • Référence
Module:
ServiceFabric

Obtient l’intégrité d’un service Service Fabric.

Syntaxe

Get-ServiceFabricServiceHealth
   [-ServiceName] <Uri>
   [-ConsiderWarningAsError <Boolean>]
   [-MaxPercentUnhealthyPartitionsPerService <Byte>]
   [-MaxPercentUnhealthyReplicasPerPartition <Byte>]
   [-EventsHealthStateFilter <Int64>]
   [-EventsFilter <HealthStateFilter>]
   [-PartitionsHealthStateFilter <Int64>]
   [-PartitionsFilter <HealthStateFilter>]
   [-ExcludeHealthStatistics]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

Description

L’applet de commande Get-ServiceFabricServiceHealth obtient l’intégrité d’un service Service Fabric. Si vous spécifiez un service qui n’existe pas dans le magasin d’intégrité, cette applet de commande retourne une exception.

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 : Interroger l’intégrité d’un service

PS C:\> Get-ServiceFabricServiceHealth -ServiceName fabric:/myapp/persistenttodolist/svc1

Cette commande obtient l’intégrité du service spécifié.

Exemple 2 : Obtenir l’intégrité d’un service à l’aide de la stratégie d’intégrité personnalisée et des filtres de retour

PS C:\> Get-ServiceFabricServiceHealth -ServiceName fabric:/myapp/persistenttodolist/svc1 -ConsiderWarningAsError $True -EventsFilter Error -PartitionsFilter 'Warning,Error'

Cette commande interroge l’intégrité du service spécifié. Il fournit des valeurs pour la stratégie d’intégrité. Il utilise des filtres pour retourner uniquement les événements d’erreur et les enfants avec des états d’intégrité d’erreur ou d’avertissement.

Exemple 3 : Interroger l’intégrité d’un service et exclure les statistiques d’intégrité

PS C:\> Get-ServiceFabricServiceHealth -ServiceName fabric:/myapp/persistenttodolist/svc1 -ExcludeHealthStatistics

Cette commande obtient l’intégrité du service spécifié. L’intégrité du service retournée n’inclut pas les statistiques d’intégrité du service.

Paramètres

-ConsiderWarningAsError

Indique s’il faut traiter un rapport d’intégrité d’avertissement comme une erreur pendant 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

-EventsFilter

Spécifie le filtre de la collection de HealthEvent signalé sur l’entité 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é. 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é du service, qui contiennent des informations sur le nombre de partitions et de réplicas de ce service 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

-MaxPercentUnhealthyPartitionsPerService

Spécifie le pourcentage maximal toléré de partitions non saines dans un service. S’il existe plus de partitions avec une erreur d’état d’intégrité que tolérée, l’état d’intégrité du service est une erreur.

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.

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

-PartitionsFilter

Spécifie le filtre pour PartitionHealthState 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’entité. 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

-PartitionsHealthStateFilter

Ce paramètre a été déconseillé. Spécifiez le paramètre partitionsFilter à 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

-ServiceName

Spécifie l’URI d’un service Service Fabric.

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

-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