класс Win32_PnPEntity

Статья
06/12/2023

Класс WMIWin32_PnPEntity представляет свойства устройства Plug and Play. Plug and Play сущности отображаются в виде записей в диспетчер устройств, расположенном в панель управления.

Следующий пример синтаксиса — упрощенный 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 содержит следующие методы.

Метод	Описание
Отключить	Отключает это Plug and Play устройство.
Включить	Включает это Plug and Play устройство.
GetDeviceProperties	Возвращает указанные свойства этого Plug and Play устройства.
Сброс	Не реализован. Чтобы реализовать этот метод, см. метод Reset в CIM_LogicalDevice.
SetPowerState	Не реализован. Чтобы реализовать этот метод, см. метод SetPowerState в CIM_LogicalDevice.

Свойства

Класс Win32_PnPEntity имеет эти свойства.

Доступность

Тип данных: uint16
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("MIF. DMTF| Рабочее состояние|003.5", "MIB. IETF| HOST-RESOURCES-MIB.hrDeviceStatus")

Доступность и состояние устройства.

Это свойство наследуется от CIM_LogicalDevice.

Другое (1)

Неизвестно (2)

Работа и полная мощность (3)

Запуск или полная мощность

Предупреждение (4)

В тесте (5)

Неприменимо (6)

Выключение питания (7)

Off Line (8)

Off Duty (9)

Понижение производительности (10)

Не установлено (11)

Ошибка установки (12)

Power Save — неизвестно (13)

Известно, что устройство находится в режиме экономии энергии, но его точное состояние неизвестно.

Экономия энергии — режим низкого энергопотребления (14)

Устройство находится в состоянии экономии энергии, но по-прежнему работает и может демонстрировать снижение производительности.

Экономия энергии в режиме ожидания (15)

Устройство не работает, но может быть приведено в полную мощность быстро.

Цикл питания (16)

Экономия энергии — предупреждение (17)

Устройство находится в состоянии предупреждения, хотя и в режиме экономии энергии.

Приостановлено (18)

Устройство приостановлено.

Не готово (19)

Устройство не готово.

Не настроено (20)

Устройство не настроено.

Притормоенная (21)

Устройство работает тихо.

Caption

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MaxLen (64), DisplayName ("Caption")

Краткое описание объекта.

Это свойство наследуется от CIM_ManagedSystemElement.

ClassGuid

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("WMI")

Глобальный уникальный идентификатор (GUID) этого Plug and Play устройства.

Совместимый ИДЕНТИФИКАТОР

Тип данных: строковый массив
Тип доступа: только для чтения

Определяемая поставщиком идентификационная строка, которую программа установки использует для сопоставления устройства с INF-файлом. У устройства может быть список совместимых кодов, связанных с ним. Совместимые идентификаторы должны быть перечислены в порядке уменьшения пригодности. Если программа установки не может найти INF-файл, соответствующий одному из идентификаторов оборудования устройства, она использует совместимые идентификаторы для поиска INF-файла. Совместимый идентификатор имеет тот же формат, что и HardwareID. Дополнительные сведения см. в разделе Комплект драйверов Для Windows.

ConfigManagerErrorCode

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: Схема ("Win32")

Код ошибки Configuration Manager Win32.

Это свойство наследуется от 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

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: Schema ("Win32")

Если задано значение TRUE, устройство использует определяемую пользователем конфигурацию.

Это свойство наследуется от CIM_LogicalDevice.

CreationClassName

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: CIM_Key

Имя первого конкретного класса, отображаемого в цепочке наследования, используемой при создании экземпляра. При использовании с другими ключевыми свойствами класса свойство позволяет уникально идентифицировать все экземпляры этого класса и его подклассы.

Это свойство наследуется от CIM_LogicalDevice.

Описание

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: DisplayName ("Описание")

Описание объекта.

Это свойство наследуется от CIM_ManagedSystemElement.

DeviceID

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: Key, Override ("DeviceId"), MappingStrings ("WMI")

Идентификатор устройства Plug and Play.

Это свойство наследуется от CIM_LogicalDevice.

ErrorCleared

Тип данных: boolean
Тип доступа: только для чтения

Если задано значение TRUE, ошибка, обнаруженная в LastErrorCode , теперь удаляется.

Это свойство наследуется от CIM_LogicalDevice.

ErrorDescription

Тип данных: string
Тип доступа: только для чтения

Дополнительные сведения об ошибке, записанной в LastErrorCode, и сведения о любых корректирующих действиях, которые могут быть предприняты.

Это свойство наследуется от CIM_LogicalDevice.

HardwareID

Тип данных: строковый массив
Тип доступа: только для чтения

Определяемая поставщиком строка идентификации, которую программа установки использует для сопоставления устройства с INF-файлом. Обычно устройство имеет связанный список идентификаторов оборудования. Исключением является драйвер шины 1394, который не использует идентификаторы оборудования. Первым идентификатором оборудования в списке должен быть идентификатор устройства. Остальные идентификаторы должны быть перечислены в порядке уменьшения пригодности.

Идентификаторы оборудования отображаются в одном из следующих форматов:

enumerator\enumerator-specific-device-ID

Это наиболее распространенный формат для отдельных устройств PnP. Пример перечислителя — BIOS или ISAPNP.
*идентификатор, зависящий от перечислителя

Звездочка (*) указывает на использование несколькими перечислителями.
идентификатор, зависящий от класса устройства

Пользовательский формат.

Примеры идентификаторов оборудования:

root\\\*PNPOF08

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

Дополнительные сведения см. в разделе Комплект драйверов Для Windows.

InstallDate

Тип данных: datetime
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Дата установки")

Дата и время установки объекта. Этому свойству не требуется значение, указывающее, что объект установлен.

Это свойство наследуется от CIM_ManagedSystemElement.

LastErrorCode

Тип данных: uint32
Тип доступа: только для чтения

Последний код ошибки, сообщаемый логическим устройством.

Это свойство наследуется от CIM_LogicalDevice.

Производителя

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("WMI")

Имя изготовителя Plug and Play устройства.

Пример: "Acme"

имя;

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: DisplayName ("Имя")

Метка, по которой известен объект. При создании подкласса свойство может быть переопределено как ключевое свойство.

Это свойство наследуется от CIM_ManagedSystemElement.

PNPClass

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("WMI")

Предупреждение

Это свойство, несмотря на то, что оно указано в MOF-файле, фактически не существует в классе . Свойство описывается здесь только для полноты и для уточнения самого MOF-файла.

Имя типа этого Plug and Play устройства.

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

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: Schema ("Win32")

Windows Plug and Play идентификатор логического устройства.

Это свойство наследуется от CIM_LogicalDevice.

Пример: "*PNP030b"

PowerManagementCapabilities

Тип данных: массив uint16
Тип доступа: только для чтения

Не реализован.

Это свойство наследуется от CIM_LogicalDevice.

Неизвестно (0)

Мощности, связанные с питанием, неизвестны.

Не поддерживается (1)

Емкости, связанные с питанием, не поддерживаются для этого устройства.

Отключено (2)

Емкости, связанные с питанием, отключены.

Включено (3)

Функции управления питанием в настоящее время включены, но точный набор функций неизвестен или информация недоступна.

Режимы энергосбережения, введенные автоматически (4)

Устройство может изменять состояние питания в зависимости от использования или других критериев.

Power State Settable (5)

Поддерживается метод SetPowerState . Этот метод находится в родительском CIM_LogicalDevice классе и может быть реализован. Дополнительные сведения см. в разделе Designing Managed Object Format (MOF) Classes.

Поддерживается цикличность питания (6)

Метод SetPowerState можно вызвать с параметром PowerState, равным 5 ("Цикл питания").

Поддержка включения по времени (7)

Метод SetPowerState можно вызвать с параметром PowerState , равным 5 ("Цикл питания"), а параметр Time — определенной датой и временем или интервалом для включения питания.

PowerManagementSupported

Тип данных: boolean
Тип доступа: только для чтения

Не реализован.

Это свойство наследуется от CIM_LogicalDevice.

Настоящее время

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("WMI")

Указывает, находится ли это Plug and Play устройство в настоящее время в системе.

Windows Server 2012 R2, Windows 8.1, Windows Server 2012, Windows 8, Windows Server 2008 R2, Windows 7, Windows Server 2008 и Windows Vista: это свойство не поддерживается.

Служба

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("WMI")

Имя службы, поддерживающей этот Plug and Play устройство. Дополнительные сведения см. в разделе Win32_SystemDriverPnPEntity.

Пример: "atapi"

Состояние

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MaxLen (10), DisplayName ("Status")

Текущее состояние объекта. Можно определить различные операционные и нерабочие состояния. Операционные состояния: "ОК", "Понижено" и "Сбой pred" (элемент, например жесткий диск с поддержкой SMART, может работать правильно, но прогнозирует сбой в ближайшем будущем). К нерабочим состояниям относятся: "Ошибка", "Запуск", "Остановка" и "Служба". Последняя служба может применяться во время зеркало повторного изменения диска, перезагрузки списка разрешений пользователя или других административных действий. Не вся такая работа находится в сети, но управляемый элемент не является ни "ОК", ни в одном из других состояний.

Это свойство наследуется от CIM_ManagedSystemElement.

В эти значения входят:

ОК ("ОК")

Error ("Error")

Пониженный ("Пониженный")

Unknown ("Unknown")

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

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: распространяется ("CIM_System. CreationClassName"), CIM_Key

Значение свойства CreationClassName компьютера области.

Это свойство наследуется от CIM_LogicalDevice.

SystemName

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: распространяется ("CIM_System. Name"), CIM_Key

Имя системы определения области.

Это свойство наследуется от CIM_LogicalDevice.

Примеры

Пример Get-BrokenHardware.ps1 PowerShell в коллекции TechNet использует для Win32_PnPEntity для получения списка неработающего оборудования с помощью инструментария WMI.

В следующем примере кода VBScript выполняется подключение к группе удаленных компьютеров в том же домене путем создания массива имен удаленных компьютеров, а затем отображения имен Plug and Play устройств (экземпляров 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: оборудование компьютера

класс Win32_PnPEntity

Синтаксис

Члены

Методы

Свойства

Комментарии

Примеры

Требования

См. также раздел

Обратная связь

Обратная связь

Дополнительные ресурсы