Remove-Event
이벤트 큐에서 이벤트를 삭제합니다.
구문
BySource (기본값)
Remove-Event
[-SourceIdentifier] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByIdentifier
Remove-Event
[-EventIdentifier] <Int32>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Remove-Event cmdlet은 현재 세션의 이벤트 큐에서 이벤트를 삭제합니다.
이 cmdlet은 현재 큐에 있는 이벤트만 삭제합니다. 이벤트 등록을 취소하거나 구독을 취소하려면 Unregister-Event cmdlet을 사용합니다.
예제
예제 1: 원본 식별자별 이벤트 제거
PS C:\> Remove-Event -SourceIdentifier "ProcessStarted"
이 명령은 이벤트 큐에서 Process Started의 원본 식별자를 사용하여 이벤트를 삭제합니다.
예제 2: 이벤트 식별자별 이벤트 제거
PS C:\> Remove-Event -EventIdentifier 30
이 명령은 이벤트 큐에서 이벤트 ID가 30인 이벤트를 삭제합니다.
예제 3: 모든 이벤트 제거
PS C:\> Get-Event | Remove-Event
이 명령은 이벤트 큐에서 모든 이벤트를 삭제합니다.
매개 변수
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | False |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | cf(cf) |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-EventIdentifier
cmdlet이 삭제되는 이벤트 식별자를 지정합니다. 모든 명령에는 EventIdentifier 또는 SourceIdentifier 매개 변수가 필요합니다.
매개 변수 속성
| 형식: | Int32 |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
ByIdentifier
| Position: | 0 |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-SourceIdentifier
이 cmdlet에서 이벤트를 삭제하는 원본 식별자를 지정합니다. 와일드카드는 허용되지 않습니다. 모든 명령에는 EventIdentifier 또는 SourceIdentifier 매개 변수가 필요합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
BySource
| Position: | 0 |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | 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를 참조하세요.
입력
PSEventArgs
이벤트를 Get-Event 이 cmdlet으로 파이프할 수 있습니다.
출력
None
이 cmdlet은 출력을 반환하지 않습니다.
참고
이벤트, 이벤트 구독 및 이벤트 큐는 현재 세션에만 존재합니다. 현재 세션을 닫으면 이벤트 큐가 삭제되고 이벤트 구독이 취소됩니다.