다음을 통해 공유

Get-Event

모듈:
Microsoft.PowerShell.Utility Module

이벤트 큐의 이벤트를 가져옵니다.

구문

BySource (기본값) 

Get-Event
    [[-SourceIdentifier] <String>]
    [<CommonParameters>]

ById 

Get-Event
    [-EventIdentifier] <Int32>
    [<CommonParameters>]

Description

Get-Event cmdlet은 현재 세션에 대한 PowerShell 이벤트 큐의 이벤트를 가져옵니다. 모든 이벤트를 얻거나 EventIdentifier 사용하거나 SourceIdentifier 매개 변수를 이벤트를 지정할 수 있습니다.

이벤트가 발생하면 이벤트 큐에 추가됩니다. 이벤트 큐에는 등록한 이벤트, New-Event cmdlet을 사용하여 만든 이벤트 및 PowerShell이 종료될 때 발생하는 이벤트가 포함됩니다. Get-Event 또는 Wait-Event 사용하여 이벤트를 가져올 수 있습니다.

이 cmdlet은 이벤트 뷰어 로그에서 이벤트를 가져올 수 없습니다. 이러한 이벤트를 얻으려면 Get-WinEvent 사용하거나 Get-EventLog.

예제

예제 1: 모든 이벤트 가져오기

PS C:\> Get-Event

이 명령은 이벤트 큐의 모든 이벤트를 가져옵니다.

예제 2: 원본 식별자별 이벤트 가져오기

PS C:\> Get-Event -SourceIdentifier "PowerShell.ProcessCreated"

이 명령은 SourceIdentifier 속성의 값이 PowerShell.ProcessCreated인 이벤트를 가져옵니다.

예제 3: 생성된 시간에 따라 이벤트 가져오기

PS C:\> $Events = Get-Event
PS C:\> $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      : PS C:\> 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: 식별자를 사용하여 이벤트 가져오기

PS C:\> Get-Event -EventIdentifier 2

이 명령은 이벤트 식별자가 2인 이벤트를 가져옵니다.

매개 변수

-EventIdentifier

이 cmdlet이 이벤트를 가져오는 이벤트 식별자를 지정합니다.

매개 변수 속성

형식:Int32
Default value:None
와일드카드 지원:False
DontShow:False
별칭:아이디

매개 변수 집합

ById
Position:0
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-SourceIdentifier

이 cmdlet이 이벤트를 가져오는 원본 식별자를 지정합니다. 기본값은 이벤트 큐의 모든 이벤트입니다. 와일드카드는 허용되지 않습니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

BySource
Position:0
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

None

개체를 이 cmdlet에 파이프로 연결할 수 없습니다.

출력

PSEventArgs

이 cmdlet은 각 이벤트에 대한 PSEventArgs 개체를 반환합니다. 이 개체에 대한 설명을 보려면 Get-Help Get-Event -Full 입력하고 도움말 항목의 Notes 섹션을 참조하세요.

참고

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

Get-Event cmdlet은 다음 속성을 사용하여 PSEventArgs 개체(System.Management.Automation.PSEventArgs)를 반환합니다.

  • ComputerName입니다. 이벤트가 발생한 컴퓨터의 이름입니다. 이 속성 값은 이벤트가 원격 컴퓨터에서 전달되는 경우에만 채워집니다.

  • RunspaceId입니다. 이벤트가 발생한 세션을 고유하게 식별하는 GUID입니다. 이 속성 값은 이벤트가 원격 컴퓨터에서 전달되는 경우에만 채워집니다.

  • EventIdentifier입니다. 현재 세션에서 이벤트 알림을 고유하게 식별하는 정수(Int32)입니다.

  • 발송인. 이벤트를 생성한 개체입니다. Action 매개 변수 값에서 $Sender 자동 변수에는 보낸 사람 개체가 포함됩니다.

  • SourceEventArgs입니다. EventArgs에서 파생되는 첫 번째 매개 변수(있는 경우)입니다. 예를 들어 서명에 Object sender 형식이 있는 타이머 경과 이벤트에서 timers.ElapsedEventArgs SourceEventArgs 속성에는 Timers.ElapsedEventArgs포함됩니다. Action 매개 변수 값에서 $EventArgs 자동 변수에는 이 값이 포함됩니다.

  • SourceArgs입니다. 원래 이벤트 서명의 모든 매개 변수입니다. 표준 이벤트 서명의 경우 $args[0] 발신자를 나타내고 $args[1]SourceEventArgs나타냅니다. Action 매개 변수 값에서 $args 자동 변수에는 이 값이 포함됩니다.

  • SourceIdentifier입니다. 이벤트 구독을 식별하는 문자열입니다. Action 매개 변수 값에서 자동 변수의 $Event 속성에는 이 값이 포함됩니다.

  • TimeGenerated입니다. 이벤트가 생성된 시간을 나타내는 DateTime 개체입니다. Action 매개 변수 값에서 자동 변수의 $Event 속성에는 이 값이 포함됩니다.

  • MessageData. 이벤트 구독과 연결된 데이터입니다. 사용자는 이벤트를 등록할 때 이 데이터를 지정합니다. Action 매개 변수 값에서 자동 변수의 $Event 속성에는 이 값이 포함됩니다.