Win32_PnPEntity clase

Artículo
06/12/2023

LaWin32_PnPEntity clase WMI representa las propiedades de un dispositivo Plug and Play. Plug and Play entidades se muestran como entradas en el Administrador de dispositivos ubicado en Panel de control.

La siguiente sintaxis se simplifica desde el código de Managed Object Format (MOF) e incluye todas las propiedades heredadas. Las propiedades se enumeran en orden alfabético, no en orden MOF.

Sintaxis

[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;
};

Miembros

La clase Win32_PnPEntity tiene estos tipos de miembros:

Métodos
Propiedades

Métodos

La clase Win32_PnPEntity tiene estos métodos.

Método	Descripción
Desactivar	Deshabilita este dispositivo Plug and Play.
Habilitar	Habilita este dispositivo Plug and Play.
GetDeviceProperties	Obtiene las propiedades especificadas de este dispositivo Plug and Play.
Reset	Sin implementar. Para implementar este método, consulte el método Reset en CIM_LogicalDevice.
SetPowerState	Sin implementar. Para implementar este método, consulte el método SetPowerState en CIM_LogicalDevice.

Propiedades

La clase Win32_PnPEntity tiene estas propiedades.

Disponibilidad

Tipo de datos: uint16
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("MIF. DMTF| Estado operativo|003.5", "MIB. IETF| HOST-RESOURCES-MIB.hrDeviceStatus")

Disponibilidad y estado del dispositivo.

Esta propiedad se hereda de CIM_LogicalDevice.

Otros (1)

Desconocido (2)

Corriente/potencia completa (3)

Ejecución o energía completa

Advertencia (4)

En prueba (5)

No aplicable (6)

Apagado (7)

Off Line (8)

Off Duty (9)

Degradado (10)

No instalado (11)

Error de instalación (12)

Ahorro de energía : desconocido (13)

Se sabe que el dispositivo está en modo de ahorro de energía, pero su estado exacto es desconocido.

Ahorro de energía - Modo de bajo consumo (14)

El dispositivo está en un estado de ahorro de energía, pero sigue funcionando, y puede mostrar un rendimiento degradado.

Ahorro de energía : en espera (15)

El dispositivo no funciona, pero se podría traer rápidamente a toda la potencia.

Ciclo de alimentación (16)

Ahorro de energía: advertencia (17)

El dispositivo está en un estado de advertencia, aunque también en modo de ahorro de energía.

En pausa (18)

El dispositivo está en pausa.

No listo (19)

El dispositivo no está listo.

No configurado (20)

El dispositivo no está configurado.

En modo en modo incoado (21)

El dispositivo es silencioso.

Caption

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MaxLen (64), DisplayName ("Caption")

Descripción breve del objeto.

Esta propiedad se hereda de CIM_ManagedSystemElement.

ClassGuid

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("WMI")

Identificador único global (GUID) de este dispositivo Plug and Play.

CompatibleID

Tipo de datos: matriz de cadenas
Tipo de acceso: solo lectura

Cadena de identificación definida por el proveedor que el programa de instalación usa para hacer coincidir un dispositivo con un archivo INF. Un dispositivo puede tener una lista de identificadores compatibles asociados. Los identificadores compatibles deben aparecer en orden de disminución de la idoneidad. Si el programa de instalación no encuentra un archivo INF que coincida con uno de los identificadores de hardware de un dispositivo, usa identificadores compatibles para buscar un archivo INF. Un identificador compatible tiene el mismo formato que un HardwareID. Para obtener más información, consulte Kit de controladores de Windows.

ConfigManagerErrorCode

Tipo de datos: uint32
Tipo de acceso: solo lectura
Calificadores: Esquema ("Win32")

Código de error de win32 Configuration Manager.

Esta propiedad se hereda de CIM_LogicalDevice.

Este dispositivo funciona correctamente. (0)

El dispositivo funciona correctamente.

Este dispositivo no está configurado correctamente. (1)

El dispositivo no está configurado correctamente.

Windows no puede cargar el controlador para este dispositivo. (2)

Es posible que el controlador de este dispositivo esté dañado o que el sistema se esté ejecutando poco en memoria u otros recursos. (3)

Es posible que el controlador de este dispositivo esté dañado o que el sistema tenga poca memoria u otros recursos.

Este dispositivo no funciona correctamente. Uno de sus controladores o el registro podrían estar dañados. (4)

El dispositivo no funciona correctamente. Uno de sus controladores o el registro podrían estar dañados.

El controlador de este dispositivo necesita un recurso que Windows no puede administrar. (5)

El controlador para el dispositivo requiere un recurso que Windows no puede administrar.

La configuración de arranque de este dispositivo entra en conflicto con otros dispositivos. (6)

La configuración de arranque del dispositivo entra en conflicto con otros dispositivos.

No se puede filtrar. (7)

Falta el cargador de controladores para el dispositivo. (8)

Falta el cargador de controladores para el dispositivo.

Este dispositivo no funciona correctamente porque el firmware de control notifica los recursos del dispositivo incorrectamente. (9)

El dispositivo no funciona correctamente. El firmware de control informa incorrectamente de los recursos del dispositivo.

Este dispositivo no se puede iniciar. (10)

El dispositivo no se puede iniciar.

Error en este dispositivo. (11)

Error en el dispositivo.

Este dispositivo no encuentra suficientes recursos libres que puede usar. (12)

El dispositivo no encuentra suficientes recursos gratuitos para usar.

Windows no puede comprobar los recursos de este dispositivo. (13)

Windows no puede comprobar los recursos del dispositivo.

Este dispositivo no puede funcionar correctamente hasta que reinicie el equipo. (14)

El dispositivo no puede funcionar correctamente hasta que se reinicie el equipo.

Este dispositivo no funciona correctamente porque probablemente haya un problema de volver a enumerar. (15)

El dispositivo no funciona correctamente debido a un posible problema de volver a enumerar.

Windows no puede identificar todos los recursos que usa este dispositivo. (16)

Windows no puede identificar todos los recursos que usa el dispositivo.

Este dispositivo solicita un tipo de recurso desconocido. (17)

El dispositivo solicita un tipo de recurso desconocido.

Vuelva a instalar los controladores para este dispositivo. (18)

Los controladores de dispositivo deben volver a instalarse.

Error al usar el cargador VxD. (19)

Es posible que el registro esté dañado. (20)

Es posible que el Registro esté dañado.

Error del sistema: intente cambiar el controlador de este dispositivo. Si eso no funciona, consulte la documentación de hardware. Windows está quitando este dispositivo. (21)

Error del sistema. Si cambiar el controlador de dispositivo es ineficaz, consulte la documentación de hardware. Windows está quitando el dispositivo.

Este dispositivo está deshabilitado. (22)

El dispositivo está deshabilitado.

Error del sistema: intente cambiar el controlador de este dispositivo. Si eso no funciona, consulte la documentación de hardware. (23)

Error del sistema. Si cambiar el controlador de dispositivo es ineficaz, consulte la documentación de hardware.

Este dispositivo no está presente, no funciona correctamente o no tiene instalados todos sus controladores. (24)

El dispositivo no está presente, no funciona correctamente o no tiene todos sus controladores instalados.

Windows sigue configurando este dispositivo. (25)

Windows sigue configurando el dispositivo.

Windows sigue configurando este dispositivo. (26)

Windows sigue configurando el dispositivo.

Este dispositivo no tiene una configuración de registro válida. (27)

El dispositivo no tiene una configuración de registro válida.

Los controladores de este dispositivo no están instalados. (28)

Los controladores de dispositivo no están instalados.

Este dispositivo está deshabilitado porque el firmware del dispositivo no le dio los recursos necesarios. (29)

El dispositivo está deshabilitado. El firmware del dispositivo no proporcionó los recursos necesarios.

Este dispositivo usa un recurso de solicitud de interrupción (IRQ) que usa otro dispositivo. (30)

El dispositivo usa un recurso IRQ que usa otro dispositivo.

Este dispositivo no funciona correctamente porque Windows no puede cargar los controladores necesarios para este dispositivo. (31)

El dispositivo no funciona correctamente. Windows no puede cargar los controladores de dispositivo necesarios.

ConfigManagerUserConfig

Tipo de datos: booleano
Tipo de acceso: solo lectura
Calificadores: Esquema ("Win32")

Si es TRUE, el dispositivo usa una configuración definida por el usuario.

Esta propiedad se hereda de CIM_LogicalDevice.

CreationClassName

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: CIM_Key

Nombre de la primera clase concreta que aparece en la cadena de herencia utilizada en la creación de una instancia. Cuando se usa con las otras propiedades clave de la clase , la propiedad permite identificar de forma única todas las instancias de esta clase y sus subclases.

Esta propiedad se hereda de CIM_LogicalDevice.

Descripción

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: DisplayName ("Descripción")

Descripción del objeto .

Esta propiedad se hereda de CIM_ManagedSystemElement.

Deviceid

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: Clave, Invalidación ("DeviceId"), MappingStrings ("WMI")

Identificador del dispositivo Plug and Play.

Esta propiedad se hereda de CIM_LogicalDevice.

ErrorCleared

Tipo de datos: booleano
Tipo de acceso: solo lectura

Si es TRUE, el error notificado en LastErrorCode ahora se borra.

Esta propiedad se hereda de CIM_LogicalDevice.

ErrorDescription

Tipo de datos: cadena
Tipo de acceso: solo lectura

Más información sobre el error registrado en LastErrorCode e información sobre las acciones correctivas que se pueden realizar.

Esta propiedad se hereda de CIM_LogicalDevice.

HardwareID

Tipo de datos: matriz de cadenas
Tipo de acceso: solo lectura

Cadena de identificación definida por el proveedor que el programa de instalación usa para hacer coincidir un dispositivo con un archivo INF. Normalmente, un dispositivo tiene una lista asociada de identificadores de hardware. Una excepción es el controlador de bus 1394, que no usa identificadores de hardware. El primer identificador de hardware de la lista debe ser el identificador de dispositivo. Los identificadores restantes deben aparecer en orden de disminución de la idoneidad.

Los identificadores de hardware aparecen en uno de los siguientes formatos:

enumerator\enumerator-specific-device-ID

Este es el formato más común para dispositivos PnP individuales. Un ejemplo de enumerador es el BIOS o ISAPNP.
*id. específico del enumerador

Un asterisco (*) indica el uso de más de un enumerador.
id. específico de clase de dispositivo

Un formato personalizado.

Algunos ejemplos de identificadores de hardware son:

root\\\*PNPOF08

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

Para obtener más información, consulta el Kit de controladores de Windows.

InstallDate

Tipo de datos: datetime
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Fecha de instalación")

Fecha y hora en que se instaló el objeto. Esta propiedad no necesita un valor para indicar que el objeto está instalado.

Esta propiedad se hereda de CIM_ManagedSystemElement.

LastErrorCode

Tipo de datos: uint32
Tipo de acceso: solo lectura

Último código de error notificado por el dispositivo lógico.

Esta propiedad se hereda de CIM_LogicalDevice.

Fabricante

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("WMI")

Nombre del fabricante del dispositivo Plug and Play.

Ejemplo: "Acme"

Nombre

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: DisplayName ("Name")

Etiqueta por la que se conoce el objeto. Cuando se subclase, la propiedad se puede invalidar para que sea una propiedad de clave.

Esta propiedad se hereda de CIM_ManagedSystemElement.

PNPClass

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("WMI")

Advertencia

Esta propiedad, a pesar de aparecer en el archivo MOF, no existe realmente en la clase . La propiedad se describe aquí solo por motivos de integridad y para aclarar el propio archivo MOF.

Nombre del tipo de este dispositivo Plug and Play.

Windows Server 2012 R2, Windows 8.1, Windows Server 2012, Windows 8, Windows Server 2008 R2, Windows 7, Windows Server 2008 y Windows Vista: esta propiedad no está en el archivo MOF.

PNPDeviceID

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: Esquema ("Win32")

Windows Plug and Play identificador de dispositivo del dispositivo lógico.

Esta propiedad se hereda de CIM_LogicalDevice.

Ejemplo: "*PNP030b"

PowerManagementCapabilities

Tipo de datos: matriz uint16
Tipo de acceso: solo lectura

Sin implementar.

Esta propiedad se hereda de CIM_LogicalDevice.

Desconocido (0)

Las capacidades relacionadas con la potencia son desconocidas.

No compatible (1)

Las capacidades relacionadas con la energía no se admiten para este dispositivo.

Deshabilitado (2)

Se han deshabilitado las capacidades relacionadas con la energía.

Habilitado (3)

Las características de administración de energía están habilitadas actualmente, pero el conjunto de características exacto es desconocido o la información no está disponible.

Modos de ahorro de energía introducidos automáticamente (4)

El dispositivo puede cambiar su estado de alimentación en función del uso u otros criterios.

Power State Settable (5)

Se admite el método SetPowerState . Este método se encuentra en la clase primaria CIM_LogicalDevice y se puede implementar. Para más información, vea Diseño de clases de formato de Managed Object Format (MOF).

Power Cycle Supported (6)

El método SetPowerState se puede invocar con el parámetro PowerState establecido en 5 ("Ciclo de energía").

Encendido con tiempo admitido (7)

El método SetPowerState se puede invocar con el parámetro PowerState establecido en 5 ("Ciclo de energía") y el parámetro Time establecido en una fecha y hora específicas, o intervalo, para el encendido.

PowerManagementSupported

Tipo de datos: booleano
Tipo de acceso: solo lectura

Sin implementar.

Esta propiedad se hereda de CIM_LogicalDevice.

Presente

Tipo de datos: booleano
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("WMI")

Si este dispositivo Plug and Play está actualmente en el sistema.

Windows Server 2012 R2, Windows 8.1, Windows Server 2012, Windows 8, Windows Server 2008 R2, Windows 7, Windows Server 2008 y Windows Vista: esta propiedad no se admite.

Servicio

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("WMI")

Nombre del servicio que admite este dispositivo Plug and Play. Para obtener más información, consulte Win32_SystemDriverPnPEntity.

Ejemplo: "atapi"

Estado

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MaxLen (10), DisplayName ("Status")

Estado actual del objeto. Se pueden definir varios estados operativos y no operativos. Los estados operativos incluyen: "Ok", "Degradado" y "Error previo" (un elemento, como una unidad de disco duro habilitada para SMART, puede funcionar correctamente, pero predecir un error en un futuro próximo). Los estados no operativos incluyen: "Error", "Inicio", "Detención" y "Servicio". Este último, "Servicio", podría aplicarse durante la resilveración de reflejo de un disco, la recarga de una lista de permisos de usuario u otro trabajo administrativo. No todo este trabajo está en línea, pero el elemento administrado no es "CORRECTO" ni en uno de los otros estados.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Los valores son los siguientes:

Ok ("OK")

Error ("Error")

Degradado ("Degradado")

Desconocido ("Desconocido")

Error previo ("Error previo")

Inicio ("Inicio")

Detener ("Detener")

Servicio ("Servicio")

Estresado ("Estresado")

NonRecover ("NonRecover")

Sin contacto ("Sin contacto")

Lost Comm ("Lost Comm")

StatusInfo

Tipo de datos: uint16
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("MIF. DMTF| Estado operativo|003.3")

Estado del dispositivo lógico. Si esta propiedad no se aplica al dispositivo lógico, se debe usar el valor 5 (no aplicable).

Esta propiedad se hereda de CIM_LogicalDevice.

Otros (1)

Desconocido (2)

Habilitado (3)

Deshabilitado (4)

No aplicable (5)

SystemCreationClassName

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: propagados ("CIM_System. CreationClassName"), CIM_Key

Valor de la propiedad CreationClassName del equipo de ámbito.

Esta propiedad se hereda de CIM_LogicalDevice.

SystemName

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: propagados ("CIM_System. Nombre"), CIM_Key

Nombre del sistema de ámbito.

Esta propiedad se hereda de CIM_LogicalDevice.

Comentarios

La clase Win32_PnPEntity se deriva de CIM_LogicalDevice.

Ejemplos

El ejemplo deGet-BrokenHardware.ps1 de PowerShell en la Galería de TechNet usa para Win32_PnPEntity para recuperar una lista de hardware que no funciona mediante WMI.

El siguiente ejemplo de código VBScript se conecta a un grupo de equipos remotos en el mismo dominio mediante la creación de una matriz de nombres de equipo remotos y, a continuación, se muestran nombres de los dispositivos Plug and Play(instancias de Win32_PnPEntity) en cada equipo.

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

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Espacio de nombres	Root\CIMV2
MOF	CIMWin32.mof
Archivo DLL	CIMWin32.dll

Consulte también

CIM_LogicalDevice
Clases de hardware del sistema de equipos
Conexión a WMI en un equipo remoto
Tareas de WMI: hardware del equipo

Compartir a través de

Win32_PnPEntity clase

Sintaxis

Miembros

Métodos

Propiedades

Comentarios

Ejemplos

Requisitos

Consulte también

Comentarios

Recursos adicionales