Класс Win32_PowerManagementEvent

Статья
06/12/2023

Класс WMIWin32_PowerManagementEvent представляет события управления питанием, возникающие в результате изменения состояния питания. Эти изменения состояния связаны с протоколами управления системой расширенного управления питанием (APM) или расширенной конфигурацией и интерфейсом управления питанием (ACPI).

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

Синтаксис

[UUID("{86460B6B-E709-11d2-B139-00105A1F77A1}"), AMENDMENT]
class Win32_PowerManagementEvent : __ExtrinsicEvent
{
  uint8  SECURITY_DESCRIPTOR[];
  uint64 TIME_CREATED;
  uint16 EventType;
  uint16 OEMEventCode;
};

Члены

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

Свойства

Элемент Property

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

EventType

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

Тип изменения состояния питания системы.

Ввод приостановки (4)

Во время приостановки компьютер, кажется, выключен; однако он может быть "пробужден" в ответ на различные события, включая ввод данных пользователем (например, перемещение мыши или нажатие клавиши на клавиатуре). Пока компьютер приостановлен, энергопотребление снижается до одного из нескольких уровней в зависимости от того, как будет использоваться система. Чем ниже уровень энергопотребления, тем больше времени занимает система, чтобы вернуться в рабочее состояние. Когда компьютер переходит в состояние приостановки, рабочий стол блокируется, и необходимо нажать клавиши CTRL+ALT+DELETE и указать допустимое имя пользователя и пароль для возобновления работы.

Возобновление приостановки (7)

Указывает, что было отправлено сообщение Возобновление из приостановки, что позволяет компьютеру вернуться в обычное состояние питания.

Изменение состояния питания (10)

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

Событие OEM (11)

Указывает, что BIOS расширенного управления питанием (APM) отправил событие OEM. Значение события будет записано в свойстве OEMEventCode . Так как некоторые реализации APM BIOS не предоставляют уведомления о событиях OEM, это событие может никогда не транслироваться на некоторых компьютерах. APM — это устаревшая схема управления питанием. Хотя по-прежнему поддерживается, APM в значительной степени заменен ACPI (Advanced Configuration and Power Interface).

Автоматическое возобновление (18)

Указывает, что компьютер проснулся в ответ на событие. Если система обнаруживает действия пользователя (например, щелчок мышью), будет транслироваться сообщение ResumeSuspend, что позволит приложениям понять, что они могут возобновить полное взаимодействие с пользователем.

OEMEventCode

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

Состояние питания системы, определенное изготовителем оборудования (OEM), если свойство EventType этого класса имеет значение 11 (событие OEM); В противном случае этому свойству присваивается значение NULL. События OEM создаются, когда BIOS APM сообщает о событии OEM APM. Коды событий OEM находятся в диапазоне от 0x0200h до 0x02Fh.

SECURITY_DESCRIPTOR

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

Дескриптор, используемый поставщиком событий для определения того, какие пользователи могут получать событие. Это свойство наследуется от __Event. Дополнительные сведения о константах, используемых для задания этого дескриптора безопасности, см. в разделе Константы безопасности WMI.

TIME_CREATED

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

Уникальное значение, указывающее время создания события. Это 64-разрядное значение, представляющее число 100-наносекундных интервалов после 1 января 1601 г. Информация представлена в формате UTC.

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

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

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

Администраторы должны отслеживать эти изменения в состоянии питания и получать уведомления о таких изменениях немедленно. Это позволяет им выполнять действия до того, как устройство полностью потеряет питание. (Например, системы бесперебойного питания могут работать всего около 15 минут перед завершением работы.)

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

Класс Win32_PowerManagementEvent имеет только два свойства: EventType, используемый для указания типа произошедшего события изменения питания, и OEMEventType, который используется некоторыми производителями оборудования для определения дополнительных событий изменения питания.

Дополнительные сведения о реагировании на события питания Windows см. в статье Мониторинг и реагирование на события Windows PowerShell с помощью PowerShell на сайте Hey! Скрипт гай! .

Примеры

Следующий VBScript отслеживает изменения состояния питания на компьютере.

Set colMonitoredEvents = GetObject("winmgmts:")._
 ExecNotificationQuery("SELECT * FROM Win32_PowerManagementEvent")
Do
 Set strLatestEvent = colMonitoredEvents.NextEvent
 Wscript.Echo strLatestEvent.EventType
Loop

Требования

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

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

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