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 (進階設定和 Power Interface) 已大幅取代 APM。
-
繼續自動 (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! 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 |
|
DLL |
|
另請參閱