Partager via

Utilisation de modèles de chaîne standard

  • Article

Plusieurs consommateurs, tels que le consommateur d’événements de scripts actifs ou le consommateur d’événements de ligne de commande, ont des propriétés de chaîne avec le qualificateur de modèle. Ces propriétés utilisent des modèles de chaîne standard pour construire une chaîne configurée en partie par l’instance du consommateur et en partie par un événement. La structure d’un modèle de chaîne standard est similaire à la spécification de variables d’environnement Microsoft Windows.

La liste suivante présente quelques exemples de langage de modèle :

  • La chaîne « Some text here » produit toujours la chaîne « Some text here ».
  • « %CPUUtilization% » produit toujours la valeur de la propriété CPUUtilization de l’événement remis. Si la propriété n’est pas une chaîne, elle est convertie en chaîne ; par exemple, « 90 » ou « TRUE ».
  • « L’utilisation de l’UC de ce processeur est de %CPUUtilization% à ce stade » incorpore la valeur de la propriété CPUUtilization de l’événement dans la chaîne, ce qui produit quelque chose comme « L’utilisation de l’UC de ce processeur est de 90 pour le moment ».
  • « %TargetInstance.CPUUtilization% » récupère la valeur de la propriété CPUUtilization dans l’instance incorporée de la propriété TargetInstance.
  • « %% » produit un signe % unique.
  • Si la propriété récupérée est un tableau, l’ensemble du tableau est produit au format suivant : « (1,5,10,1024) ». S’il n’y a qu’un seul élément dans le tableau, les parenthèses sont omises. S’il n’y a aucun élément dans le tableau, « () » est généré.
  • Si une propriété est un objet incorporé, la représentation MOF de l’objet est produite (similaire à la méthode IWbemClassObject::GetObjectText).
  • Si une propriété d’un tableau incorporé d’objets est demandée, elle est traitée comme une propriété avec une valeur de tableau. Par exemple : %MyEvents.TargetInstance.DriverLetter% peut produire '("C:","D:")' si MyEvents est un tableau d’événements de modifications d’instances incorporées.

Littéraux de chaîne

Tout ce qui se trouve à l’intérieur d’une paire de guillemets est considéré comme un littéral de chaîne et ne sera pas remplacé.

L’exemple suivant montre la chaîne que le compilateur voit pour « L’utilisation du processeur est de %CPUUtilization% ».

CPU utilization is %CPUUtilization%

Cette chaîne génère la sortie suivante.

CPU utilization is 90

En revanche, la chaîne « L’utilisation du processeur est de \"%CPUUtilization%\ » » est vue par le compilateur comme suit.

CPU utilization is "%CPUUtilization%"

Cette chaîne produit la sortie suivante, sans substitution de variable.

CPU utilization is "%CPUUtilization%"

Surveillance et réponse aux événements avec les consommateurs standard