Send-ServiceFabricClusterHealthReport

Référence

Module:: ServiceFabric

Envoie un rapport d’intégrité sur un cluster Service Fabric.

Syntax

Send-ServiceFabricClusterHealthReport
    -HealthState <HealthState>
    -SourceId <String>
    -HealthProperty <String>
    [-Description <String>]
    [-TimeToLiveSec <Int32>]
    [-RemoveWhenExpired]
    [-SequenceNumber <Int64>]
    [-Immediate]
    [-TimeoutSec <Int32>]
    [<CommonParameters>]

Description

L’applet de commande Send-ServiceFabricClusterHealthReport envoie un rapport d’intégrité sur un cluster Service Fabric.

L’applet de commande envoie le rapport après un intervalle spécifié par le paramètre HealthReportSendIntervalInSec de l’applet de commande Connect-ServiceFabricCluster . La connexion de cluster doit être conservée en vie pendant cette période. La commande est évaluée sur le client sans référence à l’exécution sur le magasin d’intégrité. Le rapport peut ne pas être appliqué dans le magasin d’intégrité, même si la commande retourne la réussite. Par exemple, le magasin d’intégrité peut rejeter le rapport en raison d’un paramètre non valide, comme un numéro de séquence obsolète.

Pour savoir si le rapport a été appliqué dans le magasin d’intégrité, utilisez l’applet de commande Get-ServiceFabricClusterHealth et vérifiez que le rapport apparaît dans la section HealthEvents.

Pour gérer les clusters Service Fabric, démarrez Windows PowerShell à l’aide de l’option Exécuter en tant qu’administrateur. 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 , puis de l’applet de commande Get-ServiceFabricClusterConnection .

Exemples

Exemple 1 : Rapport d’intégrité des erreurs de rapport avec durée de vie TTL infinie

PS C:\> Send-ServiceFabricClusterHealthReport -SourceId "MyWatchdog" -HealthProperty "Availability" -HealthState Error

Cette commande envoie un rapport d’intégrité sur le cluster à partir de la source MyWatchdog. Le rapport d’intégrité contient des informations sur la disponibilité de la propriété d’intégrité dans un état d’intégrité d’erreur, avec une durée de vie infinie.

Exemple 2 : Avertissement de rapport valide pour la durée de vie TTL spécifiée

PS C:\> Send-ServiceFabricClusterHealthReport -SourceId "MyWatchdog" -HealthProperty "EnoughNodes" -HealthState Warning -TimeToLiveSec 10 -RemoveWhenExpired -SequenceNumber 1344

Cette commande envoie un rapport d’intégrité sur le cluster à partir de la source MyWatchDog. Le rapport d’intégrité contient des informations sur la propriété d’intégrité EnoughNodes dans un état d’intégrité d’avertissement. Le rapport reste dans le magasin d’intégrité pendant 10 secondes, après lequel il est automatiquement supprimé. La commande spécifie le paramètre SequenceNumber . Le numéro de séquence doit être supérieur à tous les numéros de séquence précédemment signalés pour le même SourceId et propriété, ou le rapport est rejeté en raison de l’obsolescence.

Paramètres

-Description

Spécifie des informations lisibles sur la condition qui a déclenché le rapport. Les paramètres SourceId, HealthProperty et HealthState décrivent entièrement le rapport.

La longueur de chaîne maximale de la description est de 4 096 caractères. Si la chaîne fournie est plus longue, elle est tronquée automatiquement. Lorsqu’elle est tronquée, la description se termine par un marqueur « [Tronqué] » pour indiquer aux utilisateurs que la troncation s’est produite. La taille totale de la chaîne est de 4096 caractères, donc moins de 4096 caractères de la chaîne d’origine sont conservés.

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

-HealthProperty

Spécifie la propriété du rapport. Avec le paramètre SourceId , cette propriété identifie de manière unique le rapport. Le rapport remplace tous les rapports précédents avec les mêmes valeurs pour les paramètres SourceId et HealthProperty sur la même entité.

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

-HealthState

Spécifie un objet HealthState qui représente l’état d’intégrité signalé.

Type:	HealthState
Accepted values:	Invalid, Ok, Warning, Error, Unknown
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Immediate

Spécifie si le rapport doit être envoyé immédiatement au magasin d’intégrité. Cela est utile pour les rapports critiques qui doivent être envoyés dès que possible. Si ce n’est pas spécifié, le rapport est envoyé en fonction des paramètres du client d’intégrité. C’est pourquoi il est traité par lot selon la configuration HealthReportSendInterval. Il s’agit du paramètre recommandé, car il permet au client d’intégrité d’optimiser les messages de rapport d’intégrité envoyés au magasin d’intégrité, ainsi que le traitement des rapports d’intégrité. Par défaut, le client Powershell Fabric définit HealthReportSentInterval sur 0, de sorte que les rapports sont envoyés immédiatement.

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

-RemoveWhenExpired

Indique que le rapport est supprimé du magasin d’intégrité lorsqu’il expire. Si vous ne spécifiez pas ce paramètre, l’entité est considérée dans l’état d’erreur lorsque la durée de vie du rapport expire. Les rapports supprimés lorsqu’ils ont expiré peuvent être utilisés pour les conditions qui ne sont valides que pendant une période ou pour effacer les rapports du Magasin d’intégrité.

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

-SequenceNumber

Spécifie le numéro de séquence associé au rapport d’intégrité. Si vous ne spécifiez pas de valeur pour ce paramètre, le numéro de séquence est défini automatiquement. Si vous spécifiez un numéro de séquence, cette valeur doit être supérieure à n’importe quel numéro de séquence précédent défini sur le même SourceId et HealthProperty, ou le rapport est rejeté en raison de l’obsolescence.

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

-SourceId

Spécifie l’identificateur de la source qui a déclenché le rapport.

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

-TimeoutSec

Spécifie la période d’expiration, en secondes, pour l’opération.

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

-TimeToLiveSec

Spécifie la durée de vie (TTL) du rapport en secondes. Lorsque la durée de vie expire, le rapport est supprimé du magasin d’intégrité si le paramètre RemoveWhenExpired est spécifié. Sinon, l’entité est évaluée à l’erreur en raison du rapport expiré. La valeur par défaut est Infinite.

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

Entrées

System.Fabric.Health.HealthState

System.String

System.Nullable`1[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

System.Management.Automation.SwitchParameter

System.Nullable`1[[System.Int64, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Sorties

System.Object