Send-ServiceFabricDeployedServicePackageHealthReport
Envoie un rapport d’intégrité sur un package de service déployé Service Fabric.
Syntaxe
Send-ServiceFabricDeployedServicePackageHealthReport
[-ApplicationName] <Uri>
[-ServiceManifestName] <String>
[-NodeName] <String>
[[-ServicePackageActivationId] <String>]
-HealthState <HealthState>
-SourceId <String>
-HealthProperty <String>
[-Description <String>]
[-TimeToLiveSec <Int32>]
[-RemoveWhenExpired]
[-SequenceNumber <Int64>]
[-Immediate]
[-TimeoutSec <Int32>]
[<CommonParameters>] Description
L’applet de commande Send-ServiceFabricDeployedServicePackageHealthReport envoie un rapport d’intégrité sur un package de service déployé Service Fabric.
Le package de service déployé doit déjà exister dans le magasin d’intégrité. Pour vérifier si le service existe, utilisez l’applet de commande Get-ServiceFabricDeployedServicePackageHealth . Spécifiez le nom de l’application, le nom du package de service et le nom du nœud. Vous pouvez également utiliser l’applet de commande Get-ServiceFabricDeployedApplicationHealth . Spécifiez le nom de l’application et le nom du nœud, puis vérifiez la section états d’intégrité du package de service déployée pour rechercher le package de service.
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. 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 voir si le rapport a été appliqué dans le magasin d’intégrité, utilisez l’applet de commande Get-ServiceFabricDeployedServicePackageHealth 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 avec durée de vie infinie
PS C:\> Send-ServiceFabricDeployedServicePackageHealthReport -ApplicationName fabric:/MyApplication -NodeName "Node01" -ServiceManifestName "MyServiceManifest" -HealthProperty "Memory" -HealthState Error -SourceId "MyWatchdog"Cette commande envoie un rapport d’intégrité sur un package de service déployé pour l’application nommée fabric:/MyApplication sur le nœud nommé Node01 pour le manifeste de service nommé MyServiceManifest. Le rapport d’intégrité contient des informations sur la propriété d’intégrité Memory in an Error health state from the source MyWatchdog, with infinite TTL. La description n’est pas donnée et le numéro de séquence est défini automatiquement.
Exemple 2 : Avertissement de rapport valide pour la durée de vie spécifiée et le supprimer lorsqu’il expire
PS C:\> Send-ServiceFabricDeployedServicePackageHealthReport -ApplicationName fabric:/MyApplication -ServiceManifestName MyServiceManifest -NodeName "Node01" -HealthProperty "CustomSetup" -HealthState Warning -SourceId MyWatchdog -RemoveWhenExpired -Description "The setup has completed with some warnings." -TimeToLiveSec 10Cette commande envoie un rapport d’intégrité sur un package de service déployé pour l’application nommée fabric:/MyApplication pour le manifeste de service nommé MyServiceManifest sur le nœud nommé Node01. Le rapport d’intégrité contient des informations sur la propriété d’intégrité CustomSetup dans un état d’intégrité Warning de la source MyWatchdog, avec une durée de vie de 10 secondes. Une fois le rapport arrivé à expiration, il est supprimé du magasin d’intégrité et n’aura plus d’impact sur l’évaluation de l’intégrité. Cette commande fournit également une description de l’avertissement.
Paramètres
-ApplicationName
Spécifie l’URI (Uniform Resource Identifier) d’une application Service Fabric. L’applet de commande envoie un rapport 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 |
-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. 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 |
| 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 |
-NodeName
Spécifie le nom d’un nœud Service Fabric. L’applet de commande envoie un rapport d’intégrité pour un package de service déployé sur le nœud que vous spécifiez.
| Type: | String |
| Position: | 2 |
| 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 |
-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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-ServiceManifestName
Spécifie le nom d’un manifeste de service Service Fabric. Avec ApplicationName et NodeName, cette valeur identifie de manière unique l’entité d’intégrité du package de service déployée.
| Type: | String |
| Position: | 1 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-ServicePackageActivationId
ID d’activation du ServicePackage déployé. Cette opération peut être obtenue à l’aide de la requête Get-ServiceFabricDeployedServicePackage.
Si ServicePackageActivationMode spécifié au moment de la création du service (à l’aide New-ServiceFabricService) est SharedProcess (ou s’il n’est pas spécifié, auquel cas il est défini par défaut sur SharedProcess), la valeur de ServicePackageActivationId est toujours une chaîne vide et n’a pas besoin d’être spécifiée. Pour en savoir plus sur l’ID d’activation du package de service, consultez [Modèle d’hébergement Service Fabric][1].
| Type: | String |
| Position: | 3 |
| 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.Uri
System.String
System.Fabric.Health.HealthState
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