Win32_PowerManagementEvent クラス

Win32_PowerManagementEventWMI クラスは、電源状態の変化に起因する電源管理イベントを表します。 これらの状態の変更は、Advanced Power Management (APM) または Advanced Configuration and 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|Power Management イベント")

システム電源状態の変更の種類。

中断の入力 (4)

一時停止中は、コンピューターがオフになっているように見えます。ただし、ユーザー入力 (マウスの移動やキーボードのキーの押下など) など、さまざまなイベントに応答して "目覚める" ことができます。 コンピューターが一時停止されている間、システムの使用方法に応じて、消費電力がいくつかのレベルのいずれかに減ります。 消費電力のレベルが低いほど、システムが動作状態に戻る時間が長くなります。 コンピューターが中断状態になると、デスクトップがロックされ、Ctrl キーを押しながら Alt キーを押しながら DELETE キーを押し、操作を再開するための有効なユーザー名とパスワードを指定する必要があります

中断からの再開 (7)

一時停止からの再開メッセージが送信されたことを示します。これにより、コンピューターは通常の電源状態に戻ります。

電源状態の変更 (10)

バッテリ電源から AC への切り替え、AC から無停電電源装置への切り替えなど、コンピューターの電源状態の変化を示します。 また、バッテリ電力の残量がユーザーが指定したしきい値を下回る場合や、指定した割合でバッテリ電力が変更された場合も、このイベントがブロードキャストされます。

OEM イベント (11)

Advanced Power Management (APM) BIOS が OEM イベントを送信したことを示します。 イベントの値は OEMEventCode プロパティにキャプチャされます。 一部の APM BIOS 実装では OEM イベント通知が提供されないため、一部のコンピューターではこのイベントがブロードキャストされない場合があります。 APM は、従来の電源管理スキームです。 引き続きサポートされていますが、APM は主に ACPI (高度な構成と電源インターフェイス) に置き換えられます。

自動再開 (18)

イベントに応答してコンピューターが目覚めたことを示します。 システムがユーザー アクティビティ (マウス クリックなど) を検出すると、ResumeSuspend メッセージがブロードキャストされ、ユーザーとの完全な対話を再開できることをアプリケーションに知らせます。

OEMEventCode

データ型: uint16

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32API|Power Management イベント")

このクラスの EventType プロパティが 11 (OEM イベント) に設定されている場合、元の機器製造元 (OEM) によって定義されるシステムの電源状態。それ以外の場合、このプロパティは NULL に設定されます。 APM BIOS が APM OEM イベントを通知すると、OEM イベントが生成されます。 OEM イベント コードの範囲は 0x0200h - 0x02FFh です。

SECURITY_DESCRIPTOR

データ型: uint8 配列

アクセスの種類: 読み取り専用

イベント プロバイダーがイベントを受け取ることができるユーザーを決定するために使用される記述子。 このプロパティは、 __Eventから継承されます。 このセキュリティ記述子の設定に使用される定数の詳細については、「 WMI セキュリティ定数」を参照してください。

TIME_CREATED

データ型: uint64

アクセスの種類: 読み取り専用

イベントが生成された時刻を示す一意の値。 これは、1601 年 1 月 1 日以降の 100 ナノ秒間隔の数を表す 64 ビット値です。 情報は協定世界時 (UTC) 形式です。

このプロパティは、 __Eventから継承されます。

スクリプトで uint64 値を使用する方法の詳細については、「 WMI でのスクリプト作成」を参照してください。

解説

Win32_PowerManagementEvent クラスは、__ExtrinsicEventから派生します。

電源状態の変化は、多くの場合、コンピューターまたは別のマネージド デバイスで問題が発生したことを示します。 サーバーが突然 AC 電源から無停電電源装置に切り替わった場合、この変更は、コンピューター自体またはコンピューターが保持されている部屋の電気システムで、何らかの電気的問題が発生したことを示している可能性があります。

管理者は、これらの変更を電源状態で監視し、そのような変更を直ちに通知する必要があります。 これにより、デバイスが完全に電源を失う前にアクションを実行できます。 (たとえば、無停電電源装置システムは、シャットダウンする前に 15 分ほどしか実行されない場合があります)。

Win32_PowerManagementEvent クラスを使用して、コンピューターの電源状態の変化を監視できます。 これらの変更には、ある電源から別の電源への切り替えや、コンピューターの電源状態の変更 (たとえば、中断モードの開始または終了) が含まれます。

Win32_PowerManagementEvent クラスには、発生した電源変更イベントの種類を示すために使用される EventType と、一部の元の機器製造元が追加の電源変更イベントを定義するために使用する OEMEventType という 2 つのプロパティしかありません。

Windows電源イベントへの応答の詳細については、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

コンピューター システム ハードウェア クラス

コンピューターの電源状態の変更の監視