Send-ServiceFabricReplicaHealthReport
Envoie un rapport d’intégrité sur un réplica Service Fabric.
Syntaxe
Send-ServiceFabricReplicaHealthReport
[-PartitionId] <Guid>
-ReplicaId <Int64>
-HealthState <HealthState>
-SourceId <String>
-HealthProperty <String>
[-Description <String>]
[-TimeToLiveSec <Int32>]
[-RemoveWhenExpired]
[-SequenceNumber <Int64>]
[-Immediate]
[-TimeoutSec <Int32>]
[<CommonParameters>] Send-ServiceFabricReplicaHealthReport
[-PartitionId] <Guid>
-InstanceId <Int64>
-HealthState <HealthState>
-SourceId <String>
-HealthProperty <String>
[-Description <String>]
[-TimeToLiveSec <Int32>]
[-RemoveWhenExpired]
[-SequenceNumber <Int64>]
[-Immediate]
[-TimeoutSec <Int32>]
[<CommonParameters>] Description
L’applet de commande Send-ServiceFabricReplicaHealthReport envoie un rapport d’intégrité sur une instance de service sans état Service Fabric ou un réplica de service avec état.
L’instance de service sans état ou le réplica de service avec état doit déjà exister dans le magasin d’intégrité. Pour vérifier s’il existe, utilisez l’applet de commande Get-ServiceFabricReplicaHealth et spécifiez les paramètres PartitionId et ReplicaOrInstanceId . Vous pouvez également utiliser l’applet de commande Get-ServiceFabricPartitionHealth avec le paramètre PartitionId , puis vérifier la section ReplicaHealthStates pour rechercher le réplica.
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 au cluster doit être conservée active pendant ce temps.
L’applet de commande peut retourner la réussite, mais le rapport est envoyé de façon asynchrone, de sorte que son traitement peut échouer. Pour voir si le rapport a été appliqué dans le magasin d’intégrité, utilisez l’applet de commande Get-ServiceFabricReplicaHealth et vérifiez que le rapport apparaît dans la section événements d’intégrité.
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 : Rapport d’intégrité des erreurs sur un réplica de service avec état avec durée de vie infinie
PS C:\> Send-ServiceFabricReplicaHealthReport -PartitionId 869dd2e9-fdda-42a5-ad96-4b71c795dfd3 -ReplicaId 130464806670632402 -SourceId "MyWatchdog" -HealthProperty "DiskUsage" -HealthState Error -Description "Disk is full"Cette commande envoie un rapport d’intégrité pour la partition spécifiée pour le réplica de service avec état spécifié à partir de la source MyWatchDog. Le rapport d’intégrité contient des informations sur la propriété d’intégrité DiskUsage dans un état d’intégrité d’erreur, avec une durée de vie infinie. Cette commande fournit également une description de l’erreur.
Exemple 2 : Rapport d’intégrité d’avertissement sur une instance de service sans état valide pour la durée de vie spécifiée et la supprimer lorsqu’elle expire
PS C:\> Send-ServiceFabricReplicaHealthReport -PartitionId 1a151ac7-9c25-4528-81fc-4c6bb9909394 -InstanceId 130464806670632403 -SourceId "MyWatchdog" -HealthProperty "Resources" -HealthState Warning -Description "Access to resources is temporarily disabled" -TimeToLiveSec 10 -RemoveWhenExpiredCette commande envoie un rapport d’intégrité pour l’instance de service sans état spécifiée à partir de la source MyWatchDog. Le rapport d’intégrité contient des informations sur les ressources de propriété d’intégrité dans un état d’intégrité Avertissement à partir de la source MyWatchdog, avec une durée de vie de 10 secondes. Rapport marqué pour suppression à l’expiration.
Paramètres
-Description
Spécifie des informations lisibles par l’homme 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 4 096 caractères, donc moins de 4 096 caractères de la chaîne d’origine sont conservés.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-HealthProperty
Spécifie la propriété du rapport. Avec le paramètre SourceId , cette propriété identifie de façon unique le rapport.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-HealthState
Spécifie un objet HealthState qui représente l’état d’intégrité signalé.
| Type: | HealthState |
| Valeurs acceptées: | Invalid, Ok, Warning, Error, Unknown |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | 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. S’il 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-InstanceId
Spécifie l’ID d’instance de service sans état. L’ID d’instance est valide uniquement pour les services sans état. Un rapport pour un réplica avec état qui utilise InstanceId au lieu de ReplicaId est accepté par le client d’intégrité, mais il est rejeté par le magasin d’intégrité.
| Type: | Int64 |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-PartitionId
Spécifie l’ID d’une partition Service Fabric.
| Type: | Guid |
| Position: | 0 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | 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 qui sont supprimés lorsqu’ils ont expiré peuvent être utilisés pour les conditions qui sont valides uniquement pendant une période donnée ou pour effacer les rapports du Magasin d’intégrité.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-ReplicaId
Spécifie l’ID de réplica de service avec état. L’ID de réplica est valide uniquement pour les services avec état. Un rapport pour une instance sans état qui utilise ReplicaId au lieu d’InstaceId est accepté par le client d’intégrité, mais rejeté par le magasin d’intégrité.
| Type: | Int64 |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 la même entité pour le même SourceId et HealthProperty, ou le rapport est rejeté en raison de l’obsolescence.
| Type: | Int64 |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-SourceId
Spécifie l’identificateur de la source qui a déclenché le rapport.
| Type: | String |
| Position: | Named |
| 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 |
-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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
Entrées
System.Guid
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