Compartir a través de

Win32_Battery clase

  • Artículo

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

Consulte también

CIM_Battery

Clases de hardware del sistema de equipos