Win32_PowerManagementEvent 类

项目
06/12/2023

Win32_PowerManagementEventWMI 类表示电源状态更改导致的电源管理事件。这些状态更改与高级电源管理 (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 类具有以下类型的成员：

属性

属性

Win32_PowerManagementEvent 类具有这些属性。

EventType

数据类型： uint16
访问类型：只读
限定符： MappingStrings (“Win32API|电源管理事件“)

系统电源状态中的更改类型。

进入 Suspend (4)

挂起时，计算机似乎已关闭;但是，它可以“唤醒”以响应各种事件，包括用户输入 (（例如移动鼠标或按键盘) 上的键）。当计算机暂停时，功耗会降低到几个级别之一，具体取决于系统的使用方式。功耗级别越低，系统恢复工作状态所需的时间就越长。当计算机进入暂停状态时，桌面处于锁定状态，必须按 Ctrl+ALT+DELETE 并提供有效的用户名和密码才能恢复操作

从暂停 (7) 恢复

指示已发送“从暂停恢复”消息，使计算机能够恢复正常电源状态。

电源状态更改 (10)

指示计算机的电源状态更改，例如从电池电源切换到交流电源，或从交流切换到不间断电源。系统还会在剩余电池电量降至用户指定的阈值以下时或电池电量变化了指定的百分比时广播该事件。

OEM 事件 (11)

指示高级电源管理 (APM) BIOS 已发送 OEM 事件。将在 OEMEventCode 属性中捕获事件的值。由于某些 APM BIOS 实现不提供 OEM 事件通知，因此此事件可能永远不会在某些计算机上广播。 APM 是旧版电源管理方案。尽管仍受支持，但 APM 已在很大程度上被 ACPI (高级配置和电源接口) 取代。

恢复自动 (18)

指示计算机已唤醒以响应事件。如果系统检测到用户活动 (（如鼠标单击) ），则将广播 ResumeSuspend 消息，让应用程序知道他们可以恢复与用户的完全交互。

OEMEventCode

数据类型： uint16
访问类型：只读
限定符： MappingStrings (“Win32API|电源管理事件“)

当此类的 EventType 属性设置为 11 (OEM 事件) 时，原始设备制造商 (OEM) 定义的系统电源状态;否则，此属性设置为 NULL。当 APM BIOS 向 APM OEM 事件发出信号时，将生成 OEM 事件。 OEM 事件代码的范围为 0x0200h - 0x02FFh。

SECURITY_DESCRIPTOR

数据类型： uint8 数组
访问类型：只读

事件提供程序用于确定哪些用户可以接收事件的描述符。此属性继承自 __Event。有关用于设置此安全描述符的常量的详细信息，请参阅 WMI 安全常量。

TIME_CREATED

数据类型： uint64
访问类型：只读

指示生成事件的时间的唯一值。这是一个 64 位值，表示 1601 年 1 月 1 日之后的 100 纳秒间隔数。此信息采用协调世界时报 (UTC) 格式。

此属性继承自 __Event。

有关在脚本中使用 uint64 值的详细信息，请参阅 WMI 中的脚本。

备注

Win32_PowerManagementEvent 类派生自 __ExtrinsicEvent。

电源状态的更改通常表示计算机或其他受管理设备出现问题。如果服务器突然从交流电源切换到不间断电源，此变化可能表明发生了某种电气问题，无论是计算机本身还是计算机所在的房间中的电气系统。

管理员需要监视电源状态中的这些更改，并立即收到此类更改的通知。这使他们能够在设备完全断电之前采取措施。例如， (不间断电源系统在关闭之前可能只运行 15 分钟左右。)

Win32_PowerManagementEvent 类可用于监视计算机上的电源状态更改。这些更改可能包括从一个电源切换到另一个电源，以及计算机电源状态 (更改，例如，进入或退出挂起模式) 。

Win32_PowerManagementEvent类只有两个属性：EventType（用于指示发生的电源更改事件的类型）和 OEMEventType（一些原始设备制造商用于定义其他电源更改事件）。

有关响应 Windows 电源事件的详细信息，请参阅使用 PowerShell 监视和响应 Windows Power Events（使用 PowerShell 监视和响应 Windows Power Events ）一文，了解你好！脚本家伙！博客。

示例

以下 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
计算机系统硬件类
监视计算机电源状态中的更改

通过

Win32_PowerManagementEvent 类

语法

成员

属性

备注

示例

要求

另请参阅

反馈

其他资源