Win32 _ PowerManagementEvent-Klasse

Die WMI-Klasse Win32 _ PowerManagementEvent stellt Energieverwaltungsereignisse dar, die sich aus Änderungen des Energiezustands ergeben. Diese Zustandsänderungen sind entweder mit den Systemverwaltungsprotokollen Advanced Power Management (APM) oder Advanced Configuration and Power Interface (ACPI) verknüpft.

Die folgende Syntax wurde aus MOF-Code (Managed Object Format, verwaltetes Objektformat) vereinfacht und enthält alle geerbten Eigenschaften. Eigenschaften werden in alphabetischer Reihenfolge und nicht in MOF-Reihenfolge aufgeführt.

Syntax

[UUID("{86460B6B-E709-11d2-B139-00105A1F77A1}"), AMENDMENT]
class Win32_PowerManagementEvent : __ExtrinsicEvent
{
  uint8  SECURITY_DESCRIPTOR[];
  uint64 TIME_CREATED;
  uint16 EventType;
  uint16 OEMEventCode;
};

Members

Die Win32 _ PowerManagementEvent-Klasse verfügt über folgende Typen von Membern:

Eigenschaften

Die Win32 _ PowerManagementEvent-Klasse verfügt über diese Eigenschaften.

EventType

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API-Energieverwaltungsereignisse") |

Änderungstyp im Energiezustand des Systems.

Eingabe von Anhalten (4)

Während der Unterbrechung scheint der Computer ausgeschaltet zu sein. sie kann jedoch als Reaktion auf verschiedene Ereignisse "aufgeweckt" werden, einschließlich Benutzereingaben (z. B. Bewegen der Maus oder Drücken einer Taste auf der Tastatur). Während der Computer angehalten ist, wird der Stromverbrauch abhängig von der Verwendung des Systems auf eine von mehreren Ebenen reduziert. Je niedriger der Energieverbrauch ist, desto mehr Zeit benötigt das System, um in den Betriebszustand zurückzukehren. Wenn der Computer in den Zustand "Anhalten" wechselt, ist der Desktop gesperrt, und Sie müssen STRG+ALT+DELETE drücken und einen gültigen Benutzernamen und ein kennwort angeben, um vorgänge fortzusetzen.

Fortsetzen von "Anhalten" (7)

Gibt an, dass eine Nachricht resume from Suspend (Aus Anhalten fortsetzen) gesendet wurde, sodass der Computer wieder in den normalen Energiezustand versetzt werden kann.

Energiestatusänderung (10)

Gibt eine Änderung des Energiestatus des Computers an, z. B. einen Wechsel vom Akkubetrieb zum Netzbetrieb oder vom Wechselstrom in eine unterbrechungsfreie Stromversorgung. Das System leitet dieses Ereignis auch dann weiter, wenn die verbleibende Akkuleistung unter einen vom Benutzer festgelegten Wert sinkt oder sich um einen angegebenen Prozentsatz ändert.

OEM-Ereignis (11)

Gibt an, dass ein-BIOS (Advanced Power Management) ein OEM-Ereignis gesendet hat. Der Wert des Ereignisses wird in der OEMEventCode-Eigenschaft erfasst. Da einige APM-BIOS-Implementierungen keine OEM-Ereignisbenachrichtigungen bereitstellen, wird dieses Ereignis möglicherweise nie auf einigen Computern übertragen. APM ist ein älteres Energieverwaltungsschema. Obwohl APM weiterhin unterstützt wird, wurde es größtenteils durch ACPI (Advanced Configuration and Power Interface) abgelöst.

Automatische Fortsetzung (18)

Gibt an, dass der Computer als Reaktion auf ein Ereignis ausgelöst wurde. Wenn das System Benutzeraktivitäten erkennt (z. B. einen Mausklick), wird die ResumeSuspend-Nachricht gesendet, sodass Anwendungen wissen, dass sie die vollständige Interaktivität mit dem Benutzer fortsetzen können.

OEMEventCode

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API-Energieverwaltungsereignisse") |

Systemstromzustand, der vom Originalgerätehersteller (ORIGINAL EQUIPMENT MANUFACTURER, OEM) definiert wird, wenn die EventType-Eigenschaft dieser Klasse auf 11 (OEM-Ereignis) festgelegt ist; Andernfalls wird diese Eigenschaft auf NULL festgelegt. OEM-Ereignisse werden generiert, wenn ein APM-BIOS ein APM-OEM-Ereignis signalisiert. OEM-Ereigniscodes liegen im Bereich von 0x0200h bis 0x02FFh.

_SICHERHEITSBESCHREIBUNG

Datentyp: uint8-Array

Zugriffstyp: Schreibgeschützt

Deskriptor, der vom Ereignisanbieter verwendet wird, um zu bestimmen, welche Benutzer das Ereignis empfangen können. Diese Eigenschaft wird von _ _ Ereignisgeerbt. Weitere Informationen zu Konstanten, die zum Festlegen dieser Sicherheitsbeschreibung verwendet werden, finden Sie unter WMI-Sicherheitskonstanten.

TIME _ CREATED

Datentyp: uint64

Zugriffstyp: Schreibgeschützt

Eindeutiger Wert, der den Zeitpunkt angibt, zu dem das Ereignis generiert wurde. Dies ist ein 64-Bit-Wert, der die Anzahl von 100-Nanosekunden-Intervallen nach dem 1. Januar 1601 darstellt. Die Informationen liegen im UTC-Format (Coordinated Universal Times) vor.

Diese Eigenschaft wird von _ _ Ereignisgeerbt.

Weitere Informationen zur Verwendung von uint64-Werten in Skripts finden Sie unter Skripterstellung in WMI.

Bemerkungen

Die Win32 _ PowerManagementEvent-Klasse wird von _ _ ExtrinsicEventabgeleitet.

Änderungen am Energiestatus weisen häufig darauf hin, dass ein Problem mit einem Computer oder einem anderen verwalteten Gerät aufgetreten ist. Wenn ein Server plötzlich von der Stromversorgung in eine unterbrechungsfreie Stromversorgung wechselt, kann diese Änderung darauf hindeuten, dass ein elektrisches Problem aufgetreten ist, entweder mit dem Computer selbst oder mit dem elektrischen System in dem Raum, in dem sich der Computer befindet.

Administratoren müssen diese Änderungen im Energiestatus überwachen und sofort über solche Änderungen benachrichtigt werden. Dadurch können sie Maßnahmen ergreifen, bevor das Gerät vollständig aus dem Netz geht. (Unterbrechungsfreie Stromversorgungssysteme können z. B. nur 15 Minuten lang ausgeführt werden, bevor sie heruntergefahren werden.)

Die Win32 _ PowerManagementEvent-Klasse kann verwendet werden, um Änderungen im Energiestatus auf einem Computer zu überwachen. Diese Änderungen können einen Wechsel von einer Stromquelle zu einer anderen sowie eine Änderung des Energiezustands des Computers umfassen (z. B. das Ein- oder Beenden des Unterbrechungsmodus).

Die Win32 _ PowerManagementEvent-Klasse verfügt nur über zwei Eigenschaften: EventType, das verwendet wird, um den Typ des aufgetretenen Energieänderungsereignisses anzugeben, und OEMEventType, der von einigen Originalgeräteherstellern verwendet wird, um zusätzliche Energieänderungsereignisse zu definieren.

Weitere Informationen zum Reagieren auf Windows Energieereignisse finden Sie im Artikel Überwachen und Reagieren auf Windows Power Events mit PowerShell auf hey! Scripting Guy! .

Beispiele

Mit dem folgenden VBScript-Code werden Änderungen am Energiestatus auf einem Computer überwacht.

Set colMonitoredEvents = GetObject("winmgmts:")._
 ExecNotificationQuery("SELECT * FROM Win32_PowerManagementEvent")
Do
 Set strLatestEvent = colMonitoredEvents.NextEvent
 Wscript.Echo strLatestEvent.EventType
Loop

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista
Unterstützte Mindestversion (Server)
Windows Server 2008
Namespace
Stamm \ CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Weitere Informationen

__ExtrinsicEvent

Hardwareklassen für Computersysteme

Überwachen von Änderungen im Computerstromstatus