Win32_PnPEntity 類別

發行項
11/10/2023

Win32_PnPEntity WMI 類別代表隨插即用裝置的屬性。隨插即用實體會顯示為位於控制台裝置管理員中的專案。

下列語法已經過受管理物件格式 (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|Operational State|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）

裝置無法正常運作，但可快速提供全電源。

電源週期 （16）

省電 - 警告 （17）

裝置處於警告狀態，不過也處於省電模式。

暫停（18）

裝置已暫停。

未就緒 （19）

裝置尚未就緒。

未設定 （20）

未設定裝置。

靜止（21）

裝置很安靜。

標題

數據類型：字串
存取類型：唯讀
限定符： MaxLen （64）， DisplayName （“Caption”）

對象的簡短描述。

此屬性繼承自 CIM_ManagedSystemElement。

ClassGuid

數據類型：字串
存取類型：唯讀
限定符： MappingStrings （“WMI”）

此隨插即用裝置的全域唯一標識碼（GUID）。

CompatibleID

數據類型：字串陣列
存取類型：唯讀

安裝程式用來比對裝置與 INF 檔案的廠商定義識別字串。裝置可以有與其相關聯的相容標識符清單。應列出相容的標識碼，以降低適用性。如果安裝程式找不到符合其中一個裝置硬體標識碼的 INF 檔案，它會使用相容的標識碼來尋找 INF 檔案。相容的標識碼與 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 檔案的廠商定義識別字串。一般而言，裝置具有相關聯的硬體標識符清單。例外狀況是 1394 總線驅動程式，不會使用硬體識別碼。清單中的第一個硬體標識碼應該是裝置標識碼。其餘標識碼應以降低適用性的順序列出。

硬體識別子會以下欄其中一種格式顯示：

enumerator\enumerator-specific-device-ID

這是個別 PnP 裝置最常見的格式。列舉值的範例是 BIOS 或 ISAPNP。
*列舉值特定標識符

星號 \ 表示由一個以上的列舉值使用。
device-class-specific 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。

製造商

數據類型：字串
存取類型：唯讀
限定符： MappingStrings （“WMI”）

隨插即用裝置製造商的名稱。

範例：“Acme”

名稱

數據類型：字串
存取類型：唯讀
限定符： 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 類別上，而且可以實作。如需詳細資訊，請參閱設計 Managed 物件格式（MOF）類別。

支援電源迴圈（6）

您可以使用設定為 5 （“Power Cycle” 的 PowerState 參數來叫用 SetPowerState 方法。

支援的 計時電源（7）

您可以叫用 SetPowerState 方法，並將 PowerState 參數設定為 5 （“Power Cycle”）且 Time 參數設定為特定日期和時間或間隔以開啟電源。

PowerManagementSupported

數據類型： 布爾值
存取類型：唯讀

未實作。

此屬性繼承自 CIM_LogicalDevice。

目前

數據類型： 布爾值
存取類型：唯讀
限定符： 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”

狀態

數據類型：字串
存取類型：唯讀
限定符： MaxLen （10）， DisplayName （“Status”）

物件的目前狀態。您可以定義各種操作和非操作狀態。作業狀態包括：「OK」、「已降級」和「Pred Fail」（智慧型硬碟等元素可能正常運作，但預測近期失敗）。非操作狀態包括：“Error”、“Starting”、“Stopping” 和 “Service”。後者「服務」可以在磁碟的鏡像重新Silvering、重載用戶權力清單或其他系統管理工作期間套用。並非所有這類工作都在在線，但 Managed 元素既不是「確定」，也不是在其他其中一個狀態。

此屬性繼承自 CIM_ManagedSystemElement。

包括下列值：

確定（“OK”）

錯誤（「錯誤」

已降級 （「已降級」

未知（“未知”）

Pred Fail （“Pred Fail”）

啟動（“開始”）

停止（“停止”）

服務（“Service”）

壓力（“壓力”）

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。

範例

下列 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
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

另請參閱

CIM_LogicalDevice
計算機系統硬體類別
連線遠端電腦上的 WMI
WMI 工作：計算機硬體

共用方式為

Win32_PnPEntity 類別

語法

成員

方法

屬性

備註

範例

需求

另請參閱

意見反應

其他資源