Win32_PowerManagementEvent 類別

Win32_PowerManagementEventWMI 類別代表電源狀態變更所產生的電源管理事件。 這些狀態變更與進階電源管理 (APM) 或進階設定和 Power Interface (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)

指出電腦的電源狀態變更,例如從電池電源切換為 AC,或從 AC 切換為不中斷電源供應器。 當剩餘電池的電力下滑至使用者所指定的臨界值之下,或是如果電池的電力由指定百分比來變更時,系統也會廣播這個事件。

OEM 事件 (11)

表示 APM (APM) BIOS 已傳送 OEM 事件。 事件的值將會在 OEMEventCode 屬性中擷取。 因為某些 APM BIOS 實作未提供 OEM 事件通知,所以某些電腦上可能永遠不會廣播此事件。 APM 是舊版電源管理配置。 雖然仍受到支援,但 ACPI 已大量取代 APM (進階設定和 Power Interface) 。

繼續自動 (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

電源狀態的變更通常表示電腦或其他受管理裝置發生問題。 如果伺服器突然從 AC 電源切換到不連續的電源供應器,這項變更可能表示發生某種電力問題,可能是電腦本身或電腦保留在會議室中的電力系統。

系統管理員必須監視電源狀態中的這些變更,並立即收到這類變更的通知。 這可讓他們在裝置完全失去電源之前採取動作。 例如, (無法中斷的電源供應器系統可能只執行 15 分鐘或等,再關閉。)

Win32_PowerManagementEvent類別可用來監視電腦上的電源狀態變更。 這些變更可能包括從一個電源切換到另一個電源,以及電腦電源狀態 (的變更,例如進入或結束暫停模式) 。

Win32_PowerManagementEvent類別只有兩個屬性:EventType,用來指出發生的電源變更事件種類,以及某些原始設備製造商用來定義其他電源變更事件的 OEMEventType。

如需回應Windows電源事件的詳細資訊,請參閱 Hey 上的監視和回應Windows Power Events一文! Scripting Guy! 部落格。

範例

下列 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

電腦系統硬體類別

監視電腦電源狀態的變更