Remove-Event
이벤트 큐에서 이벤트를 삭제합니다.
구문
Remove-Event [-EventIdentifier] <int> [-Confirm] [-WhatIf] [<CommonParameters>]
Remove-Event [-SourceIdentifier] <string> [-Confirm] [-WhatIf] [<CommonParameters>]
설명
Remove-Event cmdlet은 현재 세션의 이벤트 큐에서 이벤트를 삭제합니다.
이 cmdlet은 현재 큐에 있는 이벤트만 삭제합니다. 이벤트 등록이나 가입을 취소하려면 Unregister-Event cmdlet을 사용합니다.
매개 변수
-EventIdentifier <int>
지정된 이벤트 식별자가 포함된 이벤트만 삭제합니다. EventIdentifier 또는 SourceIdentifier 매개 변수는 모든 명령에 필요합니다.
필수 여부 |
true |
위치 |
1 |
기본값 |
없음 |
파이프라인 입력 적용 여부 |
true (ByPropertyName) |
와일드카드 문자 적용 여부 |
false |
-SourceIdentifier <string>
지정된 원본 식별자가 포함된 이벤트만 삭제합니다. 와일드카드는 사용할 수 없습니다. EventIdentifier 또는 SourceIdentifier 매개 변수는 모든 명령에 필요합니다.
필수 여부 |
true |
위치 |
1 |
기본값 |
없음 |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
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.PSEventArgs Get-Event의 이벤트를 Remove-Event로 파이프할 수 있습니다. |
출력 |
없음 cmdlet은 어떠한 출력도 생성하지 않습니다. |
참고
이벤트, 이벤트 가입 및 이벤트 큐는 현재 세션에서만 존재합니다. 현재 세션을 닫으면 이벤트 큐가 삭제되고 이벤트 가입이 취소됩니다.
예 1
C:\PS>remove-event -sourceIdentifier "ProcessStarted"
설명
-----------
이 명령은 원본 식별자가 "Process Started"인 이벤트를 이벤트 큐에서 삭제합니다.
예 2
C:\PS>remove-event -eventIdentifier 30
설명
-----------
이 명령은 이벤트 ID가 30인 이벤트를 이벤트 큐에서 삭제합니다.
예 3
C:\PS>get-event | remove-event
설명
-----------
이 명령은 이벤트 큐에서 모든 이벤트를 삭제합니다.
참고 항목
개념
Register-ObjectEvent
Register-EngineEvent
Register-WmiEvent
Unregister-Event
Get-Event
New-Event
Remove-Event
Wait-Event