Команды консоли устройств (DevCon.exe)

DevCon (DevCon.exe) — это средство командной строки, которое может отображать подробные сведения о устройствах под управлением Windows. Вы также можете использовать DevCon для включения, отключения, установки, настройки и удаления устройств. DevCon использует следующий синтаксис.

devcon [/r] command [arguments]

Внимание

PnPUtil поставляется с каждым выпуском Windows и использует наиболее надежные и безопасные API и его использование рекомендуется. Дополнительные сведения об использовании PnPutil вместо devcon см. в разделе "Замена DevCon".

Параметры

Примечание.

Чтобы изменить состояние или конфигурацию устройства, необходимо быть членом группы "Администраторы" на компьютере.

Параметры команды DevCon должны отображаться в порядке, показанном в синтаксисе. Если параметры не упорядочены, DevCon игнорирует их, но не отображает синтаксическую ошибку. Вместо этого она обрабатывает команду с оставшимися параметрами.

Для справки по синтаксису команд можно использовать следующие команды в окне командной строки: справка DevCon или команда справки DevCon.

/r

Условная перезагрузка. Перезагружает систему после завершения операции только в том случае, если перезагрузка требуется для эффективного изменения.

Этот параметр отличается от операции перезагрузки DevCon, которая заставляет систему перезагружаться. Вместо этого параметр /r определяет, требуется ли перезагрузка на основе возвращаемого кода из сопровождающей операции. Дополнительные сведения см. в разделе "Перезагрузка и перезапуск".

command

Задает команду DevCon. Сведения о доступных командах DevCon и аргументах команд см. в следующем списке.

Вы также можете получить справку по синтаксису в окне командной строки с помощью команды справки DevCon.

Чтобы получить список и отображение сведений об устройствах на компьютере, используйте следующие команды:

• DevCon HwIDs
• Классы DevCon
• DevCon ListClass
• DevCon DriverFiles
• DevCon DriverNodes
• Ресурсы DevCon
• Стек DevCon
• Состояние DevCon
• DevCon Dp_enum

Чтобы найти сведения об устройствах на компьютере, используйте следующие команды:

• Поиск DevCon
• DevCon FindAll

Для управления устройством или изменения его конфигурации используйте следующие команды:

• Включение DevCon
• Отключение DevCon
• Обновление DevCon
• DevCon UpdateNI
• Установка DevCon
• Удаление DevCon
• DevCon Rescan
• Перезапуск DevCon
• Перезагрузка DevCon
• DevCon SetHwID
• DevCon ClassFilter
• DevCon Dp_add
• DevCon Dp_delete

Аргументы

Задает аргументы для команды DevCon.

/? или справка

Вывод справки. Если указать операцию, DevCon отображает подробную справку по операции.

Параметры должны отображаться в указанном порядке. Например, чтобы отобразить справку по операции "Состояние DevCon", введите состояние devcon /? (или состояние справки devcon), а не состояние devcon /?.

Комментарии

Для многих операций DevCon требуется идентификатор оборудования устройства. Чтобы создать список идентификаторов оборудования всех устройств на компьютере для использования в последующих операциях DevCon, начните с команды DevCon HwIDs. Дополнительные сведения см. в разделе "Идентификаторы оборудования" и "Строки идентификации устройств".

Как DevCon ищет устройства

DevCon определяет устройства по имени компьютера, аппаратному идентификатору, совместимом идентификатору, идентификатору экземпляра устройства и /или классу установки устройства.

Если команда содержит несколько шаблонов идентификаторов или идентификаторов (идентификатор, содержащий подстановочные знаки (*)), DevCon возвращает устройства, идентификаторы которых соответствуют любому из идентификаторов или шаблонов идентификаторов. То есть предполагается, что аргументы идентификатора являются "или".

Например, devcon hwids *pnp* *mou* возвращает устройства, которые включают "pnp" или "mou" в идентификатор оборудования или совместимый идентификатор.

Если команда включает класс установки устройства, DevCon сначала ограничивает поиск в классе установки, а затем возвращает устройства в классе, которые соответствуют любому из шаблонов идентификаторов, то есть предполагает "и" между классом и идентификаторами и "или" между каждым из аргументов идентификаторов идентификаторов.

Например, devcon hwids =media *pnp* *microsoft* возвращает устройства в классе установки устройств мультимедиа, которые включают "pnp" или "microsoft" в идентификатор оборудования или совместимый идентификатор.

Перезагрузка и перезапуск

DevCon предоставляет два метода перезагрузки операционной системы и один метод для перезапуска устройств.

• Параметр /r — это условная перезагрузка, которая перезагружает операционную систему только в том случае, если требуется перезагрузка, чтобы сделать сопровождающую операцию эффективной. Этот параметр действителен только в командах, которые включают операцию DevCon. Он может перезагрузить систему на локальном компьютере.

• Операция "Перезагрузка DevCon" заставляет операционную систему перезагружаться . Он действителен только на локальном компьютере, и его нельзя объединить с другими операциями. Вместо использования операции перезагрузки пользователи обычно добавляют параметр /r в команды.

• Операция DevCon Restart перезапускает указанные устройства. Он действителен только на локальном компьютере, и его нельзя объединить с другими операциями.

Коды возврата DevCon

DevCon возвращает целое число, которое можно использовать в программах и сценариях для определения успешности команды DevCon (например, return = devcon hwids *).

В следующей таблице перечислены и описываются коды возврата.

Код возврата	Description
0	Удачное завершение
1	Требуется перезагрузка
2	Сбой
3	Синтаксическая ошибка