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 に設定されます。 OEM イベントは、APM BIOS が APM 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 電源イベントへの応答の詳細については、Hey! に関する記事「 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

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

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