Freigeben über


Verwenden von Standard-Zeichenfolgenvorlagen

Mehrere Consumer, z. B. der Active Script Event Consumer oder der Command Line Event Consumer, verfügen über Zeichenfolgeneigenschaften mit dem Vorlagenqualifizierer. Diese Eigenschaften verwenden Standard-Zeichenfolgenvorlagen, um eine Zeichenfolge zu erstellen, die teilweise von der Consumerinstanz und teilweise durch ein Ereignis konfiguriert wird. Die Struktur einer Standard-Zeichenfolgenvorlage ähnelt der Spezifikation der Microsoft Windows-Umgebungsvariablen.

Die folgende Liste enthält einige Beispiele für die Vorlagensprache:

  • Die Zeichenfolge „Some text here“ erzeugt immer die Zeichenfolge „Some text here“.
  • „%CPUUtilization%“ erzeugt immer den Wert der CPUUtilization-Eigenschaft des übermittelten Ereignisses. Wenn die Eigenschaft keine Zeichenfolge ist, wird sie in eine Zeichenfolge konvertiert. Beispiel: „90“ oder „TRUE“.
  • „Die CPU-Auslastung dieses Prozessors beträgt aktuell %CPUUtilization%“ bettet den Wert der CPUUtilization-Eigenschaft des Ereignisses in die Zeichenfolge ein, sodass etwas in der Art von „Die CPU-Auslastung dieses Prozessors beträgt aktuell 90“ entsteht.
  • „%TargetInstance.CPUUtilization%“ ruft den Wert der CPUUtilization-Eigenschaft in der eingebetteten Instanz der TargetInstance-Eigenschaft ab.
  • „%%“ erzeugt ein einzelnes %-Zeichen.
  • Wenn die abgerufene Eigenschaft ein Array ist, wird das gesamte Array im folgenden Format erstellt: „(1,5,10,1024)“. Wenn im Array nur ein Element vorhanden ist, werden die Klammern weggelassen. Wenn keine Elemente im Array vorhanden sind, wird „()“ erzeugt.
  • Wenn eine Eigenschaft ein eingebettetes Objekt ist, wird die MOF-Darstellung des Objekts erstellt (ähnlich der IWbemClassObject::GetObjectText-Methode).
  • Wenn eine Eigenschaft eines eingebetteten Arrays von Objekten angefordert wird, wird sie als Eigenschaft mit einem Arraywert behandelt. Beispiel: %MyEvents.TargetInstance.DriverLetter% könnte „("C:","D:")“ erzeugen, wenn MyEvents ein Array eingebetteter Instanzänderungsereignisse ist.

Zeichenfolgenliterale

Alles, was von einem Paar Anführungszeichen eingeschlossen ist, gilt als Zeichenfolgenliteral und wird nicht ersetzt.

Das folgende Beispiel zeigt die Zeichenfolge, die der Compiler für „CPU-Auslastung ist %CPUUtilization%“ sieht.

CPU utilization is %CPUUtilization%

Diese Zeichenfolge ergibt die folgende Ausgabe.

CPU utilization is 90

Andererseits wird die Zeichenfolge „CPU-Auslastung ist \"%CPUUtilization%\"“ vom Compiler wie folgt „gesehen“.

CPU utilization is "%CPUUtilization%"

Diese Zeichenfolge erzeugt die folgende Ausgabe ohne Variablenersetzung.

CPU utilization is "%CPUUtilization%"

Überwachen von Ereignissen und Reagieren auf Ereignisse mit Standardconsumern