이벤트 큐의 이벤트를 가져옵니다.
구문
Get-Event [-EventIdentifier] <int> [<CommonParameters>] Get-Event [[-SourceIdentifier] <string>] [<CommonParameters>]
설명
Get-Event cmdlet은 현재 세션에 대한 Windows PowerShell 이벤트 큐의 이벤트를 가져옵니다. 모든 이벤트를 가져오거나 EventIdentifier 또는 SourceIdentifier 매개 변수를 사용하여 이벤트를 지정할 수 있습니다.
이벤트가 발생하면 이벤트 큐에 추가됩니다. 이벤트 큐에는 등록한 이벤트, New-Event cmdlet을 사용하여 만든 이벤트 및 Windows PowerShell이 끝날 때 발생하는 이벤트가 포함됩니다. Get-Event 또는 Wait-Event를 사용하여 이벤트를 가져올 수 있습니다.
이 명령은 이벤트 뷰어 로그에서 이벤트를 가져오지 않습니다. 이러한 이벤트를 가져오려면 Get-WinEvent 또는 Get-EventLog를 사용하십시오.
매개 변수
-EventIdentifier <int>
지정된 이벤트 식별자가 포함된 이벤트만 가져옵니다.
|
필수 여부 |
true |
|
위치 |
1 |
|
기본값 |
|
|
파이프라인 입력 적용 여부 |
true (ByPropertyName) |
|
와일드카드 문자 적용 여부 |
false |
-SourceIdentifier <string>
지정된 원본 식별자를 가진 이벤트만 가져옵니다. 기본값은 이벤트 큐의 모든 이벤트입니다. 와일드카드는 사용할 수 없습니다.
|
필수 여부 |
false |
|
위치 |
1 |
|
기본값 |
All events |
|
파이프라인 입력 적용 여부 |
true (ByPropertyName) |
|
와일드카드 문자 적용 여부 |
false |
<CommonParameters>
이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_Commonparameters.
입력 및 출력
입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.
|
입력 |
없음 입력을 이 cmdlet으로 파이프할 수 없습니다. |
|
출력 |
System.Management.Automation.PSEventArgs Get-Event는 각 이벤트에 대한 PSEventArgs 개체를 반환합니다. 이 개체의 설명을 보려면 "get-help get-event -full"을 입력하고 도움말 항목의 Notes 섹션을 참조하십시오. |
참고
이벤트, 이벤트 가입 및 이벤트 큐는 현재 세션에서만 존재합니다. 현재 세션을 닫으면 이벤트 큐가 삭제되고 이벤트 가입이 취소됩니다.
Get-Event cmdlet은 다음 속성이 있는 PSEventArgs 개체(System.Management.Automation.PSEventArgs)를 반환합니다.
-- ComputerName: 이벤트가 발생한 컴퓨터 이름. 이 속성 값은 이벤트가 원격 컴퓨터에서 전달된 경우에만 채워집니다.
-- RunspaceId: 이벤트가 발생한 세션을 고유하게 식별하는 GUID. 이 속성 값은 이벤트가 원격 컴퓨터에서 전달된 경우에만 채워집니다.
-- EventIdentifier: 현재 세션의 이벤트 알림을 고유하게 식별하는 정수(Int32).
-- Sender: 이벤트를 발생시킨 개체. Action 매개 변수의 값에서 $Sender 자동 변수에는 송신자 개체가 포함됩니다.
-- SourceEventArgs: EventArgs에서 파생된 첫 번째 매개 변수(있는 경우). 예를 들어 서명이 "Object sender, Timers.ElapsedEventArgs e" 형식을 갖는 타이머 경과 이벤트에서 SourceEventArgs 속성에는 Timers.ElapsedEventArgs가 포함됩니다. Action 매개 변수의 값에서 $SourceEventArgs 자동 변수에는 이 값이 포함됩니다.
-- SourceArgs: 원래 이벤트 서명의 모든 매개 변수. 표준 이벤트 서명의 경우 $args[0]는 송신자를 나타내고 $args[1]는 SourceEventArgs를 나타냅니다. Action 매개 변수의 값에서 $SourceArgs 자동 변수에는 이 값이 포함됩니다.
-- SourceIdentifier: 이벤트 가입을 식별하는 문자열. Action 매개 변수의 값에서 $Event 자동 변수의 SourceIdentifier 속성에 이 값이 포함됩니다.
-- TimeGenerated: 이벤트가 생성된 시간을 나타내는 DateTime 개체. Action 매개 변수의 값에서 $Event 자동 변수의 TimeGenerated 속성에 이 값이 포함됩니다.
--MessageData: 이벤트 가입과 연결된 데이터. 사용자는 이벤트를 등록할 때 이 데이터를 지정합니다. Action 매개 변수의 값에서 $Event 자동 변수의 MessageData 속성에 이 값이 포함됩니다.
예 1
C:\PS>get-event 설명 ----------- 이 명령은 이벤트 큐의 모든 이벤트를 가져옵니다.
예 2
C:\PS>get-event -sourceIdentifier "PowerShell.ProcessCreated" 설명 ----------- 이 명령은 SourceIdentifier 속성 값이 "PowerShell.ProcessCreated"인 이벤트를 가져옵니다.
예 3
C:\PS>$events = get-event
C:\PS> $events[0] | format-list -property *
ComputerName :
RunspaceId : c2153740-256d-46c0-a57c-b805917d1b7b
EventIdentifier : 1
Sender : System.Management.ManagementEventWatcher
SourceEventArgs : System.Management.EventArrivedEventArgs
SourceArgs : {System.Management.ManagementEventWatcher, System.Management.EventArrivedEventArgs}
SourceIdentifier : ProcessStarted
TimeGenerated : 11/13/2008 12:09:32 PM
MessageData :
C:\PS> get-event | where {$_.TimeGenerated -ge "11/13/2008 12:15:00 PM"}
ComputerName :
RunspaceId : c2153740-256d-46c0-a57c-b8059325d1a0
EventIdentifier : 1
Sender : System.Management.ManagementEventWatcher
SourceEventArgs : System.Management.EventArrivedEventArgs
SourceArgs : {System.Management.ManagementEventWatcher, System.Management.EventArrivedEventArgs}
SourceIdentifier : ProcessStarted
TimeGenerated : 11/13/2008 12:15:00 PM
MessageData :
설명
-----------
이 예제는 SourceIdentifier 이외의 속성을 사용하여 이벤트를 가져오는 방법을 보여 줍니다.
첫 번째 명령은 이벤트 큐의 모든 이벤트를 가져와 $events 변수에 저장합니다.
두 번째 명령은 배열 표기법을 사용하여 $events 변수에 있는 배열의 첫 번째(0 인덱스) 이벤트를 가져옵니다. 파이프라인 연산자(|)를 사용하여 이벤트를 Format-List 명령으로 보내면 이 명령은 목록에 있는 이벤트의 모든 속성을 표시합니다. 이를 통해 이벤트 개체의 속성을 검사할 수 있습니다.
세 번째 명령은 Where-Object cmdlet을 사용하여 생성된 시간을 기준으로
이벤트를 가져오는 방법을 보여 줍니다.
예 4
C:\PS>get-event -eventIdentifier 2 설명 ----------- 이 명령은 이벤트 식별자가 2인 이벤트를 가져옵니다.
참고 항목