이벤트 가입을 취소합니다.

구문

Unregister-Event [-SubscriptionId] <int> [-Force] [-Confirm] [-WhatIf] [<CommonParameters>]

Unregister-Event [-SourceIdentifier] <string> [-Force] [-Confirm] [-WhatIf] [<CommonParameters>]

설명

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

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

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

매개 변수

-Force

Register-ObjectEvent, Register-WmiEvent 및 Register-EngineEvent의 SupportEvent 매개 변수를 사용하여 숨긴 가입을 포함하여 모든 이벤트 가입을 취소합니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-SourceIdentifier <string>

지정된 원본 식별자를 가진 이벤트 가입을 취소합니다.

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

필수 여부

true

위치

1

기본값

파이프라인 입력 적용 여부

true (ByPropertyName)

와일드카드 문자 적용 여부

false

-SubscriptionId <int>

지정된 가입 식별자를 가진 이벤트 가입을 취소합니다.

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

필수 여부

true

위치

1

기본값

파이프라인 입력 적용 여부

true (ByPropertyName)

와일드카드 문자 적용 여부

false

-Confirm

명령을 실행하기 전에 확인 메시지를 표시합니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-WhatIf

명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_Commonparameters.

입력 및 출력

입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.

입력

System.Management.Automation.PSEventSubscriber

Get-EventSubscriber의 출력을 Unregister-Event로 파이프할 수 있습니다.

출력

없음

이 cmdlet은 어떠한 출력도 반환하지 않습니다.

참고

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

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

예 1

C:\PS>unregister-event -sourceIdentifier ProcessStarted

설명
-----------
이 명령은 원본 식별자가 "ProcessStarted"인 이벤트 가입을 취소합니다.

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

예 2

C:\PS>unregister-event -subscriptionId 2

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

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

예 3

C:\PS>get-eventsubscriber -force | unregister-event -force

설명
-----------
이 명령은 세션에서 모든 이벤트 가입을 취소합니다. 

이 명령은 Get-EventSubscriber cmdlet을 사용하여 이벤트 등록 cmdlet의 SupportEvent 매개 변수를 사용하여 숨긴 가입자를 비롯한 세션의 모든 이벤트 가입자 개체를 가져옵니다. 

파이프라인 연산자(|)를 사용하여 가입자 개체를 Unregister-Event로 보내면 이 cmdlet이 세션에서 해당 개체를 삭제합니다. 작업을 완료하려면 Unregister-Event에 Force 매개 변수도 지정해야 합니다.

참고 항목



목차