Команды консоли устройства (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
- Отключение 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 | Синтаксическая ошибка |