Unregister-Event
이벤트 구독을 취소합니다.
구문
BySource (기본값)
Unregister-Event
[-SourceIdentifier] <String>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ById
Unregister-Event
[-SubscriptionId] <Int32>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Unregister-Event cmdlet은 Register-EngineEvent, Register-ObjectEvent또는 Register-WmiEvent cmdlet을 사용하여 만든 이벤트 구독을 취소합니다.
이벤트 구독이 취소되면 이벤트 구독자가 세션에서 삭제되고 구독된 이벤트가 더 이상 이벤트 큐에 추가되지 않습니다.
New-Event cmdlet을 사용하여 만든 이벤트에 대한 구독을 취소하면 새 이벤트도 세션에서 삭제됩니다.
Unregister-Event 이벤트 큐에서 이벤트를 삭제하지 않습니다. 이벤트를 삭제하려면 Remove-Event cmdlet을 사용합니다.
예제
예제 1: 원본 식별자별 이벤트 구독 취소
이 명령은 ProcessStarted의 원본 식별자가 있는 이벤트 구독을 취소합니다.
Unregister-Event -SourceIdentifier "ProcessStarted"
이벤트의 원본 식별자를 찾으려면 Get-Event cmdlet을 사용합니다. 이벤트 구독의 원본 식별자를 찾으려면 Get-EventSubscriber cmdlet을 사용합니다.
예제 2: 구독 식별자별 이벤트 구독 취소
이 명령은 구독 식별자가 2인 이벤트 구독을 취소합니다.
Unregister-Event -SubscriptionId 2
이벤트 구독의 구독 식별자를 찾으려면 Get-EventSubscriber cmdlet을 사용합니다.
예제 3: 모든 이벤트 구독 취소
이 예제에서는 세션의 모든 이벤트 구독을 취소합니다.
Get-EventSubscriber -Force | Unregister-Event -Force
세션의 모든 이벤트 구독자 객체를, 숨겨진 구독자를 포함하여, 가져오려면 Get-EventSubscriber 매개 변수를 사용하세요. 출력은 Unregister-Event으로 전달되어, 세션에서 구독자를 삭제합니다. 숨겨진 구독자를 제거하려면 에서 Unregister-Event 매개 변수가 필요합니다.
매개 변수
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | False |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | cf(cf) |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Force
, Register-ObjectEvent, 및 Register-WmiEvent매개 변수에서 Register-EngineEvent 파라미터를 사용하여 숨겨진 구독을 포함하여, 모든 이벤트 구독을 취소합니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-SourceIdentifier
이 cmdlet이 이벤트 구독을 취소하는 원본 식별자를 지정합니다.
SourceIdentifier 또는 SubscriptionId 매개 변수는 모든 명령에 포함되어야 합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
BySource
| Position: | 0 |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-SubscriptionId
이 cmdlet이 이벤트 구독을 취소하는 원본 식별자 ID를 지정합니다.
SourceIdentifier 또는 SubscriptionId 매개 변수는 모든 명령에 포함되어야 합니다.
매개 변수 속성
| 형식: | Int32 |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
ById
| Position: | 0 |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | False |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | 위스콘신 |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.
입력
PSEventSubscriber
Get-EventSubscriber의 출력을 이 커맨드릿으로 파이프할 수 있습니다.
출력
None
이 cmdlet은 출력을 반환하지 않습니다.
참고
Linux 또는 macOS 플랫폼에서 사용할 수 있는 이벤트 원본이 없습니다.
이벤트, 이벤트 구독 및 이벤트 큐는 현재 세션에만 존재합니다. 현재 세션을 닫으면 이벤트 큐가 삭제되고 이벤트 구독이 취소됩니다.
Unregister-Event
New-Event cmdlet을 사용하여 이벤트를 구독하지 않는 한 Register-EngineEvent cmdlet을 사용하여 만든 이벤트를 삭제할 수 없습니다. 세션에서 사용자 지정 이벤트를 삭제하려면 프로그래밍 방식으로 제거하거나 세션을 닫아야 합니다.
