Gerätekonsolenbefehle (DevCon.exe)

DevCon (DevCon.exe) ist ein Befehlszeilentool, das detaillierte Informationen zu Geräten auf Computern mit Windows anzeigen kann. Sie können DevCon auch verwenden, um Geräte zu aktivieren, zu deaktivieren, zu installieren, zu konfigurieren und zu entfernen. DevCon verwendet die folgende Syntax.

devcon [/r] command [arguments]

Wichtig

PnPUtil wird mit jedem Release von Windows ausgeliefert und nutzt die zuverlässigsten und sichersten APIs, die verfügbar sind, und die Verwendung wird empfohlen. Weitere Informationen zur Verwendung von PnPutil anstelle von devcon finden Sie unter Ersetzen von DevCon.

Parameter

Hinweis

Um die status oder Konfiguration eines Geräts zu ändern, müssen Sie Mitglied der Gruppe Administratoren auf dem Computer sein.

Die Parameter in einem DevCon-Befehl müssen in der reihenfolge angezeigt werden, die in der Syntax angezeigt wird. Wenn Parameter nicht in der richtigen Reihenfolge sind, ignoriert DevCon sie, zeigt jedoch keinen Syntaxfehler an. Stattdessen verarbeitet er den Befehl mit den verbleibenden Parametern.

Um Hilfe zur Befehlssyntax zu erhalten, können Sie die folgenden Befehle in einem Eingabeaufforderungsfenster verwenden: DevCon-Hilfe oder DevCon-Hilfebefehl.

/R

Bedingter Neustart. Startet das System nach Abschluss eines Vorgangs nur neu, wenn ein Neustart erforderlich ist, um eine Änderung wirksam zu machen.

Dieser Parameter unterscheidet sich vom DevCon-Neustartvorgang , der das System zum Neustart zwingt. Stattdessen bestimmt der Parameter /r basierend auf dem Rückgabecode aus dem begleitenden Vorgang, ob ein Neustart erforderlich ist. Weitere Informationen finden Sie unter Neustarten und Neustarten.

command

Gibt einen DevCon-Befehl an. Informationen zu den verfügbaren DevCon-Befehlen und den Befehlsargumenten finden Sie in der folgenden Liste.

Sie können mithilfe des DevCon-Hilfebefehls auch Syntaxhilfe in einem Eingabeaufforderungsfenster erhalten.

Verwenden Sie die folgenden Befehle, um Informationen zu Geräten auf dem Computer aufzulisten und anzuzeigen :

• DevCon HwIDs
• DevCon-Klassen
• DevCon ListClass
• DevCon DriverFiles
• DevCon DriverNodes
• DevCon-Ressourcen
• DevCon Stack
• DevCon-Status
• DevCon Dp_enum

Verwenden Sie die folgenden Befehle, um nach Informationen zu Geräten auf dem Computer zu suchen :

• DevCon Find
• DevCon FindAll

Verwenden Sie die folgenden Befehle, um das Gerät zu bearbeiten oder seine Konfiguration zu ändern :

• DevCon-Aktivierung
• DevCon-Deaktivierung
• DevCon Update
• DevCon UpdateNI
• DevCon-Installation
• DevCon Entfernen
• DevCon Rescan
• DevCon-Neustart
• DevCon-Neustart
• DevCon SetHwID
• DevCon ClassFilter
• DevCon Dp_add
• DevCon Dp_delete

Argumente

Gibt die Argumente für einen DevCon-Befehl an.

/? oder Hilfe

Zeigt die Hilfe an. Wenn Sie einen Vorgang angeben, zeigt DevCon ausführliche Hilfe für den Vorgang an.

Die Parameter müssen in der angegebenen Reihenfolge angezeigt werden. Geben Sie beispielsweise devcon /? ein, um Hilfe für den DevCon-Statusvorgang anzuzeigen. status (oder devcon help status), nicht devcon status /?.

Kommentare

Viele DevCon-Vorgänge erfordern die Hardware-ID des Geräts. Um eine Liste der Hardware-IDs aller Geräte auf dem Computer zur Verwendung in nachfolgenden DevCon-Vorgängen zu erstellen, beginnen Sie mit einem DevCon HwIDs-Befehl . Weitere Informationen finden Sie unter Hardware-IDs und Geräteidentifikationszeichenfolgen.

So sucht DevCon nach Geräten

DevCon identifiziert Geräte anhand des Computernamens, der Hardware-ID, der kompatiblen ID, der Geräte-instance-ID und/oder der Geräteeinrichtungsklasse.

Wenn ein Befehl mehrere ID- oder ID-Muster enthält (eine ID, die Platzhalterzeichen (*) enthält), gibt DevCon Geräte zurück, deren IDs mit einer der IDs oder ID-Mustern übereinstimmen. Das heißt, es wird ein "oder" zwischen den ID-Argumenten vorausgesetzt.

Beispielsweise gibt devcon hwids *pnp* *mou* Geräte zurück, die entweder "pnp" oder "mou" in ihrer Hardware-ID oder kompatiblen ID enthalten.

Wenn ein Befehl eine Gerätesetupklasse enthält, beschränkt DevCon die Suche zunächst auf die Setupklasse und gibt dann Geräte in der Klasse zurück, die einem der ID-Muster entsprechen. Das heißt, es wird ein "and" zwischen der Klasse und den IDs und ein "oder" zwischen den einzelnen ID-Argumenten vorausgesetzt.

Beispielsweise gibt devcon hwids =media *pnp* *microsoft* Geräte in der Mediengeräteeinrichtungsklasse zurück, die entweder "pnp" oder "microsoft" in ihrer Hardware-ID oder kompatiblen ID enthalten.

Neustarten und Neustarten

DevCon bietet zwei Methoden zum Neustarten des Betriebssystems und eine Methode zum Neustarten von Geräten.

• Der Parameter /r ist ein bedingter Neustart, der das Betriebssystem nur dann neu startet, wenn ein Neustart erforderlich ist, um den begleitenden Vorgang wirksam zu machen. Dieser Parameter ist nur in Befehlen gültig, die einen DevCon-Vorgang enthalten. Es kann das System auf einem lokalen Computer neu starten.

• Der DevCon-Neustartvorgang zwingt das Betriebssystem zum Neustart. Sie ist nur auf einem lokalen Computer gültig und kann nicht mit anderen Vorgängen kombiniert werden. Anstatt den Neustartvorgang zu verwenden, fügen Benutzer in der Regel befehle den Parameter /r hinzu.

• Der DevCon-Neustartvorgang startet die angegebenen Geräte neu. Sie ist nur auf einem lokalen Computer gültig und kann nicht mit anderen Vorgängen kombiniert werden.

DevCon-Rückgabecodes

DevCon gibt eine ganze Zahl zurück, die in Programmen und Skripts verwendet werden kann, um den Erfolg eines DevCon-Befehls zu bestimmen (z. B . return = devcon hwids *).

In der folgenden Tabelle werden die Rückgabecodes aufgelistet und beschrieben.

Rückgabecode	Beschreibung
0	Erfolgreich
1	Neustart erforderlich
2	Fehler
3	Syntaxfehler