Win32_PortableBattery clase
La clase Win32_PortableBatteryWMI contiene las propiedades relacionadas con una batería portátil, como una batería de ordenador portátil.
La siguiente sintaxis se simplifica desde el código de Managed Object Format (MOF) e incluye todas las propiedades heredadas. Las propiedades y los métodos están en orden alfabético, no en orden MOF.
Sintaxis
[Dynamic, Provider("CIMWin32"), UUID("{FAF76B9E-798C-11D2-AAD1-006008C78BC7}"), AMENDMENT]
class Win32_PortableBattery : CIM_Battery
{
uint16 Availability;
uint16 BatteryStatus;
uint16 CapacityMultiplier;
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;
string Location;
string ManufactureDate;
string Manufacturer;
uint16 MaxBatteryError;
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_PortableBattery tiene estos tipos de miembros:
Métodos
La clase Win32_PortableBattery tiene estos métodos.
| Método | Descripción |
|---|---|
| Reset | Sin implementar. Para implementar este método, consulte el método Reset en CIM_Battery. |
| SetPowerState | Sin implementar. Para implementar este método, consulte el método SetPowerState en CIM_Battery. |
Propiedades
La clase Win32_PortableBattery 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)
-
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 se podría llevar 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 (Sin definir) no es válido en el esquema common Information Model (CIM) porque en la Interfaz de administración de escritorio (DMI) indica que no hay batería instalada. En este caso, no se debe crear una instancia de este objeto.
Esta propiedad se hereda de CIM_Battery.
Otros (1)
Desconocido (2)
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)
CapacityMultiplier
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("SMBIOS| Tipo 22| Multiplicador de capacidad de diseño")
Factor de multiplicación del valor DesignCapacity para asegurarse de que el valor de la hora milliwatt no se desborda para implementaciones de especificación de datos de batería inteligente (SBDS).
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")
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")
Win32 Configuration Manager código de error.
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 gratuitos 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 de este dispositivo. (18)
Los controladores de dispositivo deben reinstalarse.
Error al usar el cargador de VxD. (19)
Es posible que el registro esté dañado. (20)
El registro puede estar 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 no es eficaz, 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 no es eficaz, 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 instalados todos sus controladores.
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 ha dado 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 otro dispositivo está usando.
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 demás propiedades clave de la clase , la propiedad permite identificar 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 esta 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")
Tensión de diseño de la batería en milivolts. Si no se admite este 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")
Identificador de 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, 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 y 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 de agotamiento de 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
No compatible.
Esta propiedad se hereda de CIM_Battery.
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 .
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-horas")
Capacidad de carga completa de la batería en miliwatt-hours. La comparación de este valor con la propiedad DesignCapacity determina cuándo la batería requiere reemplazo. El final de la vida útil de una batería suele ser cuando la propiedad FullChargeCapacity cae por debajo del 80 % de la propiedad DesignCapacity . Si no se admite esta 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.
Ubicación
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("SMBIOS| Tipo 22| Ubicación")
Ubicación física de la batería. El fabricante del equipo rellena esta propiedad.
Ejemplo: "En la parte posterior, a la izquierda"
ManufactureDate
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("SMBIOS| Tipo 22| Fecha de fabricación")
Fecha en que se fabricó la batería.
Fabricante
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("SMBIOS| Tipo 22| Fabricante")
Fabricante de la batería.
MaxBatteryError
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
-
Calificadores: MappingStrings ("SMBIOS| Tipo 22| Error máximo en los datos de batería"), unidades ("porcentaje")
Diferencia entre la cantidad estimada más alta de energía que queda en la batería y la cantidad actual notificada por la batería.
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 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")
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 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)
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 la 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 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 "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.
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 está 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 en minutos para cargar la batería completamente a la velocidad de carga y el uso actuales.
Esta propiedad se hereda de CIM_Battery.
Comentarios
La clase Win32_PortableBattery se deriva de CIM_Battery.
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