다음을 통해 공유

Unregister-Event

  • 참조
모듈:
Microsoft.PowerShell.Utility

이벤트 구독을 취소합니다.

Syntax

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

Description

cmdlet은 Unregister-Event , Register-ObjectEvent또는 Register-WmiEvent cmdlet을 사용하여 만든 이벤트 구독을 Register-EngineEvent취소합니다.

이벤트 구독이 취소되면 이벤트 구독자가 세션에서 삭제되고 구독된 이벤트가 더 이상 이벤트 큐에 추가되지 않습니다. cmdlet을 사용하여 만든 이벤트에 대한 구독을 New-Event 취소하면 새 이벤트도 세션에서 삭제됩니다.

Unregister-Event 는 이벤트 큐에서 이벤트를 삭제하지 않습니다. 이벤트를 삭제하려면 cmdlet을 Remove-Event 사용합니다.

예제

예제 1: 원본 식별자별 이벤트 구독 취소

이 명령은 ProcessStarted의 원본 식별자가 있는 이벤트 구독을 취소합니다.

Unregister-Event -SourceIdentifier "ProcessStarted"

이벤트의 원본 식별자를 찾으려면 cmdlet을 Get-Event 사용합니다. 이벤트 구독의 원본 식별자를 찾으려면 cmdlet을 Get-EventSubscriber 사용합니다.

예제 2: 구독 식별자별 이벤트 구독 취소

이 명령은 가입 식별자가 2인 이벤트 구독을 취소합니다.

Unregister-Event -SubscriptionId 2

이벤트 구독의 구독 식별자를 찾으려면 cmdlet을 Get-EventSubscriber 사용합니다.

예제 3: 모든 이벤트 구독 취소

이 예제에서는 세션의 모든 이벤트 구독을 취소합니다.

Get-EventSubscriber -Force | Unregister-Event -Force

Force 매개 변수를 Get-EventSubscriber 사용하여 숨겨진 구독자를 포함하여 세션의 모든 이벤트 구독자 개체를 가져옵니다. 출력은 세션에서 구독자를 삭제하는 파이프로 파이프 Unregister-Event됩니다. Force 매개 변수는 숨겨진 구독자를 제거하는 데 필요합니다Unregister-Event.

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

형식:SwitchParameter
Aliases:cf
Position:Named
기본값:False
필수:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

의 SupportEvent 매개 변수Register-WmiEventRegister-ObjectEvent를 사용하여 숨겨진 구독을 포함하여 모든 이벤트 구독을 취소합니다Register-EngineEvent.

형식:SwitchParameter
Position:Named
기본값:None
필수:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceIdentifier

이 cmdlet이 이벤트 구독을 취소하는 원본 식별자를 지정합니다.

SourceIdentifier 또는 SubscriptionId 매개 변수는 모든 명령에 포함되어야 합니다.

형식:String
Position:0
기본값:None
필수:True
Accept pipeline input:True
Accept wildcard characters:False

-SubscriptionId

이 cmdlet이 이벤트 구독을 취소하는 원본 식별자 ID를 지정합니다.

SourceIdentifier 또는 SubscriptionId 매개 변수는 모든 명령에 포함되어야 합니다.

형식:Int32
Position:0
기본값:None
필수:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

형식:SwitchParameter
Aliases:wi
Position:Named
기본값:False
필수:False
Accept pipeline input:False
Accept wildcard characters:False

입력

PSEventSubscriber

출력을 이 cmdlet으로 Get-EventSubscriber 파이프할 수 있습니다.

출력

None

이 cmdlet은 출력을 반환하지 않습니다.

참고

이벤트, 이벤트 구독 및 이벤트 큐는 현재 세션에만 존재합니다. 현재 세션을 닫으면 이벤트 큐가 삭제되고 이벤트 구독이 취소됩니다.

Unregister-Event 는 cmdlet을 New-Event 사용하여 이벤트를 구독하지 않는 한 cmdlet을 사용하여 Register-EngineEvent 만든 이벤트를 삭제할 수 없습니다. 세션에서 사용자 지정 이벤트를 삭제하려면 프로그래밍 방식으로 제거하거나 세션을 닫아야 합니다.