Команды консоли устройства (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.

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

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

Параметры должны отображаться в указанном порядке. Например, чтобы отобразить справку для операции Состояния DevCon , введите devcon /? status (или состояние справки 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 Reboot принудительно перезагружает операционную систему. Он действителен только на локальном компьютере и не может быть объединен с другими операциями. Вместо того, чтобы использовать операцию перезагрузки, пользователи обычно добавляют параметр /r в команды.

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

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

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

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

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