WMIC: WMI-Befehlszeilenprogramm
Wichtig
WMIC ist ab Windows 10 Version 21H1 und ab dem halbjährlichen 21H1-Kanalrelease von Windows Server veraltet. Dieses Hilfsprogramm wird durch Windows PowerShell für WMI ersetzt. Siehe Kapitel 7 – Arbeiten mit WMI. Diese Veraltetkeit gilt nur für das Hilfsprogramm WMIC. Die Windows-Verwaltungsinstrumentation (WMI) selbst ist nicht betroffen. Sehen Sie sich auch die veralteten Features für Windows-Clients an.
Das WMI-Befehlszeilenprogramm (WMIC) stellt eine Befehlszeilenschnittstelle für die Windows-Verwaltungsinstrumentation (Windows Management Instrumentation, WMI) bereit. WMIC ist mit vorhandenen Shells und Hilfsprogrammbefehlen kompatibel. Die folgenden Informationen sind eine allgemeine Referenzanleitung für WMIC. Weitere Informationen und Richtlinien zur Verwendung von WMIC, einschließlich zusätzlicher Informationen zu Aliasen, Verben, Schaltern und Befehlen, finden Sie unter Verwenden der Befehlszeile der Windows-Verwaltungsinstrumentation und WMIC – Übernehmen der Befehlszeilensteuerung über WMI.
Alias
Ein Alias ist eine benutzerfreundliche Umbenennung einer Klasse, Eigenschaft oder Methode, die die Verwendung und das Lesen von WMI erleichtert. Sie können über den /?
Befehl bestimmen, welche Aliase für WMIC verfügbar sind. Sie können auch die Aliase für eine bestimmte Klasse mithilfe des <className> /?
Befehls bestimmen. Weitere Informationen finden Sie unter WMIC-Aliase.
Switch
Ein Switch ist eine WMIC-Option, die Sie global oder optional festlegen können. Eine Liste der verfügbaren Switches finden Sie unter WMIC-Switches.
Verben
Um Verben in WMIC zu verwenden, geben Sie den Aliasnamen gefolgt von dem Verb ein. Wenn ein Alias kein Verb unterstützt, erhalten Sie die Nachricht „Der Anbieter ist nicht in der Lage, den versuchten Vorgang durchzuführen“. Weitere Informationen finden Sie unter WMIC-Verben.
Die meisten Aliase unterstützen die folgenden Verben:
ASSOC
Gibt das Ergebnis der Abfrage zurück, bei der Associators of (<wmi_object>)
<wmi_object> der Pfad der von den PATH
Befehlen oder CLASS
zurückgegebenen Objekte ist. Die Ergebnisse sind Instanzen, die dem Objekt zugeordnet sind. Wenn ASSOC
mit einem Alias verwendet wird, werden die Klassen mit der Klasse zurückgegeben, die dem Alias zugrunde liegt. Standardmäßig wird die Ausgabe im HTML-Format zurückgegeben.
Das ASSOC
Verb verfügt über die folgenden Schalter:
Schalter | BESCHREIBUNG |
---|---|
/RESULTCLASS:<classname> |
Zurückgegebene Endpunkte, die dem Quellobjekt zugeordnet sind, müssen der angegebenen Klasse angehören oder von dieser abgeleitet werden. |
/RESULTROLE:<rolename> |
Zurückgegebene Endpunkte müssen bei Zuordnungen mit dem Quellobjekt eine bestimmte Rolle spielen. |
/ASSOCCLASS:<assocclass> |
Zurückgegebene Endpunkte müssen über die angegebene Klasse oder eine ihrer abgeleiteten Klassen der Quelle zugeordnet werden. |
Ein Beispiel: os assoc
CALL
Führt eine Methode aus.
Ein Beispiel: service where caption="telnet" call startservice
Hinweis
Verwenden Sie /?
, um die für eine bestimmte Klasse verfügbaren Methoden zu bestimmen. Listet service where caption="telnet" call /?
beispielsweise die verfügbaren Funktionen für die Dienstklasse auf.
CREATE
Erstellt eine neue Instanz und legt die Eigenschaftswerte fest. CREATE
kann nicht zum Erstellen einer neuen Klasse verwendet werden.
Ein Beispiel: environment create name="temp"; variablevalue="new"
Delete
Löscht die aktuelle Instanz bzw. die aktuellen Instanzensätze. DELETE
kann verwendet werden, um eine Klasse zu löschen.
Ein Beispiel: process where name="calc.exe" delete
GET
Ruft bestimmte Eigenschaftswerte ab.
GET
verfügt über die folgenden Schalter:
Schalter | BESCHREIBUNG |
---|---|
/VALUE |
Die Ausgabe wird mit jedem Wert formatiert, der in einer separaten Zeile und mit dem Namen der Eigenschaft aufgeführt ist. |
/ALL |
Die Ausgabe ist als Tabelle formatiert. |
/TRANSLATE:<translation table> |
Übersetzt die Ausgabe mithilfe der vom Befehl benannten Übersetzungstabelle. Die Übersetzungstabellen BasicXml und NoComma sind in WMIC enthalten. |
/EVERY:<interval> |
Wiederholt den Befehl jedes <Intervall> von Sekunden. |
/FORMAT:<format specifier> |
Gibt ein Schlüsselwort oder einen XSL-Dateinamen an, um die Daten zu formatieren. |
Ein Beispiel: process get name
AUFLISTEN
Zeigt Daten an. LIST
ist das Standardverb.
LIST
verfügt über die folgenden Adverbs:
Adverb | BESCHREIBUNG |
---|---|
BRIEF |
Kernsatz der Eigenschaften |
FULL |
Alle Eigenschaften. Dies ist der Standard-Adverb für LIST |
INSTANCE |
Nur Instanzpfade |
STATUS |
Status der Objekte |
SYSTEM |
Systemeigenschaften |
LIST
verfügt über die folgenden Schalter:
Schalter | BESCHREIBUNG |
---|---|
/TRANSLATE:<translation table> |
Übersetzen Sie die Ausgabe mithilfe der vom Befehl benannten Übersetzungstabelle. Die Übersetzungstabellen BasicXml und NoComma sind in WMIC enthalten. |
/EVERY:<interval> |
Wiederholen Sie den Befehl jedes <Intervall> von Sekunden. |
/FORMAT:<format specifier> |
Gibt ein Schlüsselwort oder einen XSL-Dateinamen an, um die Daten zu formatieren. |
Ein Beispiel: process list brief
SET
Weist Eigenschaften Werte zu.
Beispiel: environment set name="temp"
, variablevalue="new"
Switches
Globale Switches werden verwendet, um Standardwerte für die WMIC-Umgebung festzulegen. Sie können den aktuellen Wert der von diesen Schaltern festgelegten Bedingungen anzeigen, indem Sie den CONTEXT
Befehl eingeben.
/NAMESPACE
Namespace, den der Alias in der Regel verwendet. Der Standardwert lautet root\cimv2
.
Ein Beispiel: /namespace:\\root
/ROLE
Namespace, in dem WMIC normalerweise nach Aliasen und anderen WMIC-Informationen sucht.
Ein Beispiel: /role:\\root
/NODE
Computernamen, durch Komma getrennt. Alle Befehle werden synchron bei allen in diesem Wert aufgeführten Computer ausgeführt. Dateinamen müssen das Präfix & aufweisen. Computernamen in einer Datei müssen durch Komma getrennt oder in separaten Zeilen sein.
/IMPLEVEL
Identitätswechselebene.
Ein Beispiel: /implevel:Anonymous
/AUTHLEVEL
Authentifizierungsebene.
Ein Beispiel: /authlevel:Pkt
/LOCALE
Gebietsschema.
Ein Beispiel: /locale:ms_411
/PRIVILEGES
Aktiviert oder deaktiviert alle Berechtigungen.
Beispiel: /privileges:enable
oder /privileges:disable
/TRACE
Zeigt den Erfolg oder Fehler aller Funktionen an, die zum Ausführen von WMIC-Befehlen verwendet werden.
Beispiel: /trace:on
oder /trace:off
/RECORD
Zeichnet die gesamte Ausgabe in einer XML-Datei auf. Die Ausgabe wird auch in der Eingabeaufforderung angezeigt.
Ein Beispiel: /record:MyOutput.xml
/INTERACTIVE
Normalerweise werden Löschbefehle bestätigt.
Beispiel: /interactive:on
oder /interactive:off
/FAILFAST on|off|TimeoutInMilliseconds
Bei ON werden die /NODE
Computer vor dem Senden von WMIC-Befehlen an sie pingt. Wenn ein Computer nicht antwortet, werden die WMIC-Befehle nicht an ihn gesendet.
Beispiel: /failfast:on
oder /failfast:off
/USER
Benutzername, der von WMIC beim Zugriff auf die /NODE
in den Aliasen angegebenen Computer verwendet wird. Sie werden zur Eingabe des Kennworts aufgefordert. Ein Benutzername kann nicht mit dem lokalen Computer verwendet werden.
Ein Beispiel: /user:JSMITH
/PASSWORD
Kennwort, das von WMIC beim Zugriff auf die /NODE
Computer verwendet wird. Das Kennwort ist in der Befehlszeile sichtbar.
Ein Beispiel: /password:password
/OUTPUT
Gibt einen Modus für die gesamte Ausgabeumleitung an. Die Ausgabe wird nicht in der Befehlszeile angezeigt, und das Ziel wird gelöscht, bevor die Ausgabe beginnt. Gültige Werte sind STDOUT, CLIPBOARD oder ein Dateiname.
Ein Beispiel: /output:clipboard
/APPEND
Gibt einen Modus für die gesamte Ausgabeumleitung an. Die Ausgabe wird nicht in der Befehlszeile angezeigt, und das Ziel wird nicht gelöscht, bevor die Ausgabe beginnt; die Ausgabe wird am Ende des aktuellen Inhalts des Ziels angefügt. Gültige Werte sind STDOUT, CLIPBOARD oder ein Dateiname.
Ein Beispiel: /append:clipboard
/AGGREGATE
Wird mit dem LIST
Schalter und GET /EVERY
verwendet. Wenn AGGREGATE
auf ON festgelegt ist und deren Ergebnisse angezeigt werden, LIST
GET
wenn alle Computer in der /NODE
entweder geantwortet haben oder ein Timeout aufgetreten ist. Wenn AGGREGATE
auf OFF festgelegt ist, LIST
und GET
ihre Ergebnisse angezeigt werden, sobald sie empfangen werden.
Beispiel: /aggregate:off
oder /aggregate:on
Befehle
Die folgenden WMIC-Befehle sind jederzeit verfügbar. Weitere Informationen finden Sie unter WMIC-Befehle.
CLASS
Escapes aus dem Standardaliasmodus von WMIC für den direkten Zugriff auf Klassen im WMI-Schema Weitere Informationen zu verfügbaren WMI-Klassen finden Sie unter WMI-Klassen.
Ein Beispiel: wmic /output:c:\ClassOutput.htm class Win32_SoundDevice
PATH
Escapes aus dem Standardaliasmodus von WMIC für den direkten Zugriff auf Instanzen im WMI-Schema
Ein Beispiel: wmic /output:c:\PathOutput.txt path Win32_SoundDevice get /value
KONTEXT
Zeigt die aktuellen Werte aller globalen Switches an.
Ein Beispiel: wmic context
QUIT
Beendet WMIC.
Ein Beispiel: wmic quit
EXIT
Beendet WMIC.
Ein Beispiel: wmic exit
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) |
Windows Vista |
Unterstützte Mindestversion (Server) |
Windows Server 2008 |
Feedback
Feedback senden und anzeigen für