Classe Win32_PowerManagementEvent
La classe WMI Win32_PowerManagementEvent représente les événements de gestion de l’alimentation résultant des changements d’état d’alimentation. Ces changements d’état sont associés aux protocoles de gestion de l’alimentation avancée (APM) ou acpi (Advanced Configuration and Power Interface).
La syntaxe suivante est simplifiée par rapport au code MOF (Managed Object Format) et inclut toutes les propriétés héritées. Les propriétés sont répertoriées dans l’ordre alphabétique, et non dans l’ordre MOF.
Syntaxe
[UUID("{86460B6B-E709-11d2-B139-00105A1F77A1}"), AMENDMENT]
class Win32_PowerManagementEvent : __ExtrinsicEvent
{
uint8 SECURITY_DESCRIPTOR[];
uint64 TIME_CREATED;
uint16 EventType;
uint16 OEMEventCode;
};
Membres
La classe Win32_PowerManagementEvent comporte les types de membres suivants :
Propriétés
La classe Win32_PowerManagementEvent a ces propriétés.
-
EventType
-
-
Type de données : uint16
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32API| Événements de gestion de l’alimentation »)
Type de modification de l’état d’alimentation du système.
-
-
Entrée suspend (4)
-
Pendant la suspension, l’ordinateur semble désactivé ; Toutefois, il peut être « réveillé » en réponse à divers événements, y compris l’entrée de l’utilisateur (comme le déplacement de la souris ou l’appui sur une touche du clavier). Pendant la suspension de l’ordinateur, la consommation d’énergie est réduite à l’un des différents niveaux en fonction de la façon dont le système doit être utilisé. Plus le niveau de consommation d’énergie est faible, plus le système prend de temps pour revenir à l’état de fonctionnement. Lorsque l’ordinateur passe à l’état de suspension, le bureau est verrouillé et vous devez appuyer sur Ctrl+Alt+Suppr et fournir un nom d’utilisateur et un mot de passe valides pour reprendre les opérations
-
Reprendre de suspendre (7)
-
Indique qu’un message Resume from Suspend a été envoyé, ce qui permet à l’ordinateur de revenir à son état d’alimentation normal.
-
Changement d’état d’alimentation (10)
-
Indique un changement dans le status d’alimentation de l’ordinateur, par exemple un passage de l’alimentation de la batterie à l’alimentation secteur, ou du secteur à une alimentation sans interruption. Le système diffuse également cet événement lorsque la puissance de la batterie devient inférieure au seuil spécifié par l'utilisateur ou change selon un pourcentage spécifié.
-
Événement OEM (11)
-
Indique qu’un BIOS de gestion avancée de l’alimentation (APM) a envoyé un événement OEM. La valeur de l’événement sera capturée dans la propriété OEMEventCode . Étant donné que certaines implémentations du BIOS APM ne fournissent pas de notifications d’événements OEM, cet événement peut ne jamais être diffusé sur certains ordinateurs. APM est un schéma de gestion de l’alimentation hérité. Bien que toujours pris en charge, APM a été largement remplacé par ACPI (Advanced Configuration and Power Interface).
-
Reprendre automatiquement (18)
-
Indique que l’ordinateur s’est réveillé en réponse à un événement. Si le système détecte l’activité de l’utilisateur (par exemple, un clic de souris), le message ResumeSuspend est diffusé, indiquant aux applications qu’elles peuvent reprendre une interactivité complète avec l’utilisateur.
OEMEventCode
-
Type de données : uint16
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32API| Événements de gestion de l’alimentation »)
État d’alimentation du système défini par le fabricant de l’équipement d’origine (OEM) lorsque la propriété EventType de cette classe a la valeur 11 (événement OEM) ; sinon, cette propriété est définie sur NULL. Les événements OEM sont générés lorsqu’un BIOS APM signale un événement OEM APM. Les codes d’événement OEM se trouvent entre 0x0200h et 0x02FFh.
SECURITY_DESCRIPTOR
-
Type de données : tableau uint8
-
Type d'accès : Lecture seule
Descripteur utilisé par le fournisseur d’événements pour déterminer quels utilisateurs peuvent recevoir l’événement. Cette propriété provient de __Event. Pour plus d’informations sur les constantes utilisées pour définir ce descripteur de sécurité, consultez Constantes de sécurité WMI.
TIME_CREATED
-
Type de données : uint64
-
Type d'accès : Lecture seule
Valeur unique qui indique l’heure à laquelle l’événement a été généré. Il s’agit d’une valeur 64 bits représentant le nombre d’intervalles de 100 nanosecondes depuis le 1er janvier 1601. Les informations sont au format UTC (Temps universel coordonné).
Cette propriété provient de __Event.
Pour plus d’informations sur l’utilisation de valeurs uint64 dans des scripts, voir Scripts dans WMI.
Notes
La classe Win32_PowerManagementEvent est dérivée de __ExtrinsicEvent.
Les changements dans les status d’alimentation indiquent souvent qu’un problème s’est produit avec un ordinateur ou un autre appareil géré. Si un serveur passe soudainement de l’alimentation secteur à une alimentation sans interruption, ce changement peut indiquer qu’un problème électrique quelconque s’est produit, soit avec l’ordinateur lui-même, soit avec le système électrique dans la pièce dans laquelle l’ordinateur est conservé.
Les administrateurs doivent surveiller ces modifications dans power status et être immédiatement avertis de ces modifications. Cela leur permet d’agir avant que l’appareil ne perde complètement de l’alimentation. (Les systèmes d’alimentation sans interruption, par exemple, peuvent s’exécuter pendant environ 15 minutes avant de s’arrêter.)
La classe Win32_PowerManagementEvent peut être utilisée pour surveiller les changements de status d’alimentation sur un ordinateur. Ces modifications peuvent inclure un passage d’une source d’alimentation à une autre, ainsi qu’un changement de l’état d’alimentation de l’ordinateur (par exemple, l’entrée ou la sortie du mode Suspension).
La classe Win32_PowerManagementEvent a seulement deux propriétés : EventType, utilisé pour indiquer le type d’événement de changement d’alimentation qui s’est produit, et OEMEventType, qui est utilisé par certains fabricants d’équipement d’origine pour définir des événements de changement d’alimentation supplémentaires.
Pour plus d’informations sur la réponse aux événements d’alimentation Windows, consultez l’article Surveiller et répondre aux événements Windows Power avec PowerShell sur hey! Scripting Guy! .
Exemples
Le code VBScript suivant surveille les changements de status d’alimentation sur un ordinateur.
Set colMonitoredEvents = GetObject("winmgmts:")._
ExecNotificationQuery("SELECT * FROM Win32_PowerManagementEvent")
Do
Set strLatestEvent = colMonitoredEvents.NextEvent
Wscript.Echo strLatestEvent.EventType
Loop
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista |
| Serveur minimal pris en charge |
Windows Server 2008 |
| Espace de noms |
Racine\CIMV2 |
| MOF |
|
| DLL |
|
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour