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
CIMWin32.mof
DLL
CIMWin32.dll

另請參閱

__ExtrinsicEvent

電腦系統硬體類別

監視電腦電源狀態中的變更