Classe Win32_PowerManagementEvent
A classe WMIWin32_PowerManagementEvent representa eventos de gerenciamento de energia resultantes de alterações de estado de energia. Essas alterações de estado estão associadas ao APM (Gerenciamento Avançado de Energia) ou aos protocolos de gerenciamento do sistema ACPI (Advanced Configuration and Power Interface).
A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as propriedades herdadas. As propriedades são listadas em ordem alfabética, não em ordem MOF.
Sintaxe
[UUID("{86460B6B-E709-11d2-B139-00105A1F77A1}"), AMENDMENT]
class Win32_PowerManagementEvent : __ExtrinsicEvent
{
uint8 SECURITY_DESCRIPTOR[];
uint64 TIME_CREATED;
uint16 EventType;
uint16 OEMEventCode;
};
Membros
A classe Win32_PowerManagementEvent tem estes tipos de membros:
Propriedades
A classe Win32_PowerManagementEvent tem essas propriedades.
-
EventType
-
-
Tipo de dados: uint16
-
Tipo de acesso: Somente leitura
-
Qualificadores: MappingStrings ("Win32API| Eventos de gerenciamento de energia")
Tipo de alteração no estado de energia do sistema.
-
-
Inserindo suspensão (4)
-
Enquanto suspenso, o computador parece estar desativado; no entanto, ele pode ser "despertado" em resposta a vários eventos, incluindo a entrada do usuário (como mover o mouse ou pressionar uma tecla no teclado). Enquanto o computador está suspenso, o consumo de energia é reduzido a um dos vários níveis, dependendo de como o sistema deve ser usado. Quanto menor o nível de consumo de energia, mais tempo o sistema leva para retornar ao estado de trabalho. Quando o computador entra no estado de suspensão, a área de trabalho é bloqueada e você deve pressionar CTRL+ALT+DELETE e fornecer um nome de usuário e senha válidos para retomar as operações
-
Retomar da Suspensão (7)
-
Indica que uma mensagem Retomar da Suspensão foi enviada, permitindo que o computador retorne ao seu estado de energia regular.
-
Alteração de status de energia (10)
-
Indica uma alteração na status de energia do computador, como uma mudança da energia da bateria para o AC ou de UMA fonte de alimentação ininterrupta. O sistema também transmite esse evento quando a energia restante da bateria fica abaixo do limite especificado pelo usuário ou se a energia da bateria for alterada em um percentual especificado.
-
Evento OEM (11)
-
Indica que um BIOS do APM (Gerenciamento Avançado de Energia) enviou um evento OEM. O valor do evento será capturado na propriedade OEMEventCode . Como algumas implementações do BIOS do APM não fornecem notificações de evento OEM, esse evento pode nunca ser transmitido em alguns computadores. O APM é um esquema de gerenciamento de energia herdado. Embora ainda tenha suporte, o APM foi substituído em grande parte pelo ACPI (Configuração Avançada e Interface do Power).
-
Retomar Automático (18)
-
Indica que o computador despertou em resposta a um evento. Se o sistema detectar a atividade do usuário (como um clique do mouse), a mensagem ResumeSuspend será transmitida, informando aos aplicativos que eles podem retomar a interatividade total com o usuário.
OEMEventCode
-
Tipo de dados: uint16
-
Tipo de acesso: Somente leitura
-
Qualificadores: MappingStrings ("Win32API| Eventos de gerenciamento de energia")
Estado de energia do sistema definido pelo fabricante do equipamento original (OEM) quando a propriedade EventType dessa classe é definida como 11 (Evento OEM); caso contrário, essa propriedade será definida como NULL. Os eventos OEM são gerados quando um BIOS do APM sinaliza um evento OEM do APM. Os códigos de evento OEM estão no intervalo de 0x0200h a 0x02FFh.
SECURITY_DESCRIPTOR
-
Tipo de dados: matriz uint8
-
Tipo de acesso: Somente leitura
Descritor usado pelo provedor de eventos para determinar quais usuários podem receber o evento. Essa propriedade é herdada de __Event. Para obter mais informações sobre constantes usadas para definir esse descritor de segurança, consulte Constantes de segurança WMI.
TIME_CREATED
-
Tipo de dados: uint64
-
Tipo de acesso: Somente leitura
Valor exclusivo que indica a hora em que o evento foi gerado. Esse é um valor de 64 bits que representa o número de intervalos de 100 nanossegundos após 1º de janeiro de 1601. As informações estão no formato UTC (Tempos Universais Coordenados).
Essa propriedade é herdada de __Event.
Para obter mais informações sobre como usar valores uint64 em scripts, consulte Scripts no WMI.
Comentários
A classe Win32_PowerManagementEvent é derivada de __ExtrinsicEvent.
As alterações no status de energia geralmente indicam que ocorreu um problema com um computador ou com outro dispositivo gerenciado. Se um servidor mudar repentinamente da energia ac para uma fonte de alimentação ininterrupta, essa alteração poderá indicar que ocorreu um problema elétrico de algum tipo, seja com o próprio computador ou com o sistema elétrico na sala em que o computador é mantido.
Os administradores precisam monitorar essas alterações no power status e ser notificados sobre essas alterações imediatamente. Isso permite que eles tomem medidas antes que o dispositivo perca totalmente a energia. (Sistemas de fonte de alimentação ininterrupta, por exemplo, podem ser executados por apenas 15 minutos ou mais antes de desligar.)
A classe Win32_PowerManagementEvent pode ser usada para monitorar alterações na status de energia em um computador. Essas alterações podem incluir uma opção de uma fonte de alimentação para outra, bem como uma alteração no estado de energia do computador (por exemplo, entrar ou sair do modo Suspender).
A classe Win32_PowerManagementEvent tem apenas duas propriedades: EventType, usada para indicar o tipo de evento de alteração de energia que ocorreu, e OEMEventType, que é usado por alguns fabricantes de equipamentos originais para definir eventos adicionais de alteração de energia.
Para obter mais informações sobre como responder a eventos do Windows Power, consulte o artigo Monitorar e responder a eventos do Windows Power com o PowerShell no Hey! O cara do script! blog.
Exemplos
O VBScript a seguir monitora as alterações na status de energia em um computador.
Set colMonitoredEvents = GetObject("winmgmts:")._
ExecNotificationQuery("SELECT * FROM Win32_PowerManagementEvent")
Do
Set strLatestEvent = colMonitoredEvents.NextEvent
Wscript.Echo strLatestEvent.EventType
Loop
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|
Confira também