【VS开发】设备控制台 (DevCon.exe) 命令

设备控制台 (DevCon.exe) 命令

DevCon (DevCon.exe) 是一个命令行工具，可以显示有关运行 Windows 的计算机上设备的详细信息。还可以使用 DevCon 启用、禁用、安装、配置以及删除设备。DevCon 使用以下语法。

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

参数

注意  若要更改设备的状态或配置，你必须是计算机上 Administrators 组的成员。

DevCon 命令中的参数必须按照语法中显示的顺序出现。如果参数没有按顺序出现，则 DevCon 会忽略这些参数，但不会显示语法错误。它会使用剩余的参数来处理该命令。

有关命令语法的帮助，你可以在“命令提示符”窗口中使用以下命令：DevCon help 或 DevCon help command

/m:\computer

在指定的远程计算机上运行此命令。要求使用反斜杠。

注意   若要在远程计算机上运行 DevCon 命令，组策略设置必须允许即插即用服务在远程计算机上运行。在运行 Windows Vista 和更高版本的 Windows 上，默认情况下组策略将禁止对此服务的远程访问。在运行 Windows 驱动程序工具包 (WDK) 8.1 和 Windows 驱动程序工具包 (WDK) 8 的计算机上，远程访问功能不可用。

/r

有条件地重新启动。只有在需要重新启动才能使更改生效时，完成某个操作之后重新启动系统。

该参数不同于强制系统重新启动的 DevCon Reboot 操作。/r 参数根据随附操作的返回代码来确定是否需要重新启动。有关详细信息，请参阅重新启动和重启。

command

指定一个 DevCon 命令。 有关可用的 DevCon 命令和命令参数的信息，请使用以下列表。

还可以在“命令提示符”窗口中使用 DevCon help command 获取语法帮助。

若要“列出和显示”有关计算机上设备的信息，请使用以下命令：

DevCon HwIDs

DevCon Classes

DevCon ListClass

DevCon DriverFiles

DevCon DriverNodes

DevCon Resources

DevCon Stack

DevCon Status

DevCon Dp_enum

若要“搜索”有关计算机上设备的信息，请使用以下命令：

DevCon Find

DevCon FindAll

若要操纵设备或“更改”其配置，请使用以下命令：

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

为 DevCon 命令指定参数。

/? 或 help

显示帮助。如果指定某个操作，DevCon 会显示该操作的详细帮助。

参数必须按照指定的顺序出现。例如，若要显示 DevCon Status 操作的帮助，请键入 devcon /? status（或 devcon help status），而不是 devcon status /?。

备注

很多 DevCon 操作都需要设备的硬件 ID。若要创建计算机上所有设备的硬件 ID 列表以便在随后的 DevCon 操作中使用，请从 DevCon HwIDs 命令开始。有关详细信息，请参阅硬件 ID 和设备标识字符串。

DevCon 如何搜索设备

DevCon 通过其计算机名、硬件 ID、兼容的 ID、设备实例 ID 和/或设备安装程序类来标识设备。

如果命令包含多个 ID 或 ID 模式（ID 中包含通配符 (*)），则 DevCon 返回其 ID 与任何 ID 或 ID 模式匹配的设备。也就是说，假定 ID 参数之间是“or”的关系。

例如，devcon hwids *pnp* *mou* 返回其硬件 ID 或兼容的 ID 中包含“pnp”或“mou”的设备。

如果命令包含一个设备安装程序类，则 DevCon 首先将搜索限制于该安装程序类，然后返回该类中与任何 ID 模式匹配的设备，也就是说，假定该类和 ID 之间是“and”关系，并且每个 ID 参数之间是“or”关系。

例如，devcon hwids =media *pnp* *microsoft* 返回该媒体设备安装程序类中其硬件 ID 或兼容的 ID 中包含“pnp”或“microsoft”的设备。

注意   若要在远程计算机上运行 DevCon 命令，组策略设置必须允许即插即用服务在远程计算机上运行。在运行 Windows Vista 和更高版本的 Windows 上，默认情况下组策略将禁止对此服务的远程访问。在运行 WDK 8.1 和 WDK 8 的计算机上，远程访问功能不可用。

重新启动和重启

DevCon 提供两种方法来重新启动操作系统，并提供一种方法来重新启动设备。

• /r 参数是条件性重新启动，用于仅在需要重新启动以使附带的操作生效的情况下重新启动操作系统。此参数仅在包含 DevCon 操作的命令中有效。它可以重新启动本地计算机或远程计算机上的系统（Windows XP 和更早版本）。

• DevCon Reboot 操作强制重新启动操作系统。它仅在本地计算机上有效，并且无法与其他操作组合。不使用重新启动操作，用户通常可以将 /r 参数添加到命令中。

• DevCon Restart 操作重启指定设备。它仅在本地计算机上有效，并且无法与其他操作组合。

DevCon 返回代码

DevCon 返回一个整数，可以在程序和脚本中使用该整数来确定 DevCon 命令的成功（例如，return = devcon hwids *）。

下表列出并描述了返回代码。

返回代码	含义
0	成功
1	需要重新启动
2	失败
3	语法错误