Compartir a través de

CIM_Battery clase

  • Artículo

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
CIMWin32.mof
Archivo DLL
CIMWin32.dll

Consulte también

CIM_LogicalDevice