Win32_PowerManagementEvent-Klasse
Die Win32_PowerManagementEventWMI-Klasse stellt Energieverwaltungsereignisse dar, die sich aus Energiezustandsänderungen 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;
};
Member
Die Win32_PowerManagementEvent-Klasse verfügt über folgende Membertypen:
Eigenschaften
Die Win32_PowerManagementEvent-Klasse verfügt über diese Eigenschaften.
-
EventType
-
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("Win32API| Energieverwaltungsereignisse")
Typ der Änderung im Systemleistungszustand.
-
-
Eingabe von Suspend (4)
-
Während er angehalten ist, scheint der Computer ausgeschaltet zu sein. es kann jedoch als Reaktion auf verschiedene Ereignisse "aktiviert" 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 auf eine von mehreren Ebenen reduziert, je nachdem, wie das System verwendet werden soll. Je niedriger der Stromverbrauch, desto mehr Zeit benötigt das System, um in den Betriebszustand zurückzukehren. Wenn der Computer in den Anhaltezustand wechselt, ist der Desktop gesperrt, und Sie müssen STRG+ALT+ENTF drücken und einen gültigen Benutzernamen und ein gültiges Kennwort angeben, um den Vorgang fortzusetzen.
-
Fortsetzen aus Anhalten (7)
-
Gibt an, dass eine Nachricht Vom Anhalten fortsetzen gesendet wurde, sodass der Computer in seinen normalen Energiezustand zurückkehren kann.
-
Energiestatusänderung (10)
-
Gibt eine Änderung der Status des Computers an, z. B. einen Wechsel von Akkustrom zu Wechselstrom oder von Wechselstrom zu einer unterbrechungsfreien 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 APM-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 Legacy-Energieverwaltungsschema. Obwohl noch unterstützt, wurde APM weitgehend von ACPI (Advanced Configuration and Power Interface) abgelöst.
-
Automatisches Fortsetzen (18)
-
Gibt an, dass der Computer als Reaktion auf ein Ereignis erwacht ist. Wenn das System Benutzeraktivitäten erkennt (z. B. ein Mausklick), wird die ResumeSuspend-Nachricht gesendet, sodass Anwendungen wissen, dass sie die volle Interaktivität mit dem Benutzer fortsetzen können.
OEMEventCode
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("Win32API| Energieverwaltungsereignisse")
Vom Originalgerätehersteller (OEM) definierte Systemleistungszustand, wenn die EventType-Eigenschaft dieser Klasse auf 11 festgelegt ist (OEM-Ereignis); 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.
SECURITY_DESCRIPTOR
-
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 __Event geerbt. Weitere Informationen zu Konstanten, die zum Festlegen dieses Sicherheitsdeskriptors 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 der Intervalle von 100 Nanosekunden nach dem 1. Januar 1601 darstellt. Die Informationen haben das UTC-Format (Coordinated Universal Times).
Diese Eigenschaft wird von __Event geerbt.
Weitere Informationen zur Verwendung von uint64-Werten in Skripts finden Sie unter Skripterstellung in WMI.
Bemerkungen
Die Win32_PowerManagementEvent-Klasse wird von __ExtrinsicEvent abgeleitet.
Änderungen an der Energie status häufig darauf hindeuten, dass ein Problem mit einem Computer oder einem anderen verwalteten Gerät aufgetreten ist. Wenn ein Server plötzlich vom Wechselstrom zu einer unterbrechungsfreien Stromversorgung wechselt, kann diese Änderung darauf hindeuten, dass ein elektrisches Problem aufgetreten ist, entweder mit dem Computer selbst oder mit der elektrischen Anlage in dem Raum, in dem der Computer gehalten wird.
Administratoren müssen diese Änderungen in power status überwachen und über solche Änderungen sofort benachrichtigt werden. Dies ermöglicht es ihnen, Maßnahmen zu ergreifen, bevor das Gerät vollständig an Strom verliert. (Unterbrechungsfreie Stromversorgungssysteme können beispielsweise nur 15 Minuten oder so ausgeführt werden, bevor sie heruntergefahren werden.)
Die Win32_PowerManagementEvent-Klasse kann verwendet werden, um Änderungen in power status auf einem Computer zu überwachen. Diese Änderungen können einen Wechsel von einer Stromquelle zu einer anderen sowie eine Änderung des Energiezustands des Computers (z. B. in den oder das Beenden des Ruhezustands) umfassen.
Die Win32_PowerManagementEvent-Klasse verfügt nur über zwei Eigenschaften: EventType, das verwendet wird, um den Typ des aufgetretenen Energiewechselereignisses anzugeben, und OEMEventType, das von einigen Originalgeräteherstellern verwendet wird, um zusätzliche Leistungswechselereignisse zu definieren.
Weitere Informationen zum Reagieren auf Windows Power-Ereignisse finden Sie im Artikel Überwachen und Reagieren auf Windows Power-Ereignisse mit PowerShell unter Hey! Scripting Guy! .
Beispiele
Mit dem folgenden VBScript werden Änderungen in der Energieversorgung status auf einem Computer überwacht.
Set colMonitoredEvents = GetObject("winmgmts:")._
ExecNotificationQuery("SELECT * FROM Win32_PowerManagementEvent")
Do
Set strLatestEvent = colMonitoredEvents.NextEvent
Wscript.Echo strLatestEvent.EventType
Loop
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
WindowsServer 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|
Siehe auch