Win32_Battery clase
La Win32_Batteryclase WMI representa una batería conectada al sistema informático.
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("{8502C4B9-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_Battery : CIM_Battery
{
uint16 Availability;
uint32 BatteryRechargeTime;
uint16 BatteryStatus;
string Caption;
uint16 Chemistry;
uint32 ConfigManagerErrorCode;
boolean ConfigManagerUserConfig;
string CreationClassName;
string Description;
uint32 DesignCapacity;
uint64 DesignVoltage;
string DeviceID;
boolean ErrorCleared;
string ErrorDescription;
uint16 EstimatedChargeRemaining;
uint32 EstimatedRunTime;
uint32 ExpectedBatteryLife;
uint32 ExpectedLife;
uint32 FullChargeCapacity;
datetime InstallDate;
uint32 LastErrorCode;
uint32 MaxRechargeTime;
string Name;
string PNPDeviceID;
uint16 PowerManagementCapabilities[];
boolean PowerManagementSupported;
string SmartBatteryVersion;
string Status;
uint16 StatusInfo;
string SystemCreationClassName;
string SystemName;
uint32 TimeOnBattery;
uint32 TimeToFullCharge;
};
Miembros
La clase Win32_Battery tiene estos tipos de miembros:
Métodos
La clase Win32_Battery tiene estos métodos.
| Método | Descripción |
|---|---|
| Reset | Sin implementar. Para implementar este método, consulte el método Reset en CIM_Battery para obtener documentación. |
| SetPowerState | Sin implementar. Para implementar este método, consulte el método SetPowerState en CIM_Battery para obtener documentación. |
Propiedades
La clase Win32_Battery 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.
BatteryRechargeTime
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
-
Calificadores: EN DESUSO, MappingStrings ("HKEY_LOCAL_MACHINE\\System\\CurrentControlSet\\Services|RechargeRate"), Unidades ("minutos")
Tiempo necesario para cargar completamente la batería. Esta propiedad no es compatible. BatteryRechargeTime no tiene una propiedad de reemplazo y ahora se considera obsoleta.
BatteryStatus
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("MIF. DMTF| Batería portátil|002.14")
Estado de la batería. El valor 10 (Sin definir) no es válido en el esquema CIM porque en DMI representa que no hay batería instalada. En este caso, no se debe crear una instancia del objeto .
Esta propiedad se hereda de CIM_Battery.
Otros (1)
La batería se está descargando.
Desconocido (2)
El sistema tiene acceso a CA, por lo que no se descarga ninguna batería. Sin embargo, la batería no está necesariamente cargando.
Totalmente cargado (3)
Bajo (4)
Crítico (5)
Carga (6)
Carga y alta (7)
Carga y baja (8)
Carga y crítica (9)
Sin definir (10)
Parcialmente cargado (11)
Caption
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: MaxLen (64), DisplayName ("Caption")
Descripción breve del objeto una cadena de una línea.
Esta propiedad se hereda de CIM_ManagedSystemElement.
Química
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("MIF. DMTF| Batería portátil|002.7")
Enumeración que describe la química de la batería.
Esta propiedad se hereda de CIM_Battery.
Otros (1)
Desconocido (2)
Ácido de plomo (3)
Cadmio de níquel (4)
Hidruro de metal de níquel (5)
Ion de litio (6)
Aire de zinc (7)
Polímero de litio (8)
ConfigManagerErrorCode
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
-
Calificadores: Esquema ("Win32")
Código de error de Windows 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.
DesignCapacity
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("MIF. DMTF| Batería portátil|002.8"), unidades ("miliwatt-hours")
Capacidad de diseño de la batería en miliwatt-hours. Si no se admite la propiedad, escriba 0 (cero).
Esta propiedad se hereda de CIM_Battery.
DesignVoltage
-
Tipo de datos: uint64
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("MIF. DMTF| Batería portátil|002.9"), unidades ("milivolts")
Voltaje de diseño de la batería en milivolts. Si no se admite el atributo, escriba 0 (cero).
Esta propiedad se hereda de CIM_Battery.
Para más información sobre el uso de valores uint64 en scripts, vea Scripting in WMI.
Deviceid
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: Clave, Invalidación ("DeviceId"), MappingStrings ("WMI")
Identifica la batería.
Esta propiedad se hereda de CIM_LogicalDevice.
Ejemplo: "Batería interna"
ErrorCleared
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
Si es True, ahora se borra el error notificado en la propiedad LastErrorCode .
Esta propiedad se hereda de CIM_LogicalDevice.
ErrorDescription
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
Cadena de forma libre que proporciona más información sobre el error registrado en la propiedad LastErrorCode e información sobre las acciones correctivas que se pueden realizar.
Esta propiedad se hereda de CIM_LogicalDevice.
EstimatedChargeRemaining
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
-
Calificadores: unidades ("porcentaje")
Estimación del porcentaje de cargo total restante.
Esta propiedad se hereda de CIM_Battery.
EstimatedRunTime
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("MIF. DMTF| Batería portátil|002.15"), unidades ("minutos")
Calcule en minutos el tiempo para agotar la carga de la batería en las condiciones de carga actuales si la energía de la utilidad está apagada, o se pierde y permanece apagada, o un portátil está desconectado de una fuente de alimentación.
Esta propiedad se hereda de CIM_Battery.
ExpectedBatteryLife
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
-
Calificadores: EN DESUSO, MappingStrings ("HKEY_LOCAL_MACHINE\\System\\CurrentControlSet\\Services|BatteryLife"), Unidades ("minutos")
Cantidad de tiempo que se tarda en purgar completamente la batería después de que se cargue por completo. Esta propiedad ya no se usa y se considera obsoleta.
ExpectedLife
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
-
Calificadores: unidades ("minutos")
La duración esperada de la batería en minutos, suponiendo que la batería esté totalmente cargada. La propiedad representa la duración total esperada de la batería, no su vida restante actual, que se indica mediante la propiedad EstimatedRunTime .
Esta propiedad se hereda de CIM_Battery.
FullChargeCapacity
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("MIF. DMTF| Batería portátil|002.11"), unidades ("miliwatt-hours")
Capacidad de carga completa de la batería en miliwatt-hours. La comparación del valor con la propiedad DesignCapacity determina cuándo la batería requiere reemplazo. El final de la duración de una batería suele ser cuando la propiedad FullChargeCapacity cae por debajo del 80 % de la propiedad DesignCapacity . Si no se admite la propiedad, escriba 0 (cero).
Esta propiedad se hereda de CIM_Battery.
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.
MaxRechargeTime
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
-
Calificadores: unidades ("minutos")
Tiempo máximo, en minutos, para cargar completamente la batería. La propiedad representa el tiempo para recargar una batería totalmente agotada, no el tiempo de carga restante actual, que se indica en la propiedad TimeToFullCharge .
Esta propiedad se hereda de CIM_Battery.
Nombre
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: DisplayName ("Name")
Define la 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.
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
Matriz de las funcionalidades específicas relacionadas con la energía de un dispositivo lógico.
Esta propiedad se hereda de CIM_LogicalDevice.
Desconocido (0)
No compatible (1)
Deshabilitado (2)
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 energía 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 CIM_LogicalDevice primaria y se puede implementar. Para más información, vea Diseño de clases de formato de Managed Object Format (MOF).
Power Cycling 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)
Se admiten Power-On con tiempo
El método SetPowerState se puede invocar con el parámetro PowerState establecido en 5 (Ciclo de energía) y Tiempo establecido en una fecha y hora específicas, o intervalo, para el encendido.
PowerManagementSupported
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
Si es True, el dispositivo se puede administrar con energía (se puede poner en modo de suspensión, etc.). La propiedad no indica que las características de administración de energía están habilitadas actualmente, solo que el dispositivo lógico es capaz de administrar energía.
Esta propiedad se hereda de CIM_LogicalDevice.
SmartBatteryVersion
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: MaxLen (64), MappingStrings ("MIF. DMTF| Batería portátil|002.10")
Número de versión de especificación de datos compatible con la batería. Si la batería no admite esta función, el valor debe dejarse en blanco.
Esta propiedad se hereda de CIM_Battery.
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 "Pred Fail" (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", "Starting", "Stopping" y "Service". Este último, "Servicio", podría aplicarse durante la reestablecimiento 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")
Pred Fail ("Pred Fail ")
Inicio ("Inicio")
Detención ("Detención ")
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.
TimeOnBattery
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
-
Calificadores: unidades ("segundos")
Tiempo transcurrido en segundos desde que el UPS del sistema informático cambió por última vez a la energía de la batería, o el tiempo desde que el sistema o UPS se reiniciaron por última vez, lo que sea menos. Si la batería es "en línea", se devuelve 0 (cero).
Esta propiedad se hereda de CIM_Battery.
TimeToFullCharge
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("MIF. DMTF| Batería portátil|002,16"), unidades ("minutos")
Tiempo restante para cargar la batería completamente en minutos a la velocidad de carga y el uso actuales.
Esta propiedad se hereda de CIM_Battery.
Comentarios
La clase Win32_Battery se deriva de CIM_Battery que se deriva de CIM_LogicalDevice.
Windows Server 2008 contiene los controladores UPS (APC) en el sistema operativo, lo que le permite tratar el UPS como una fuente de batería. Esto le permite supervisar el estado de UPS mediante un script y realizar acciones cuando sea necesario.
Ejemplos
El Toggle-Wireless.ps1 ejemplo de código de PowerShell consulta Win32_Battery para determinar si se alterna o no la red inalámbrica con el fin de ahorrar energía.
En el ejemplo Enumerar información de UPS Perl se muestra información sobre las fuentes de alimentación ininterrumpidas conectadas a un equipo.
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