Partilhar via

Unregister-Event

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

Cancela uma assinatura de evento.

Syntax

Unregister-Event
          [-SourceIdentifier] <String>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]
Unregister-Event
          [-SubscriptionId] <Int32>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]

Description

O Unregister-Event cmdlet cancela uma assinatura de evento que foi criada usando o Register-EngineEventRegister-ObjectEvent, ou Register-WmiEvent cmdlet.

Quando uma assinatura de evento é cancelada, o assinante do evento é excluído da sessão e os eventos inscritos não são mais adicionados à fila de eventos. Quando você cancela uma assinatura de um evento criado usando o New-Event cmdlet, o novo evento também é excluído da sessão.

Unregister-Event não exclui eventos da fila de eventos. Para excluir eventos, use o Remove-Event cmdlet.

Exemplos

Exemplo 1: Cancelar uma assinatura de evento por identificador de origem

Este comando cancela a assinatura de evento que tem um identificador de origem de ProcessStarted.

Unregister-Event -SourceIdentifier "ProcessStarted"

Para localizar o identificador de origem de um evento, use o Get-Event cmdlet. Para localizar o identificador de origem de uma assinatura de evento, use o Get-EventSubscriber cmdlet

Exemplo 2: Cancelar uma assinatura de evento por identificador de assinatura

Este comando cancela a subscrição de eventos que tem um identificador de subscrição de 2.

Unregister-Event -SubscriptionId 2

Para localizar o identificador de assinatura de uma assinatura de evento, use o Get-EventSubscriber cmdlet.

Exemplo 3: Cancelar todas as subscrições de eventos

Este exemplo cancela todas as assinaturas de eventos na sessão.

Get-EventSubscriber -Force | Unregister-Event -Force

Usando o parâmetro Force com Get-EventSubscriber obtém todos os objetos de assinante de evento na sessão, incluindo os assinantes que estão ocultos. A saída é canalizada para Unregister-Event, o que exclui os assinantes da sessão. O parâmetro Force é necessário para Unregister-Event remover todos os assinantes ocultos.

Parâmetros

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
valor predefinido:False
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Cancela todas as assinaturas de eventos, incluindo assinaturas que estavam ocultas usando o parâmetro SupportEvent de Register-ObjectEvent, Register-WmiEvente Register-EngineEvent.

Tipo:SwitchParameter
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceIdentifier

Especifica um identificador de origem que esse cmdlet cancela assinaturas de eventos.

Um parâmetro SourceIdentifier ou SubscriptionId deve ser incluído em cada comando.

Tipo:String
Position:0
valor predefinido:None
Necessário:True
Accept pipeline input:True
Accept wildcard characters:False

-SubscriptionId

Especifica uma ID de identificador de origem que esse cmdlet cancela assinaturas de eventos.

Um parâmetro SourceIdentifier ou SubscriptionId deve ser incluído em cada comando.

Tipo:Int32
Position:0
valor predefinido:None
Necessário:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
valor predefinido:False
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

PSEventSubscriber

Você pode canalizar a saída Get-EventSubscriber para este cmdlet.

Saídas

None

Este cmdlet não retorna nenhuma saída.

Notas

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

Unregister-Event Não é possível excluir eventos criados usando o cmdlet, a New-Event menos que você tenha se inscrito no evento usando o Register-EngineEvent cmdlet. Para excluir um evento personalizado da sessão, você deve removê-lo programaticamente ou fechar a sessão.