класс Win32_PortableBattery

Статья
06/12/2023

Класс WMIWin32_PortableBattery содержит свойства, связанные с переносным аккумулятором, например аккумулятором компьютера записной книжки.

Следующий пример синтаксиса — упрощенный MOF-код, который включает все наследуемые свойства. Свойства и методы находятся в алфавитном порядке, а не в порядке MOF.

Синтаксис

[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;
};

Члены

Класс Win32_PortableBattery имеет следующие типы членов:

Методы
Свойства

Методы

Класс Win32_PortableBattery содержит эти методы.

Метод	Описание
Сброс	Не реализован. Сведения о реализации этого метода см. в разделе Метод Reset в CIM_Battery.
SetPowerState	Не реализован. Чтобы реализовать этот метод, см. метод SetPowerState в CIM_Battery.

Свойства

Класс Win32_PortableBattery имеет следующие свойства.

Доступность

Тип данных: uint16
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("MIF. DMTF| Рабочее состояние|003.5", "MIB. IETF| HOST-RESOURCES-MIB.hrDeviceStatus")

Доступность и состояние устройства.

Это свойство наследуется от CIM_LogicalDevice.

Другое (1)

Неизвестно (2)

Работа и полная мощность (3)

Запуск или полная мощность

Предупреждение (4)

В тесте (5)

Неприменимо (6)

Выключение питания (7)

Off Line (8)

Off Duty (9)

Понижение производительности (10)

Не установлено (11)

Ошибка установки (12)

Power Save — неизвестно (13)

Известно, что устройство находится в режиме экономии энергии, но его точное состояние неизвестно.

Экономия энергии — режим низкого энергопотребления (14)

Устройство находится в состоянии экономии энергии, но по-прежнему работает и может демонстрировать снижение производительности.

Экономия энергии в режиме ожидания (15)

Устройство не работает, но может быть приведено в полную мощность быстро.

Цикл питания (16)

Экономия энергии — предупреждение (17)

Устройство находится в состоянии предупреждения, хотя и в режиме экономии энергии.

Приостановлено (18)

Устройство приостановлено.

Не готово (19)

Устройство не готово.

Не настроено (20)

Устройство не настроено.

Притормоенная (21)

Устройство работает тихо.

BatteryStatus

Тип данных: uint16
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("MIF. DMTF| Портативный аккумулятор|002.14")

Описание состояния заряда батареи. Значение 10 (не определено) является недопустимым в схеме CIM, так как в интерфейсе управления настольными компьютерами (DMI) это означает, что аккумулятор не установлен. В этом случае экземпляр этого объекта не следует создавать.

Это свойство наследуется от CIM_Battery.

Другое (1)

Неизвестно (2)

Полностью заряженный (3)

Низкий (4)

Критический (5)

Зарядка (6)

Зарядка и высокая (7)

Зарядка и низкая (8)

Зарядка и критическое (9)

Неопределенный (10)

Частично оплачивается (11)

CapacityMultiplier

Тип данных: uint16
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("SMBIOS| Тип 22| Множитель емкости конструктора")

Коэффициент умножения значения DesignCapacity , чтобы гарантировать, что значение милливатт-часа не переполнится для реализаций Спецификации данных об интеллектуальной батарее (SBDS).

Caption

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MaxLen (64), DisplayName ("Caption")

Краткое описание объекта — однострочный текст.

Это свойство наследуется от CIM_ManagedSystemElement.

Химии

Тип данных: uint16
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("MIF. DMTF| Портативный аккумулятор|002.7")

Химия батареи.

Это свойство наследуется от CIM_Battery.

Другое (1)

Неизвестно (2)

Свинцовая кислота (3)

Никель кадмий (4)

Никель металлгидрид (5)

Литий-ионный (6)

Цинковый воздух (7)

Литий-полимер (8)

ConfigManagerErrorCode

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: Schema ("Win32")

Код ошибки Configuration Manager Win32.

Это свойство наследуется от CIM_LogicalDevice.

Это устройство работает правильно. (0)

Устройство работает правильно.

Это устройство настроено неправильно. (1)

Устройство настроено неправильно.

Windows не может загрузить драйвер для этого устройства. (2)

Драйвер для этого устройства может быть поврежден или в системе может быть недостаточно памяти или других ресурсов. (3)

Драйвер для этого устройства может быть поврежден или в системе может быть недостаточно памяти или других ресурсов.

Это устройство работает неправильно. Один из его драйверов или реестр может быть поврежден. (4)

Устройство работает неправильно. Один из его драйверов или реестр может быть поврежден.

Драйверу для этого устройства требуется ресурс, которым Windows не может управлять. (5)

Драйверу для устройства требуется ресурс, которым Windows не может управлять.

Конфигурация загрузки для этого устройства конфликтует с другими устройствами. (6)

Конфигурация загрузки для устройства конфликтует с другими устройствами.

Не удается выполнить фильтрацию. (7)

Отсутствует загрузчик драйверов для устройства. (8)

Отсутствует загрузчик драйвера для устройства.

Это устройство работает неправильно, так как управляющее встроенное ПО неправильно сообщает о ресурсах для устройства. (9)

Устройство работает неправильно. Управляющее встроенное ПО неправильно сообщает о ресурсах для устройства.

Не удается запустить это устройство. (10)

Не удается запустить устройство.

Это устройство завершилось сбоем. (11)

Сбой устройства.

Это устройство не может найти достаточно свободных ресурсов, которые оно может использовать. (12)

Устройство не может найти достаточно свободных ресурсов для использования.

Windows не может проверить ресурсы этого устройства. (13)

Windows не может проверить ресурсы устройства.

Это устройство не может работать должным образом, пока вы не перезагрузите компьютер. (14)

Устройство не может работать должным образом, пока компьютер не перезагрузится.

Это устройство работает неправильно, так как, вероятно, возникла проблема с повторным перечислением. (15)

Устройство не работает должным образом из-за возможной проблемы с повторным перечислением.

Windows не может определить все ресурсы, используемые этим устройством. (16)

Windows не может определить все ресурсы, используемые устройством.

Это устройство запрашивает неизвестный тип ресурса. (17)

Устройство запрашивает неизвестный тип ресурса.

Переустановите драйверы для этого устройства. (18)

Драйверы устройств необходимо переустановить.

Сбой при использовании загрузчика VxD. (19)

Возможно, реестр поврежден. (20)

Реестр может быть поврежден.

Сбой системы. Попробуйте изменить драйвер для этого устройства. Если это не сработает, обратитесь к документации по оборудованию. Windows удаляет это устройство. (21)

Сбой системы. Если изменение драйвера устройства неэффективно, см. документацию по оборудованию. Windows удаляет устройство.

Это устройство отключено. (22)

Устройство отключено.

Сбой системы. Попробуйте изменить драйвер для этого устройства. Если это не сработает, обратитесь к документации по оборудованию. (23)

Сбой системы. Если изменение драйвера устройства неэффективно, см. документацию по оборудованию.

Это устройство отсутствует, не работает должным образом или на нем установлены не все драйверы. (24)

Устройство отсутствует, не работает должным образом или на нем установлены не все драйверы.

Windows по-прежнему настраивает это устройство. (25)

Windows по-прежнему настраивает устройство.

Windows по-прежнему настраивает это устройство. (26)

Windows по-прежнему настраивает устройство.

Это устройство не имеет допустимой конфигурации журнала. (27)

Устройство не имеет допустимой конфигурации журнала.

Драйверы для этого устройства не установлены. (28)

Драйверы устройств не установлены.

Это устройство отключено, так как встроенное ПО устройства не дало ему необходимых ресурсов. (29)

Устройство отключено. Встроенное ПО устройства не предоставило необходимых ресурсов.

Это устройство использует ресурс запроса прерывания (IRQ), который использует другое устройство. (30)

Устройство использует ресурс IRQ, который использует другое устройство.

Это устройство работает неправильно, так как Windows не может загрузить драйверы, необходимые для этого устройства. (31)

Устройство работает неправильно. Windows не может загрузить необходимые драйверы устройств.

ConfigManagerUserConfig

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: Schema ("Win32")

Если задано значение TRUE, устройство использует определяемую пользователем конфигурацию.

Это свойство наследуется от CIM_LogicalDevice.

CreationClassName

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: CIM_Key

Имя первого конкретного класса, который отображается в цепочке наследования, используемой при создании экземпляра. При использовании с другими ключевыми свойствами класса свойство позволяет уникально идентифицировать все экземпляры этого класса и его подклассы.

Это свойство наследуется от CIM_LogicalDevice.

Описание

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: DisplayName ("Описание")

Описание объекта.

Это свойство наследуется от CIM_ManagedSystemElement.

DesignCapacity

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("MIF. DMTF| Портативный аккумулятор|002.8"), единицы измерения (милливатт-часы)

Проектная емкость батареи в милливатт-часах. Если это свойство не поддерживается, введите 0 (ноль).

Это свойство наследуется от CIM_Battery.

DesignVoltage

Тип данных: uint64
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("MIF. DMTF| Портативный аккумулятор|002.9"), единицы измерения ("милливольты")

Расчетное напряжение батареи в милливольтах. Если этот атрибут не поддерживается, введите 0 (ноль).

Это свойство наследуется от CIM_Battery.

Дополнительные сведения об использовании значений uint64 в скриптах см. в разделе Скрипты в WMI.

DeviceID

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: Key, Override ("DeviceId"), MappingStrings ("WMI")

Идентификатор батареи.

Это свойство наследуется от CIM_LogicalDevice.

Пример: "Внутренняя батарея"

ErrorCleared

Тип данных: boolean
Тип доступа: только для чтения

Если задано значение TRUE, ошибка, сообщаемая в LastErrorCode , теперь удаляется.

Это свойство наследуется от CIM_LogicalDevice.

ErrorDescription

Тип данных: string
Тип доступа: только для чтения

Дополнительные сведения об ошибке, записанной в LastErrorCode, и о любых корректирующих действиях, которые могут быть выполнены.

Это свойство наследуется от CIM_LogicalDevice.

EstimatedChargeRemaining

Тип данных: uint16
Тип доступа: только для чтения
Квалификаторы: единицы ("проценты")

Оценка процента оставшейся полной оплаты.

Это свойство наследуется от CIM_Battery.

EstimatedRunTime

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("MIF. DMTF| Портативный аккумулятор|002.15"), единицы измерения ("минуты")

Оцените в минутах время для разрядки заряда батареи в нынешних условиях нагрузки, если питание служебной программы отключено, потеряно и остается выключенным, или ноутбук отключен от источника питания.

Это свойство наследуется от CIM_Battery.

ExpectedBatteryLife

Тип данных: uint32
Тип доступа: только для чтения

Не поддерживается.

Это свойство наследуется от CIM_Battery.

ExpectedLife

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: единицы ("минуты")

Ожидаемое время существования батареи в минутах при условии, что батарея полностью заряжена. Это свойство представляет общий ожидаемый срок службы батареи, а не его текущий оставшийся срок службы, который обозначается свойством EstimatedRunTime .

Это свойство наследуется от CIM_Battery.

FullChargeCapacity

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("MIF. DMTF| Портативный аккумулятор|002.11"), единицы измерения ("милливатт-часы")

Полная емкость заряда батареи в милливатт-часах. Сравнение этого значения со свойством DesignCapacity определяет, когда требуется замена батареи. Срок службы батареи обычно заканчивается, когда свойство FullChargeCapacity падает ниже 80 % от свойства DesignCapacity . Если это свойство не поддерживается, введите 0 (ноль).

Это свойство наследуется от CIM_Battery.

InstallDate

Тип данных: datetime
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Дата установки")

Дата и время установки объекта. Этому свойству не требуется значение, указывающее, что объект установлен.

Это свойство наследуется от CIM_ManagedSystemElement.

LastErrorCode

Тип данных: uint32
Тип доступа: только для чтения

Последний код ошибки, сообщаемый логическим устройством.

Это свойство наследуется от CIM_LogicalDevice.

Расположение

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("SMBIOS| Тип 22| Расположение")

Физическое расположение батареи. Это свойство заполняется производителем компьютера.

Пример: "Сзади, слева"

ManufactureDate

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("SMBIOS| Тип 22| Дата производства")

Дата изготовления батареи.

Производителя

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("SMBIOS| Тип 22| Производитель")

Производитель батареи.

MaxBatteryError

Тип данных: uint16
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("SMBIOS| Тип 22| Максимальная ошибка в данных об батарее), единицы ("проценты")

Разница между наибольшим предполагаемым количеством энергии, оставшееся в аккумуляторе, и текущим объемом, сообщаемым аккумулятором.

MaxRechargeTime

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: единицы ("минуты")

Максимальное время (в минутах) для полной зарядки батареи. Это свойство представляет время для зарядки полностью исчерпанной батареи, а не текущее оставшееся время зарядки, которое указано в свойстве TimeToFullCharge .

Это свойство наследуется от CIM_Battery.

имя;

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: DisplayName ("Name")

Метка, по которой известен объект. При подклассе свойство может быть переопределено как ключевое свойство.

Это свойство наследуется от CIM_ManagedSystemElement.

PNPDeviceID

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: Схема ("Win32")

Windows Plug and Play идентификатор логического устройства.

Это свойство наследуется от CIM_LogicalDevice.

Пример: "*PNP030b"

PowerManagementCapabilities

Тип данных: массив uint16
Тип доступа: только для чтения

Массив конкретных возможностей логического устройства, связанных с питанием.

Это свойство наследуется от CIM_LogicalDevice.

Неизвестно (0)

Не поддерживается (1)

Отключено (2)

Включено (3)

Функции управления питанием в настоящее время включены, но точный набор функций неизвестен или информация недоступна.

Режимы энергосбережения, введенные автоматически (4)

Устройство может изменять состояние питания в зависимости от использования или других критериев.

Настройка состояния power (5)

Поддерживается метод SetPowerState . Этот метод находится в родительском CIM_LogicalDevice классе и может быть реализован. Дополнительные сведения см. в разделе Designing Managed Object Format (MOF) Classes.

Поддержка циклов питания (6)

Метод SetPowerState можно вызвать с параметром PowerState , равным 5 (Power Cycle).

Поддержка включения по времени (7)

Поддержка Power-On по времени

Метод SetPowerState можно вызвать с параметром PowerState , равным 5 (power cycle), а для параметра Time задана определенная дата и время или интервал для включения питания.

PowerManagementSupported

Тип данных: boolean
Тип доступа: только для чтения

Если задано значение TRUE, устройством можно управлять питанием (можно переводить в режим приостановки и т. д.). Свойство не указывает, что в настоящее время включены функции управления питанием, а только то, что логическое устройство может управлять питанием.

Это свойство наследуется от CIM_LogicalDevice.

SmartBatteryVersion

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MaxLen (64), MappingStrings ("MIF. DMTF| Портативный аккумулятор|002.10")

Номер версии спецификации данных смарт-батареи, поддерживаемой этим аккумулятором. Если батарея не поддерживает эту функцию, значение следует оставить пустым.

Это свойство наследуется от CIM_Battery.

Состояние

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MaxLen (10), DisplayName ("Status")

Текущее состояние объекта. Можно определить различные операционные и нерабоспособные состояния. Операционные состояния: "ОК", "Понижено" и "Сбой предварительного выполнения" (элемент, например жесткий диск с поддержкой SMART, может работать правильно, но прогнозирует сбой в ближайшем будущем). Неработоспособное состояние: "Ошибка", "Запуск", "Остановка" и "Служба". Последняя служба может применяться во время зеркало повторного выполнения диска, перезагрузки списка разрешений пользователя или других административных действий. Не все такие работы доступны в сети, но управляемый элемент не является ни "ОК", ни в одном из других состояний.

Это свойство наследуется от CIM_ManagedSystemElement.

В эти значения входят:

ОК ("ОК")

Ошибка ("Ошибка")

Пониженный ("Пониженный")

Unknown ("Unknown")

Pred Fail ("Pred Fail")

Запуск ("Начало")

Остановка ("Остановка")

Служба ("Служба")

Подчеркнуто ("Подчеркнуто")

NonRecover ("NonRecover")

Нет контакта ("Нет контакта")

Lost Comm ("Lost Comm")

StatusInfo

Тип данных: uint16
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("MIF. DMTF| Рабочее состояние|003.3")

Состояние логического устройства. Если это свойство не применяется к логическому устройству, следует использовать значение 5 (неприменимо).

Это свойство наследуется от CIM_LogicalDevice.

Другое (1)

Неизвестно (2)

Включено (3)

Отключено (4)

Неприменимо (5)

SystemCreationClassName

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: распространяется ("CIM_System. CreationClassName"), CIM_Key

Значение свойства CreationClassName компьютера с областью действия.

Это свойство наследуется от CIM_LogicalDevice.

SystemName

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: распространяется ("CIM_System. Name"), CIM_Key

Имя системы определения области.

Это свойство наследуется от CIM_LogicalDevice.

TimeOnBattery

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: единицы ("секунды")

Затраченное время в секундах с момента последнего переключения ИП компьютера на питание от батареи или время последнего перезапуска системы или ИП, в зависимости от того, что меньше. Если аккумулятор подключен к сети, возвращается значение 0 (ноль).

Это свойство наследуется от CIM_Battery.

TimeToFullCharge

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("MIF. DMTF| Портативный аккумулятор|002.16"), единицы измерения ("минуты")

Оставшееся время в минутах для полной зарядки батареи при текущей скорости заряда и использовании.

Это свойство наследуется от CIM_Battery.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Пространство имен	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

См. также раздел

CIM_Battery
Классы оборудования компьютерной системы

Поделиться через

класс Win32_PortableBattery

Синтаксис

Члены

Методы

Свойства

Комментарии

Требования

См. также раздел

Обратная связь

Дополнительные ресурсы