Win32_PnPEntity clase
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
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 |
|
| Archivo DLL |
|
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de