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

класс Win32_Battery

  • Статья

Класс WMI Win32_Batteryпредставляет батарею, подключенную к компьютерной системе.

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

Синтаксис

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

Участники

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

Методы

Класс Win32_Battery имеет эти методы.

Метод Description
Сбросить Не реализовано. Чтобы реализовать этот метод, см . метод Reset в CIM_Battery документации.
SetPowerState Не реализовано. Чтобы реализовать этот метод, см . метод SetPowerState в CIM_Battery документации.

Свойства

Класс Win32_Battery имеет эти свойства.

Доступность

Тип данных: 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)

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

Power Save — режим низкой мощности (14)

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

Power Save — резервный (15)

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

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

Power Save — предупреждение (17)

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

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

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

Не готов (19)

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

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

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

Викторина (21)

Устройство тихо.

BatteryRechargeTime

Тип данных: uint32

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

Квалификаторы: DEPRECATED, MappingStrings ("HKEY_LOCAL_MACHINE\\System\\CurrentControlSet\\Services|RechargeRate"), Единицы ("минуты")

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

BatteryStatus

Тип данных: uint16

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

Квалификаторы: MappingStrings ("MIF". DMTF |Переносимая батарея|002.14")

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

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

Другие (1)

Аккумулятор выгрузится.

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

Система имеет доступ к AC, поэтому батареи не сбрасываются. Однако батарея не обязательно зарядится.

Полная плата (3)

Низкий (4)

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

Зарядка (6)

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

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

Зарядка и критически важные (9)

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

Частично взимается (11)

Заголовок

Тип данных: строка

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

Квалификаторы: MaxLen (64), DisplayName ("Caption")

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

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

Химии

Тип данных: uint16

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

Квалификаторы: MappingStrings ("MIF". DMTF |Переносимая батарея|002.7")

Перечисление, описывающее химию батареи.

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

Другие (1)

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

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

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

Никель металлический хайдрид (5)

Литиево-ион (6)

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

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

ConfigManagerErrorCode

Тип данных: uint32

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

Квалификаторы: схема ("Win32")

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

Это свойство наследуется от 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

Тип данных: логический

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

Квалификаторы: схема ("Win32")

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

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

CreationClassName

Тип данных: строка

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

Квалификаторы: CIM_Key

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

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

Description

Тип данных: строка

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

Квалификаторы: DisplayName ("Описание")

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

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

КонструкторCapacity

Тип данных: uint32

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

Квалификаторы: MappingStrings ("MIF". DMTF |Переносимая батарея|002.8"), единицы ("милливатт-часы")

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

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

DesignVoltage

Тип данных: uint64

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

Квалификаторы: MappingStrings ("MIF". DMTF |Переносимая батарея|002.9"), единицы ("милливольты")

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

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

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

DeviceID

Тип данных: строка

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

Квалификаторы: ключ, переопределение ("DeviceId"), MappingStrings ("WMI")

Определяет батарею.

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

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

ОшибкаCleared

Тип данных: логический

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

Если значение True, сообщение об ошибке в свойстве LastErrorCode теперь очищается.

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

ErrorDescription

Тип данных: строка

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

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

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

EstimatedChargeRemaining

Тип данных: uint16

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

Квалификаторы: единицы ("процент")

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

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

EstimatedRunTime

Тип данных: uint32

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

Квалификаторы: MappingStrings ("MIF". DMTF |Переносимая батарея|002.15"), единицы ("минуты")

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

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

ExpectedBatteryLife

Тип данных: uint32

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

Квалификаторы: DEPRECATED, MappingStrings ("HKEY_LOCAL_MACHINE\\System\\CurrentControlSet\\Services|BatteryLife"), единицы ("минуты")

Время, затрачиваемое на полностью слив батарею после того, как она полностью зарядится. Это свойство больше не используется и считается устаревшим.

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.

MaxRechargeTime

Тип данных: uint32

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

Квалификаторы: единицы ("минуты")

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

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

Имя

Тип данных: строка

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

Квалификаторы: DisplayName ("Name")

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

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

PNPDeviceID

Тип данных: строка

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

Квалификаторы: схема ("Win32")

Идентификатор устройства Windows самонастраивающийся логического устройства.

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

Пример: "*PNP030b"

PowerManagementCapabilities

Тип данных: массив uint16

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

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

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

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

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

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

Включено (3)

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

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

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

Набор состояний Power (5)

Поддерживается метод SetPowerState. Этот метод найден в родительском CIM_LogicalDevice классе и может быть реализован. Дополнительные сведения см. в разделе "Проектирование классов управляемого объекта (MOF).

Поддержка power Cycling (6)

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

Время поддержки Power On (7)

Поддерживается время включения питания

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

PowerManagementSupported

Тип данных: логический

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

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

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

SmartBatteryVersion

Тип данных: строка

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

Квалификаторы: MaxLen (64), MappingStrings ("MIF". DMTF |Переносимая батарея|002.10")

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

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

Состояние

Тип данных: строка

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

Квалификаторы: MaxLen (10), DisplayName ("Status")

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

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

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

ОК ("ОК ")

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

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

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

Pred Fail ("Pred Fail ")

Запуск ("Запуск ")

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

Service ("Service")

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

NonRecover ("NonRecover")

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

Lost Comm ("Lost Comm")

StatusInfo

Тип данных: uint16

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

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

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

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

Другие (1)

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

Включено (3)

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

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

SystemCreationClassName

Тип данных: строка

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

Квалификаторы: распространение ("CIM_System".CreationClassName"), CIM_Key

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

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

SystemName

Тип данных: строка

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

Квалификаторы: распространение ("CIM_System".Name"), CIM_Key

Имя системы области.

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

TimeOnBattery

Тип данных: uint32

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

Квалификаторы: единицы ("секунды")

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

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

TimeToFullCharge

Тип данных: uint32

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

Квалификаторы: MappingStrings ("MIF". DMTF |Переносимая батарея|002.16"), единицы ("минуты")

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

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

Замечания

Класс Win32_Battery является производным от CIM_Battery, производных от CIM_LogicalDevice.

Windows Server 2008 содержит драйверы UPS (APC) в ОС, что позволяет обрабатывать UPS как батарею. Это позволяет отслеживать состояние UPS с помощью скрипта и выполнять действия при необходимости.

Требования

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

См. также

CIM_Battery

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