Export (0) Print
Expand All

Device Console (DevCon.exe) Commands

DevCon (DevCon.exe) is a command line tool that can display detailed information about devices on computers running Windows. You can also use DevCon to enable, disable, install, configure, and remove devices. DevCon uses the following syntax.


devcon [/m:\\computer] [/r] command [arguments] 

Parameters

Note  To change the status or configuration of a device, you must be a member of the Administrators group on the computer.

The parameters in a DevCon command must appear in the order shown in the syntax. If parameters are not in order, DevCon ignores them, but does not display a syntax error. Instead, it processes the command with the remaining parameters.

For help on command syntax, you can use the following commands in a Command Prompt window: DevCon help or DevCon help command.

/m:\\computer
Runs the command on the specified remote computer. The backslashes are required.

Note   To run DevCon commands on a remote computer, the Group Policy setting must allow the Plug and Play service to run on the remote computer. On computers that run Windows Vista and later versions of Windows, the Group Policy disables remote access to the service by default. On computers that run WDK 8.1 and WDK 8, the remote access feature is unavailable.

/r

Conditional reboot. Reboots the system after completing an operation only if a reboot is required to make a change effective.

This parameter differs from the DevCon Reboot operation, which forces the system to reboot. Instead, the /r parameter determines whether a reboot is required based on the return code from the accompanying operation.For more information, see Rebooting and restarting.

command

Specifies a DevCon command. For information about the available DevCon commands and the command arguments, use the following list.

You can also get syntax help in a Command Prompt window using DevCon help command.

To list and display information about devices on the computer, use the following commands:

DevCon HwIDs

DevCon Classes

DevCon ListClass

DevCon DriverFiles

DevCon DriverNodes

DevCon Resources

DevCon Stack

DevCon Status

DevCon Dp_enum

To search for information about devices on the computer, use the following commands:

DevCon Find

DevCon FindAll

To manipulate the device or change its configuration, use the following commands:

DevCon Enable

DevCon Disable

DevCon Update

DevCon UpdateNI

DevCon Install

DevCon Remove

DevCon Rescan

DevCon Restart

DevCon Reboot

DevCon SetHwID

DevCon ClassFilter

DevCon Dp_add

DevCon Dp_delete

arguments

Specifies the arguments for a DevCon command.

/? or help

Displays help. If you specify an operation, DevCon displays detailed help for the operation.

The parameters must appear in the specified order. For example, to display help for the DevCon Status operation, type devcon /? status (or devcon help status), not devcon status /?.

Comments

Many DevCon operations require the hardware ID of the device. To create a list of the hardware IDs of all devices on the computer for use in subsequent DevCon operations, begin with a DevCon HwIDs command. For more information, see Hardware IDs and Device Identification Strings.

How DevCon searches for devices

DevCon identifies devices by their computer name, hardware ID, compatible ID, device instance ID, and/or device setup class.

If a command includes more than one ID or ID pattern (an ID that contains wildcard characters (*)), DevCon returns devices whose IDs match any of the IDs or ID patterns. That is, it assumes an "or" between the ID arguments.

For example, devcon hwids *pnp* *mou* returns devices that include either "pnp" or "mou" in their hardware ID or compatible ID.

If a command includes a device setup class, DevCon first limits the search to the setup class and then returns devices in the class that match any of the ID patterns, that is, it assumes an "and" between the class and the IDs and an "or" between each of the ID arguments.

For example, devcon hwids =media *pnp* *microsoft* returns devices in the media device setup class that include either "pnp" or "microsoft" in their hardware ID or compatible ID.

Note   To run DevCon commands on a remote computer, the Group Policy setting must allow the Plug and Play service to run on the remote computer. On computers that run Windows Vista and later versions of Windows, the Group Policy disables remote access to the service by default. On computers that run WDK 8.1 and WDK 8, the remote access feature is unavailable.

Rebooting and restarting

DevCon provides two methods to reboot the operating system and one method to restart devices.

  • The /r parameter is a conditional reboot that reboots the operating system only if a reboot is required to make the accompanying operation effective. This parameter is valid only in commands that include a DevCon operation. It can reboot the system on a local computer or a remote computer (Windows XP and earlier).

  • The DevCon Reboot operation forces the operating system to reboot. It is valid only on a local computer, and it cannot be combined with other operations. Instead of using the reboot operation, users typically add the /r parameter to commands.

  • The DevCon Restart operation restarts the specified devices. It is valid only on a local computer, and it cannot be combined with other operations.

DevCon return codes

DevCon returns an integer that can be used in programs and scripts to determine the success of a DevCon command (for example, return = devcon hwids *).

The following table lists and describes the return codes.

Return codeMeaning

0

Success

1

Requires reboot

2

Failure

3

Syntax error

 

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft