Get-Event

  • Referência
Módulo:
Microsoft.PowerShell.Utility

Obtém os eventos na fila de eventos.

Syntax

Get-Event
   [[-SourceIdentifier] <String>]
   [<CommonParameters>]
Get-Event
   [-EventIdentifier] <Int32>
   [<CommonParameters>]

Description

O Get-Event cmdlet obtém eventos na fila de eventos do PowerShell para a sessão atual. Você pode obter todos os eventos ou usar o parâmetro EventIdentifier ou SourceIdentifier para especificar os eventos.

Quando ocorre um evento, ele é adicionado à fila de eventos. A fila de eventos inclui eventos para os quais você se registrou, eventos criados usando o cmdlet e o evento que é gerado quando o New-Event PowerShell é encerrado. Você pode usar Get-Event ou Wait-Event obter os eventos.

Esse cmdlet não recebe eventos dos logs do Event Viewer. Para obter esses eventos, use Get-WinEvent ou Get-EventLog.

Exemplos

Exemplo 1: Obter todos os eventos

PS C:\> Get-Event

Esse comando obtém todos os eventos na fila de eventos.

Exemplo 2: Obter eventos por identificador de origem

PS C:\> Get-Event -SourceIdentifier "PowerShell.ProcessCreated"

Esse comando obtém eventos nos quais o valor da propriedade SourceIdentifier é PowerShell.ProcessCreated.

Exemplo 3: Obter um evento com base na hora em que ele foi gerado

PS C:\> $Events = Get-Event
PS C:\> $Events[0] | Format-List -Property *
ComputerName     :
RunspaceId       : c2153740-256d-46c0-a57c-b805917d1b7b
EventIdentifier  : 1
Sender           : System.Management.ManagementEventWatcher
SourceEventArgs  : System.Management.EventArrivedEventArgs
SourceArgs       : {System.Management.ManagementEventWatcher, System.Management.EventArrivedEventArgs}
SourceIdentifier : ProcessStarted
TimeGenerated    : 11/13/2008 12:09:32 PM
MessageData      : PS C:\> Get-Event | Where {$_.TimeGenerated -ge "11/13/2008 12:15:00 PM"}
ComputerName     :
RunspaceId       : c2153740-256d-46c0-a57c-b8059325d1a0
EventIdentifier  : 1
Sender           : System.Management.ManagementEventWatcher
SourceEventArgs  : System.Management.EventArrivedEventArgs
SourceArgs       : {System.Management.ManagementEventWatcher, System.Management.EventArrivedEventArgs}
SourceIdentifier : ProcessStarted
TimeGenerated    : 11/13/2008 12:15:00 PM
MessageData      :

Este exemplo mostra como obter eventos usando propriedades que não sejam SourceIdentifier.

O primeiro comando obtém todos os eventos na fila de eventos e os salva na $Events variável.

O segundo comando usa a notação de matriz para obter o primeiro evento (0-index) na matriz na $Events variável. O comando usa um operador de pipeline (|) para enviar o evento para o Format-List comando, que exibe todas as propriedades do evento em uma lista. Isso permite que você examine as propriedades do objeto de evento.

O terceiro comando mostra como usar o Where-Object cmdlet para obter um evento com base na hora em que ele foi gerado.

Exemplo 4: Obter um evento por seu identificador

PS C:\> Get-Event -EventIdentifier 2

Esse comando obtém o evento com um identificador de evento de 2.

Parâmetros

-EventIdentifier

Especifica os identificadores de eventos para os quais esse cmdlet obtém eventos.

Type:Int32
Aliases:Id
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SourceIdentifier

Especifica identificadores de origem para os quais esse cmdlet obtém eventos. O padrão é todos os eventos da fila de eventos. Caracteres curinga não são permitidos.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Entradas

None

Não é possível canalizar objetos para esse cmdlet.

Saídas

PSEventArgs

Esse cmdlet retorna um objeto PSEventArgs para cada evento. Para ver uma descrição desse objeto, digite Get-Help Get-Event -Full e consulte a seção Anotações do tópico de ajuda.

Observações

Eventos, assinaturas de evento e a fila de eventos existem apenas na sessão atual. Se você fechar a sessão atual, a fila de eventos será descartada e a inscrição do evento será cancelada.

O Get-Event cmdlet retorna um objeto PSEventArgs (System.Management.Automation.PSEventArgs) com as seguintes propriedades:

  • Nome do Computador. O nome do computador no qual o evento ocorreu. Esse valor de propriedade é preenchido somente quando o evento é encaminhado de um computador remoto.

  • RunspaceId. Um GUID que identifica exclusivamente a sessão na qual o evento ocorreu. Esse valor de propriedade é preenchido somente quando o evento é encaminhado de um computador remoto.

  • EventIdentifier. Um inteiro (Int32) que identifica exclusivamente a notificação de eventos na sessão atual.

  • Remetente. O objeto que gerou o evento. No valor do parâmetro Action , a $Sender variável automática contém o objeto sender.

  • SourceEventArgs. O primeiro parâmetro deriva de EventArgs, se ele existir. Por exemplo, em um evento decorrido de timer no qual a assinatura tem o formato Object sender, Timers.ElapsedEventArgs e, a propriedade SourceEventArgs conteria Timers.ElapsedEventArgs. No valor do parâmetro Action , a $EventArgs variável automática contém esse valor.

  • FonteArgs. Todos os parâmetros da assinatura do evento original. Para uma assinatura de evento padrão, $Args[0] representa o remetente e $Args[1] representa o SourceEventArgs. No valor do parâmetro Action , a $Args variável automática contém esse valor.

  • SourceIdentifier. Uma cadeia de caracteres que identifica a inscrição do evento. No valor do parâmetro Action , a propriedade SourceIdentifier da $Event variável automática contém esse valor.

  • TimeGenerated. Um objeto DateTime que representa a hora em que o evento foi gerado. No valor do parâmetro Action , a propriedade TimeGenerated da $Event variável automática contém esse valor.

  • MessageData. Dados associados a inscrição do evento. Os usuários especificam esses dados quando registram um evento. No valor do parâmetro Action , a propriedade MessageData da $Event variável automática contém esse valor.