CIM_Battery clase
La clase CIM_Battery representa las funcionalidades y la administración del dispositivo lógico de la batería. Esta clase se aplica a baterías en sistemas portátiles y otras baterías internas y externas.
Importante
Las clases CIM (Grupo de tareas de administración distribuida) DMTF (Common Information Model) son las clases primarias en las que se compilan las clases WMI. WMI actualmente solo admite los esquemas de versión cim 2.x.
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
[Abstract, UUID("{8502C548-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class CIM_Battery : CIM_LogicalDevice
{
string Caption;
string Description;
datetime InstallDate;
string Name;
string Status;
uint16 Availability;
uint32 ConfigManagerErrorCode;
boolean ConfigManagerUserConfig;
string CreationClassName;
string DeviceID;
uint16 PowerManagementCapabilities[];
boolean ErrorCleared;
string ErrorDescription;
uint32 LastErrorCode;
string PNPDeviceID;
boolean PowerManagementSupported;
uint16 StatusInfo;
string SystemCreationClassName;
string SystemName;
uint16 BatteryStatus;
uint16 Chemistry;
uint32 DesignCapacity;
uint64 DesignVoltage;
uint16 EstimatedChargeRemaining;
uint32 EstimatedRunTime;
uint32 ExpectedLife;
uint32 FullChargeCapacity;
uint32 MaxRechargeTime;
string SmartBatteryVersion;
uint32 TimeOnBattery;
uint32 TimeToFullCharge;
};
Miembros
La clase CIM_Battery tiene estos tipos de miembros:
Métodos
La clase CIM_Battery tiene estos métodos.
| Método | Descripción |
|---|---|
| Restablecer | Solicita un restablecimiento del dispositivo lógico. No implementado por WMI. |
| SetPowerState | Define el estado de energía deseado para un dispositivo lógico y cuándo se debe colocar el dispositivo en ese estado. No implementado por WMI. |
Propiedades
La clase CIM_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)
-
Advertencia (4)
-
En prueba (5)
-
No aplicable (6)
-
Apagar (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 podría traerse a toda la potencia rápidamente.
-
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.
-
Sin configurar (20)
-
El dispositivo no está configurado.
-
En modo in quiesco (21)
-
El dispositivo es silencioso.
BatteryStatus
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("MIF. DMTF| Batería portátil|002.14")
Descripción del estado de carga de la batería. El valor 10 no es válido en el esquema CIM, que representa que no se instala ninguna batería en la Interfaz de administración de escritorio (DMI). En este caso, no se debe crear una instancia del objeto.
Otros (1)
Otros.
Desconocido (2)
desconocida.
Totalmente cargado (3)
Se cobra por completo.
Bajo (4)
Baja.
Crítico (5)
Crítico.
Carga (6)
Carga.
Carga y alta (7)
Carga y alta.
Carga y baja (8)
Carga y baja.
Carga y crítica (9)
Carga y crítica.
Sin definir (10)
Sin definir.
Parcialmente cargado (11)
Se cobra parcialmente.
Caption
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: MaxLen (64), DisplayName ("Caption")
Una breve descripción textual del objeto.
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.
Otros (1)
Otros.
Desconocido (2)
desconocida.
Ácido de plomo (3)
Plomo.
Cadmio de níquel (4)
Níquel-cadmio.
Hidruro de metal de níquel (5)
Hidruro de metal de níquel.
Ion de litio (6)
Ion de litio.
Aire de zinc (7)
Aire de zinc.
Polímero de litio (8)
Polímero de litio.
ConfigManagerErrorCode
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
-
Calificadores: Esquema ("Win32")
Win32 Configuration Manager código de error.
Esta propiedad se hereda de CIM_LogicalDevice.
Este dispositivo funciona correctamente. (0)
Este dispositivo no está configurado correctamente. (1)
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)
Este dispositivo no funciona correctamente. Uno de sus controladores o el registro podrían estar dañados. (4)
El controlador de este dispositivo necesita un recurso que Windows no puede administrar. (5)
La configuración de arranque de este dispositivo entra en conflicto con otros dispositivos. (6)
No se puede filtrar. (7)
Falta el cargador de controladores para el dispositivo. (8)
Este dispositivo no funciona correctamente porque el firmware de control notifica los recursos del dispositivo incorrectamente. (9)
Este dispositivo no se puede iniciar. (10)
Error en este dispositivo. (11)
Este dispositivo no encuentra suficientes recursos gratuitos que puede usar. (12)
Windows no puede comprobar los recursos de este dispositivo. (13)
Este dispositivo no puede funcionar correctamente hasta que reinicie el equipo. (14)
Este dispositivo no funciona correctamente porque probablemente haya un problema de volver a enumerar. (15)
Windows no puede identificar todos los recursos que usa este dispositivo. (16)
Este dispositivo solicita un tipo de recurso desconocido. (17)
Vuelva a instalar los controladores de este dispositivo. (18)
Error al usar el cargador de VxD. (19)
Es posible que el registro esté dañado. (20)
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)
Este dispositivo está deshabilitado. (22)
Error del sistema: intente cambiar el controlador de este dispositivo. Si eso no funciona, consulte la documentación de hardware. (23)
Este dispositivo no está presente, no funciona correctamente o no tiene instalados todos sus controladores. (24)
Windows sigue configurando este dispositivo. (25)
Windows sigue configurando este dispositivo. (26)
Este dispositivo no tiene una configuración de registro válida. (27)
Los controladores de este dispositivo no están instalados. (28)
Este dispositivo está deshabilitado porque el firmware del dispositivo no le ha dado los recursos necesarios. (29)
Este dispositivo usa un recurso de solicitud de interrupción (IRQ) que usa otro dispositivo. (30)
Este dispositivo no funciona correctamente porque Windows no puede cargar los controladores necesarios para este dispositivo. (31)
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 clase o subclase usada en la creación de una instancia de . Cuando se usa con otras propiedades clave de la clase , esta propiedad permite identificar de forma única todas las instancias de la 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 textual 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-horas")
Capacidad diseñada de la batería en miliwatt-hours. Si no se admite esta propiedad, escriba 0.
DesignVoltage
-
Tipo de datos: uint64
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("MIF. DMTF| Batería portátil|002.9"), unidades ("milivolts")
Tensión diseñada de la batería en milivoltes. Si no se admite este atributo, escriba 0.
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: CIM_Key
Dirección u otra información de identificación para asignar un nombre único al dispositivo lógico.
Esta propiedad se hereda de CIM_LogicalDevice.
ErrorCleared
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
Si es TRUE, el error notificado en la propiedad LastErrorCode ahora se borra.
Esta propiedad se hereda de CIM_LogicalDevice.
ErrorDescription
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
Cadena de forma libre que proporciona información sobre el error registrado en la propiedad LastErrorCode y las acciones correctivas que se deben realizar.
Esta propiedad se hereda de CIM_LogicalDevice.
EstimatedChargeRemaining
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
-
Calificadores: unidades ("porcentaje")
Porcentaje estimado del cargo total restante.
EstimatedRunTime
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("MIF. DMTF| Batería portátil|002,15"), unidades ("minutos")
Tiempo estimado, en minutos, hasta que la carga de la batería se agote en las condiciones de carga actuales si la energía de la utilidad está apagada, se pierde y permanece apagada, o si un portátil está desconectado de una fuente de alimentación.
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. Esta propiedad representa la duración total esperada de la batería, no su vida restante actual, que se indica mediante la propiedad EstimatedRunTime .
FullChargeCapacity
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("MIF. DMTF| Batería portátil|002.11"), unidades ("miliwatt-horas")
La capacidad de carga completa de la batería en miliwatt-hours. Compare este valor con la propiedad DesignCapacity para determinar cuándo la batería requiere reemplazo. La duración final de una batería suele ser cuando la propiedad FullChargeCapacity cae por debajo del 80 por ciento de la propiedad DesignCapacity . Si no se admite esta propiedad, escriba 0.
InstallDate
-
Tipo de datos: datetime
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Fecha de instalación")
Indica cuándo se instaló el objeto. La falta de un valor no indica que el objeto no 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. Esta propiedad representa el tiempo para recargar una batería completamente agotada, no el tiempo de carga restante actual, que se indica en la propiedad TimeToFullCharge .
Nombre
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: DisplayName ("Name")
Etiqueta por la que se conoce el objeto. Cuando se subclase, esta 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")
Indica el identificador de dispositivo win32 Plug and Play del dispositivo lógico.
Ejemplo: "*PNP030b"
Esta propiedad se hereda de CIM_LogicalDevice.
PowerManagementCapabilities
-
Tipo de datos: matriz uint16
-
Tipo de acceso: solo lectura
Indica las funcionalidades específicas relacionadas con la energía del dispositivo lógico.
Esta propiedad se hereda de CIM_LogicalDevice.
Desconocido (0)
Las capacidades relacionadas con la energía son desconocidas.
No compatible (1)
Las capacidades relacionadas con 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 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)
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
Si es TRUE, el dispositivo se puede administrar con energía, es decir, poner en un estado de ahorro de energía. Si es FALSE, el valor entero 1 ("No admitido") debe ser la única entrada de la matriz PowerManagementCapabilities .
Esta propiedad no indica si las características de administración de energía están habilitadas actualmente o si están habilitadas, qué características se admiten. Para obtener más información, consulte la matriz PowerManagementCapabilities .
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 de batería inteligente compatible con esta batería. Si la batería no admite esta función, el valor debe dejarse vacío.
Estado
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: MaxLen (10), DisplayName ("Status")
Cadena que indica el estado actual del objeto. Se puede definir el estado operativo y no operativo. El estado operativo puede incluir "Aceptar", "Degradado" y "Error previo". "Error previo" indica que un elemento funciona correctamente, pero predice un error (por ejemplo, una unidad de disco duro habilitada para SMART).
El estado no operativo puede incluir "Error", "Inicio", "Detención" y "Servicio". "Servicio" se puede aplicar durante el resilvering de reflejo del disco, volver a cargar una lista de permisos de usuario u otro trabajo administrativo. No todo este trabajo está en línea, pero el elemento administrado no es "OK" 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
Nombre de clase de creación del sistema 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 la cantidad de tiempo desde que el sistema o UPS se reiniciaron por última vez, lo que sea menos. Se devuelve un valor de 0 si la batería está "en línea".
TimeToFullCharge
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("MIF. DMTF| Batería portátil|002,16"), unidades ("minutos")
Tiempo restante, en minutos, para cargar la batería completamente a la velocidad de carga y el uso actuales.
Comentarios
La clase CIM_Battery se deriva de CIM_LogicalDevice.
WMI no implementa esta clase. Para obtener más información sobre las clases derivadas de CIM_Battery, vea Clases Win32.
Esta documentación se deriva de las descripciones de clase CIM publicadas por DMTF. Microsoft puede haber realizado cambios para corregir errores menores, cumplir los estándares de documentación de Microsoft SDK o proporcionar más información.
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