Compartilhar via

Get-EventSubscriber

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

Obtém os assinantes do evento na sessão atual.

Sintaxe

Get-EventSubscriber
   [[-SourceIdentifier] <String>]
   [-Force]
   [<CommonParameters>]
Get-EventSubscriber
   [-SubscriptionId] <Int32>
   [-Force]
   [<CommonParameters>]

Description

O cmdlet Get-EventSubscriber obtém os assinantes do evento na sessão atual.

Quando você assina um evento usando um cmdlet de evento Register, um assinante de evento é adicionado à sua sessão do Windows PowerShell e os eventos aos quais você se inscreve são adicionados à fila de eventos sempre que são gerados. Para cancelar uma assinatura de evento, exclua o assinante do evento usando o cmdlet Unregister-Event.

Exemplos

Exemplo 1: Obter o assinante do evento para um evento de temporizador

Este exemplo usa um comando Get-EventSubscriber para obter o assinante do evento para um evento de temporizador.

O primeiro comando usa o cmdlet New-Object para criar uma instância de um objeto de temporizador. Ele salva o novo objeto de temporizador na variável $Timer.

O segundo comando usa o cmdlet Get-Member para exibir os eventos disponíveis para objetos de temporizador. O comando usa o parâmetro Type do cmdlet Get-Member com um valor de Evento.

$Timer = New-Object Timers.Timer
$Timer | Get-Member -Type Event

TypeName: System.Timers.Timer

Name     MemberType Definition
----     ---------- ----------
Disposed Event      System.EventHandler Disposed(System.Object, System.EventArgs)
Elapsed  Event      System.Timers.ElapsedEventHandler Elapsed(System.Object, System.Timers.ElapsedEventArgs)

Register-ObjectEvent -InputObject $Timer -EventName Elapsed -SourceIdentifier Timer.Elapsed
Get-EventSubscriber

SubscriptionId   : 4
SourceObject     : System.Timers.Timer
EventName        : Elapsed
SourceIdentifier : Timer.Elapsed
Action           :
HandlerDelegate  :
SupportEvent     : False
ForwardEvent     : False

O terceiro comando usa o cmdlet Register-ObjectEvent para registrar-se no evento decorrido no objeto do temporizador.

O quarto comando usa o cmdlet Get-EventSubscriber para obter o assinante de evento do evento Elapsed.

Exemplo 2: Usar o módulo dinâmico em PSEventJob na propriedade Action do assinante do evento

Este exemplo mostra como usar o módulo dinâmico no objeto PSEventJob na propriedade Ação do assinante do evento.

O primeiro comando usa o cmdlet New-Object para criar um objeto timer. O segundo comando define o intervalo do temporizador como 500 (milissegundos).

$Timer = New-Object Timers.Timer
$Timer.Interval = 500
$params = @{
    InputObject = $Timer
    EventName = 'Elapsed'
    SourceIdentifier = 'Timer.Random'
    Action = { $Random = Get-Random -Min 0 -Max 100 }
}
Register-ObjectEvent @params

Id  Name           State      HasMoreData  Location  Command
--  ----           -----      -----------  --------  -------
3   Timer.Random   NotStarted False                  $Random = Get-Random ...

$Timer.Enabled = $True
$Subscriber = Get-EventSubscriber -SourceIdentifier Timer.Random
($Subscriber.action).gettype().fullname

System.Management.Automation.PSEventJob

$Subscriber.action | Format-List -Property *

State         : Running
Module        : __DynamicModule_6b5cbe82-d634-41d1-ae5e-ad7fe8d57fe0
StatusMessage :
HasMoreData   : True
Location      :
Command       : $random = Get-Random -Min 0 -Max 100
JobStateInfo  : Running
Finished      : System.Threading.ManualResetEvent
InstanceId    : 88944290-133d-4b44-8752-f901bd8012e2
Id            : 1
Name          : Timer.Random
ChildJobs     : {}
...

& $Subscriber.action.module {$Random}

O terceiro comando usa o cmdlet Register-ObjectEvent para registrar o evento Elapsed do objeto timer. O comando inclui uma ação que manipula o evento. Sempre que o intervalo de temporizador decorrido, um evento é acionado e os comandos na execução da ação. Nesse caso, o cmdlet Get-Random gera um número aleatório entre 0 e 100 e o salva na variável $Random. O identificador de origem do evento é Timer.Random.

Quando você usa um parâmetro Action em um comando Register-ObjectEvent, o comando retorna um objeto PSEventJob que representa a ação.

O quarto comando habilita o temporizador.

O quinto comando usa o cmdlet Get-EventSubscriber para obter o assinante do evento Timer.Random. Ele salva o objeto do assinante de evento na variável $Subscriber.

O sexto comando mostra que a propriedade Action do objeto assinante do evento contém um objeto PSEventJob. Na verdade, ele contém o mesmo objeto PSEventJob que o comando Register-ObjectEvent retornou.

O sétimo comando usa o cmdlet Format-List para exibir todas as propriedades do objeto PSEventJob na propriedade Action em uma lista. O resultado revela que o objeto PSEventJob tem uma propriedade Module que contém um módulo de script dinâmico que implementa a ação.

Os comandos restantes usam o operador de chamada (&) para invocar o comando no módulo e exibir o valor da variável $Random. Você pode usar o operador de chamada para invocar qualquer comando em um módulo, incluindo comandos que não são exportados. Nesse caso, os comandos mostram o número aleatório que está sendo gerado quando o evento Decorrido ocorre.

Para obter mais informações sobre módulos, consulte about_Modules.

Exemplo 3: Obter assinantes de eventos ocultos

Este exemplo registra um assinante de evento para o evento PowerShell.Exiting. A assinatura é registrada usando o parâmetro SupportEvent, que oculta o assinante do evento da saída padrão do cmdlet Get-EventSubscriber. Você deve usar o parâmetro Force para obter todos os assinantes de eventos, incluindo assinantes ocultos.

Register-EngineEvent -SourceIdentifier PowerShell.Exiting -SupportEvent -Action {
    Get-History | Export-Clixml d:\temp\history.clixml
}
Get-EventSubscriber  # No output - must use -Force
Get-EventSubscriber -Force

SubscriptionId   : 1
SourceObject     :
EventName        :
SourceIdentifier : PowerShell.Exiting
Action           : System.Management.Automation.PSEventJob
HandlerDelegate  :
SupportEvent     : True
ForwardEvent     : False

Parâmetros

-Force

Indica que esse cmdlet obtém todos os assinantes de eventos, incluindo assinantes para eventos ocultos usando o parâmetro SupportEvent de Register-ObjectEvent, Register-WmiEvente Register-EngineEvent.

Tipo:SwitchParameter
Cargo:1
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SourceIdentifier

Especifica o SourceIdentifier valor da propriedade que obtém apenas os assinantes do evento. Por padrão, Get-EventSubscriber obtém todos os assinantes de eventos na sessão. Curingas não são permitidos. Esse parâmetro diferencia maiúsculas de minúsculas.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-SubscriptionId

Especifica o identificador de assinatura que esse cmdlet obtém. Por padrão, Get-EventSubscriber obtém todos os assinantes de eventos na sessão.

Tipo:Int32
Aliases:Id
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

None

Você não pode redirecionar objetos para este cmdlet.

Saídas

PSEventSubscriber

Esse cmdlet retorna um objeto PSEventSubscriber para cada assinante de evento.

Observações

O cmdlet New-Event, que cria um evento personalizado, não gera um assinante. Portanto, o cmdlet Get-EventSubscriber não encontrará um objeto assinante para esses eventos. No entanto, se você usar o cmdlet Register-EngineEvent para assinar um evento personalizado (para encaminhar o evento ou especificar uma ação), Get-EventSubscriber encontrará o assinante que Register-EngineEvent gerar.

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 assinatura do evento será cancelada.