Win32_PnPEntity类

Win32_PnPEntityWMI 类表示即插即用设备的属性。 即插即用实体显示为位于控制面板设备管理器中的条目。

以下语法从托管对象格式 (MOF) 代码中简化，包括所有继承的属性。 属性按字母顺序列出，而不是按 MOF 顺序列出。

语法

[Dynamic, Provider("CIMWin32"), UUID("{FE28FD98-C875-11d2-B352-00104BC97924}"), AMENDMENT]
class Win32_PnPEntity : CIM_LogicalDevice
{
  uint16   Availability;
  string   Caption;
  string   ClassGuid;
  string   CompatibleID[];
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string   CreationClassName;
  string   Description;
  string   DeviceID;
  boolean  ErrorCleared;
  string   ErrorDescription;
  string   HardwareID[];
  datetime InstallDate;
  uint32   LastErrorCode;
  string   Manufacturer;
  string   Name;
  string   PNPClass;
  string   PNPDeviceID;
  uint16   PowerManagementCapabilities[];
  boolean  PowerManagementSupported;
  boolean  Present;
  string   Service;
  string   Status;
  uint16   StatusInfo;
  string   SystemCreationClassName;
  string   SystemName;
};

成员

Win32_PnPEntity类包含以下类型的成员：

• 方法
• 属性

方法

Win32_PnPEntity类具有这些方法。

方法	说明
禁用	禁用此即插即用设备。
使	启用此即插即用设备。
GetDeviceProperties	获取此即插即用设备的指定属性。
重置	未实现。 若要实现此方法，请参阅 CIM_LogicalDevice 中的 Reset 方法。
SetPowerState	未实现。 若要实现此方法，请参阅 CIM_LogicalDevice 中的 SetPowerState 方法。

 

属性

Win32_PnPEntity类具有这些属性。

可用性

数据类型： uint16

访问类型：只读

限定符： MappingStrings (“MIF。DMTF|操作状态|003.5“、”MIB”。IETF|HOST-RESOURCES-MIB.hrDeviceStatus“)

设备的可用性和状态。

此属性继承自 CIM_LogicalDevice。

其他 (1)

未知 (2)

运行/全能 (3)

正在运行或全能

警告 (4)

在测试 (5)

不适用 (6)

关机 (7)

下线 (8)

下班 (9)

降级 (10)

未安装 (11)

安装错误 (12)

省电 - 未知 (13)

已知设备处于省电模式，但其确切状态未知。

省电 - 低功率模式 (14)

设备处于省电状态，但仍正常运行，并可能表现出性能下降。

省电 - 备用 (15)

设备无法正常运行，但可以快速提供全功率。

Power Cycle (16)

省电 - 警告 (17)

设备处于警告状态，同时处于省电模式。

已暂停 (18)

设备已暂停。

未就绪 (19)

设备未准备就绪。

未配置 (20)

设备未配置。

静止 (21)

设备安静。

Caption

数据类型： 字符串

访问类型：只读

限定符： MaxLen (64) 、 DisplayName (“Caption”)

对象的简短说明。

此属性继承自 CIM_ManagedSystemElement。

ClassGuid

数据类型： 字符串

访问类型：只读

限定符： MappingStrings (“WMI”)

此即插即用设备的全局唯一标识符 (GUID) 。

CompatibleID

数据类型： 字符串 数组

访问类型：只读

安装程序用来将设备与 INF 文件匹配的供应商定义的标识字符串。 设备可以有一个与之关联的兼容 ID 的列表。 应按降低适用性的顺序列出兼容的 ID。 如果安装程序找不到与某个设备硬件 ID 匹配的 INF 文件，则它使用兼容的 ID 来查找 INF 文件。 兼容 ID 的格式与 HardwareID 相同。 有关详细信息，请参阅Windows驱动程序工具包。

ConfigManagerErrorCode

数据类型： uint32

访问类型：只读

限定符： 架构 (“Win32”)

Win32 Configuration Manager错误代码。

此属性继承自 CIM_LogicalDevice。

此设备正常工作。 (0)

设备正常工作。

此设备未正确配置。 (1)

设备未正确配置。

Windows无法加载此设备的驱动程序。 ( 2)

此设备的驱动程序可能已损坏，或者系统在内存或其他资源上运行不足。 (3)

此设备的驱动程序可能已损坏，或者系统内存或其他资源可能较低。

此设备无法正常工作。其中一个驱动程序或注册表可能已损坏。 (4)

设备无法正常工作。 其中一个驱动程序或注册表可能已损坏。

此设备的驱动程序需要Windows无法管理的资源。 ( 5)

设备的驱动程序需要Windows无法管理的资源。

此设备的启动配置与其他设备冲突。 (6)

设备的启动配置与其他设备冲突。

无法筛选。 (7)

设备驱动程序加载程序缺失。 (8)

设备驱动程序加载程序缺失。

此设备无法正常工作，因为控制固件报告设备的资源不正确。 (9)

设备无法正常工作。 控制固件错误地报告设备的资源。

此设备无法启动。 (10)

设备无法启动。

此设备失败。 (11)

设备失败。

此设备找不到足够的可用资源，无法使用它。 (12)

设备找不到足够的可用资源来使用。

Windows无法验证此设备的资源。 ( 13)

Windows无法验证设备的资源。

在重新启动计算机之前，此设备无法正常工作。 (14)

设备在重启计算机之前无法正常工作。

此设备无法正常工作，因为可能存在重新枚举问题。 (15)

由于可能的重新枚举问题，设备无法正常工作。

Windows无法识别此设备使用的所有资源。 (16)

Windows无法识别设备使用的所有资源。

此设备请求未知资源类型。 (17)

设备正在请求未知资源类型。

重新安装此设备的驱动程序。 (18)

必须重新安装设备驱动程序。

使用 VxD 加载程序失败。 (19)

注册表可能已损坏。 (20)

注册表可能已损坏。

系统故障：尝试更改此设备的驱动程序。如果不起作用，请参阅硬件文档。Windows正在删除此设备。 (21)

系统故障。 如果更改设备驱动程序无效，请参阅硬件文档。 Windows正在删除设备。

此设备已禁用。 (22)

设备已禁用。

系统故障：尝试更改此设备的驱动程序。如果不起作用，请参阅硬件文档。 (23)

系统故障。 如果更改设备驱动程序无效，请参阅硬件文档。

此设备不存在、无法正常工作或未安装其所有驱动程序。 (24)

设备不存在、无法正常工作或未安装其所有驱动程序。

Windows仍在设置此设备。 ( 25)

Windows仍在设置设备。

Windows仍在设置此设备。 ( 26)

Windows仍在设置设备。

此设备没有有效的日志配置。 (27)

设备没有有效的日志配置。

未安装此设备的驱动程序。 (28)

未安装设备驱动程序。

此设备已禁用，因为设备的固件未为其提供所需的资源。 (29)

设备已禁用。 设备固件未提供所需的资源。

此设备使用另一台设备正在使用的中断请求 (IRQ) 资源。 (30)

设备正在使用另一台设备使用的 IRQ 资源。

此设备无法正常工作，因为Windows无法加载此设备所需的驱动程序。 ( 31)

设备无法正常工作。 Windows无法加载所需的设备驱动程序。

ConfigManagerUserConfig

数据类型： 布尔值

访问类型：只读

限定符： 架构 (“Win32”)

如果 为 TRUE，则设备使用用户定义的配置。

此属性继承自 CIM_LogicalDevice。

CreationClassName

数据类型： 字符串

访问类型：只读

限定符： CIM_Key

在创建实例时使用的继承链中显示的第一个具体类的名称。 与类的其他键属性一起使用时，该属性允许唯一标识此类及其子类的所有实例。

此属性继承自 CIM_LogicalDevice。

说明

数据类型： 字符串

访问类型：只读

限定符： DisplayName (“Description”)

对象的说明。

此属性继承自 CIM_ManagedSystemElement。

DeviceID

数据类型： 字符串

访问类型：只读

限定符： 密钥、 重写 (“DeviceId”) 、 MappingStrings (“WMI”)

即插即用设备的标识符。

此属性继承自 CIM_LogicalDevice。

ErrorCleared

数据类型： 布尔值

访问类型：只读

如果 为 TRUE，则现在清除 LastErrorCode 中报告的错误。

此属性继承自 CIM_LogicalDevice。

ErrorDescription

数据类型： 字符串

访问类型：只读

有关 LastErrorCode 中记录的错误的详细信息，以及可能采取的任何纠正措施的信息。

此属性继承自 CIM_LogicalDevice。

HardwareID

数据类型： 字符串 数组

访问类型：只读

安装程序用来将设备与 INF 文件匹配的供应商定义的标识字符串。 通常，设备具有硬件 ID 的关联列表。 例外是 1394 总线驱动程序，该驱动程序不使用硬件 ID。 列表中的第一个硬件 ID 应为设备 ID。 应列出剩余 ID，以降低适用性。

硬件 ID 以以下格式显示：

• enumerator\enumerator-specific-device-ID

  这是单个 PnP 设备最常见的格式。 枚举器的示例是 BIOS 或 ISAPNP。

• *枚举器特定的 ID

  星号 (*) 指示多个枚举器使用。

• 特定于 device-class 的 ID

  自定义格式。

硬件 ID 的示例包括：

root\\*PNPOF08

PC\\VEN\_1000&DEV\_001&SUBSYS\_0000000&REV\_02

有关详细信息，请参阅Windows驱动程序工具包。

InstallDate

数据类型： datetime

访问类型：只读

限定符： MappingStrings (“MIF。DMTF|ComponentID|001.5“) ， DisplayName (”安装日期“)

对象的安装日期和时间。 此属性不需要一个值来指示对象已安装。

此属性继承自 CIM_ManagedSystemElement。

LastErrorCode

数据类型： uint32

访问类型：只读

逻辑设备报告的最后一个错误代码。

此属性继承自 CIM_LogicalDevice。

Manufacturer

数据类型： 字符串

访问类型：只读

限定符： MappingStrings (“WMI”)

即插即用设备的制造商的名称。

示例：“Acme”

Name

数据类型： 字符串

访问类型：只读

限定符： DisplayName (“Name”)

对象的已知标签。 子类化时，可以将属性重写为键属性。

此属性继承自 CIM_ManagedSystemElement。

PNPClass

数据类型： 字符串

访问类型：只读

限定符： MappingStrings (“WMI”)

警告

尽管该属性在 MOF 文件中列出，但实际上不存在于类中。 此属性仅用于完整性，并澄清 MOF 文件本身。

 

此即插即用设备类型的名称。

Windows Server 2012 R2、Windows 8.1、Windows Server 2012、Windows 8、Windows Server 2008 R2、Windows 7、Windows Server 2008 和 Windows Vista：属性不在 MOF 文件中。

PNPDeviceID

数据类型： 字符串

访问类型：只读

限定符： 架构 (“Win32”)

Windows 即插即用逻辑设备的设备标识符。

此属性继承自 CIM_LogicalDevice。

示例：“*PNP030b”

PowerManagementCapabilities

数据类型： uint16 数组

访问类型：只读

未实现。

此属性继承自 CIM_LogicalDevice。

未知 (0)

与电源相关的容量未知。

不支持 (1)

此设备不支持与电源相关的容量。

已禁用 (2)

已禁用与电源相关的容量。

已启用 (3)

电源管理功能当前已启用，但确切的功能集未知或信息不可用。

自动输入的省电模式 (4)

设备可以根据使用情况或其他条件更改其电源状态。

Power State Settable (5)

支持 SetPowerState 方法。 此方法在父 CIM_LogicalDevice 类上找到，并且可以实现。 有关详细信息，请参阅 设计托管对象格式 (MOF) 类。

支持 (6) 的电源循环

可以使用 PowerState 参数设置为 5 (“Power Cycle”) 调用 SetPowerState 方法。

支持的计时电源 (7)

可以使用 PowerState 参数设置为 5 (“Power Cycle”) 调用 SetPowerState 方法，并将时间参数设置为特定的日期和时间或开机间隔。

PowerManagementSupported

数据类型： 布尔值

访问类型：只读

未实现。

此属性继承自 CIM_LogicalDevice。

Present

数据类型： 布尔值

访问类型：只读

限定符： MappingStrings (“WMI”)

此即插即用设备当前是否在系统中。

Windows Server 2012 R2、Windows 8.1、Windows Server 2012、Windows 8、Windows Server 2008 R2、Windows 7、Windows Server 2008 和 Windows Vista：不支持属性。

服务

数据类型： 字符串

访问类型：只读

限定符： MappingStrings (“WMI”)

支持此即插即用设备的服务的名称。 有关详细信息，请参阅 Win32_SystemDriverPnPEntity。

示例：“atapi”

Status

数据类型： 字符串

访问类型：只读

限定符： MaxLen (10) ， DisplayName (“Status”)

对象的当前状态。 可以定义各种操作和非操作状态。 操作状态包括：“OK”、“已降级”和“Pred Fail” (一个元素（如已启用 SMART 的硬盘驱动器）可能正常运行，但预测近期) 中的故障。 非操作状态包括：“Error”、“Starting”、“Stopping”和“Service”。 后者“服务”可以在对磁盘进行镜像重新加密、重新加载用户权限列表或其他管理工作期间应用。 并非所有此类工作都处于联机状态，但托管元素既不是“正常”，也不是在其他状态之一。

此属性继承自 CIM_ManagedSystemElement。

包括以下值：

确定 (“确定”)

错误 (“错误”)

降级 (“已降级”)

未知 (“未知”)

Pred Fail (“Pred Fail”)

启动 (“启动”)

停止 (“停止”)

服务 (“服务”)

(“强调 ”)

NonRecover (“NonRecover ”)

无联系人 (“无联系人”)

Lost Comm (“Lost Comm”)

StatusInfo

数据类型： uint16

访问类型：只读

限定符： MappingStrings (“MIF。DMTF|操作状态|003.3“)

逻辑设备的状态。 如果此属性不适用于逻辑设备，则应使用值 5 (不适用) 。

此属性继承自 CIM_LogicalDevice。

其他 (1)

未知 (2)

已启用 (3)

禁用 (4)

不适用 (5)

SystemCreationClassName

数据类型： 字符串

访问类型：只读

限定符： 传播 的 (“CIM_System。CreationClassName“) ， CIM_Key

范围计算机的 CreationClassName 属性的值。

此属性继承自 CIM_LogicalDevice。

SystemName

数据类型： 字符串

访问类型：只读

限定符： 传播 的 (“CIM_System。名称“) ， CIM_Key

范围系统的名称。

此属性继承自 CIM_LogicalDevice。

注解

Win32_PnPEntity类派生自 CIM_LogicalDevice。

示例

TechNet 库中 的Get-BrokenHardware.ps1 PowerShell 示例用于 Win32_PnPEntity 使用 WMI 检索非工作硬件的列表。

以下 VBScript 代码示例通过创建远程计算机名数组并在每台计算机上显示即插即用设备（Win32_PnPEntity实例）的名称，连接到同一域中的一组远程计算机。

On Error Resume Next 
arrComputers = Array("Computer1","Computer2","Computer3")
For Each strComputer In arrComputers
    WScript.Echo
    WScript.Echo "===================================="
    WScript.Echo "Computer: "& strComputer
    WScript.Echo "===================================="

    Set objWMIService = GetObject("winmgmts:\\" _
        & strComputer& "\root\CIMV2") 
    Set colItems = objWMIService.ExecQuery( _
        "SELECT * FROM Win32_PnPEntity",,48) 
    For Each objItem in colItems 
        Wscript.Echo "-----------------------------------"
        Wscript.Echo "Win32_PnPEntity instance"
        Wscript.Echo "-----------------------------------"
        Wscript.Echo "Name: "& objItem.Name
        Wscript.Echo "Status: "& objItem.Status
    Next
Next

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
命名空间	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

另请参阅

CIM_LogicalDevice

计算机系统硬件类

连接到远程计算机上的 WMI

WMI 任务：计算机硬件