Команды консоли устройства (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 Stack
• Состояние DevCon
• DevCon Dp_enum

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

• DevCon Find
• DevCon FindAll

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

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

Аргументы

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

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

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

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

Комментарии

Для многих операций 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 перезапускает указанные устройства. Он действителен только на локальном компьютере и не может быть объединен с другими операциями.

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

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

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

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