Read-WmiObject

Einfache WMI Abfrage absetzen.


Befehlseingaben:

  • Namespace
    Angabe des Namespaces, zu dem verbunden werden soll und in dem sich die Klasse (Objekt) befindet. Dieser Wert wird auch über den WMI-Browser gesetzt. Der Standard-Namespace ist \\.\root\CIMV2.
  • Objektpfad
    Dies ist der relative Pfad innerhalb des Namespaces und entspricht dem Klassennamen, für den die Anzahl der vorhandenen Instanzen auf dem System ermittelt werden soll. Dieser Wert wird auch über den WMI-Browser gesetzt.
  • Abfrage
    In der Abfrage wird ein Kriterium angegeben (ähnlich wie die WHERE-Klausel in der SQL-Abfrage), das erfüllt sein muss. Passt dieses Kriterium zu einer gefundenen Instanz der angegebenen Klasse, so werden die Eigenschaften dieser Instanz verwendet. Es ist allerdings so, dass nicht eine Ergebnismenge zurück gegeben wird, sondern lediglich die erste Instanz zu der dieses Kriterium passt. Im Moment wird als Kriterium nur das Gleichheitszeichen unterstützt. Dieser Wert wird auch über den Assistenten in dem Dialog Suchschlüssel eingeben gesetzt.

  • Variablenpräfix
    Dieser Eintrag ergibt zusammen mit den Eigenschaftsnamen den eigentlichen Variablennamen, d.h. das Präfix wird den Variablennamen vorangestellt.
  • Eigenschaften
    Namen der Eigenschaften, die im WMI-Browser ausgewählt wurden. Jede Zeile ergibt zusammen mit dem Variablenpräfix eine Variable. Der Wert der Variablen ergibt sich zur Laufzeit bei Skriptausführung.


Beispiel:

Das folgende Beispiel such aus dem CIMV2-Namespace alle Instanzen der Klasse Win32_LogicalDisk, bei denen die Eigenschaft Caption den Wert C: hat. Sodann werden von diesen Instanzen die Werte der Eigenschaften FreeSpace und Size ausgelesen und in gleichnamigen Variablen, die mit dem Präfix _WMI beginnen, gespeichert. Als Ergebnis steht die Kapazität des Laufwerks C: also in der Variablen _WMISize, der aktuell freie Platz in der Variablen _WMIFreeSpace:


Entspricht DSM eScript Befehl:

  • WMISimpleQuery


Siehe auch: