영어로 읽기

다음을 통해 공유

Get-EventSubscriber

  • 참조
모듈:
Microsoft.PowerShell.Utility

현재 세션의 이벤트 구독자를 가져옵니다.

Syntax

Get-EventSubscriber
   [[-SourceIdentifier] <String>]
   [-Force]
   [<CommonParameters>]
Get-EventSubscriber
   [-SubscriptionId] <Int32>
   [-Force]
   [<CommonParameters>]

Description

cmdlet은 Get-EventSubscriber 현재 세션의 이벤트 구독자를 가져옵니다.

Register event cmdlet을 사용하여 이벤트에 가입하는 경우 이벤트 구독자는 Windows PowerShell 세션에 추가되고 가입한 이벤트는 발생할 때마다 이벤트 큐에 추가됩니다. 이벤트 구독을 취소하려면 cmdlet을 사용하여 이벤트 구독자를 Unregister-Event 삭제합니다.

예제

예제 1: 타이머 이벤트에 대한 이벤트 구독자 가져오기

이 예제에서는 Get-EventSubscriber 명령을 사용하여 타이머 이벤트에 대한 이벤트 구독자를 가져옵니다.

첫 번째 명령은 cmdlet을 New-Object 사용하여 타이머 개체의 instance 만듭니다. 새 타이머 개체를 변수에 $Timer 저장합니다.

두 번째 명령은 cmdlet을 Get-Member 사용하여 타이머 개체에 사용할 수 있는 이벤트를 표시합니다. 명령은 값이 Event인 Get-Member cmdlet의 Type 매개 변수를 사용합니다.

$Timer = New-Object Timers.Timer
$Timer | Get-Member -Type Event

TypeName: System.Timers.Timer

Name     MemberType Definition
----     ---------- ----------
Disposed Event      System.EventHandler Disposed(System.Object, System.EventArgs)
Elapsed  Event      System.Timers.ElapsedEventHandler Elapsed(System.Object, System.Timers.ElapsedEventArgs)

Register-ObjectEvent -InputObject $Timer -EventName Elapsed -SourceIdentifier Timer.Elapsed
Get-EventSubscriber

SubscriptionId   : 4
SourceObject     : System.Timers.Timer
EventName        : Elapsed
SourceIdentifier : Timer.Elapsed
Action           :
HandlerDelegate  :
SupportEvent     : False
ForwardEvent     : False

세 번째 명령은 cmdlet을 Register-ObjectEvent 사용하여 타이머 개체의 Elapsed 이벤트에 등록합니다.

네 번째 명령은 cmdlet을 Get-EventSubscriber 사용하여 Elapsed 이벤트에 대한 이벤트 구독자를 가져옵니다.

예제 2: 이벤트 구독자의 Action 속성에서 PSEventJob의 동적 모듈 사용

이 예제에서는 이벤트 구독자의 Action 속성에 있는 PSEventJob 개체에서 동적 모듈을 사용하는 방법을 보여 줍니다.

첫 번째 명령은 cmdlet을 New-Object 사용하여 타이머 개체를 만듭니다. 두 번째 명령은 타이머 간격을 500(밀리초)으로 설정합니다.

$Timer = New-Object Timers.Timer
$Timer.Interval = 500
$params = @{
    InputObject = $Timer
    EventName = 'Elapsed'
    SourceIdentifier = 'Timer.Random'
    Action = { $Random = Get-Random -Min 0 -Max 100 }
}
Register-ObjectEvent @params

Id  Name           State      HasMoreData  Location  Command
--  ----           -----      -----------  --------  -------
3   Timer.Random   NotStarted False                  $Random = Get-Random ...

$Timer.Enabled = $True
$Subscriber = Get-EventSubscriber -SourceIdentifier Timer.Random
($Subscriber.action).gettype().fullname

System.Management.Automation.PSEventJob

$Subscriber.action | Format-List -Property *

State         : Running
Module        : __DynamicModule_6b5cbe82-d634-41d1-ae5e-ad7fe8d57fe0
StatusMessage :
HasMoreData   : True
Location      :
Command       : $random = Get-Random -Min 0 -Max 100
JobStateInfo  : Running
Finished      : System.Threading.ManualResetEvent
InstanceId    : 88944290-133d-4b44-8752-f901bd8012e2
Id            : 1
Name          : Timer.Random
ChildJobs     : {}
...

& $Subscriber.action.module {$Random}

세 번째 명령은 cmdlet을 Register-ObjectEvent 사용하여 타이머 개체의 Elapsed 이벤트를 등록합니다. 이 명령에는 이벤트를 처리하는 작업이 포함됩니다. 타이머 간격이 지날 때마다 이벤트가 발생하고 작업의 명령이 실행됩니다. 이 경우 cmdlet은 Get-Random 0에서 100 사이의 난수를 생성하고 변수에 $Random 저장합니다. 이벤트의 소스 식별자는 Timer.Random입니다.

명령에서 Action 매개 변수를 Register-ObjectEvent 사용하는 경우 명령은 작업을 나타내는 PSEventJob 개체를 반환합니다.

네 번째 명령은 타이머를 설정합니다.

다섯 번째 명령은 cmdlet을 Get-EventSubscriber 사용하여 Timer.Random 이벤트의 이벤트 구독자를 가져옵니다. 이벤트 구독자 개체를 변수에 $Subscriber 저장합니다.

여섯 번째 명령은 이벤트 구독자 개체의 Action 속성에 PSEventJob 개체가 포함되어 있음을 보여 줍니다. 실제로 명령이 반환한 것과 동일한 PSEventJob 개체가 Register-ObjectEvent 포함되어 있습니다.

일곱 번째 명령은 cmdlet을 Format-List 사용하여 목록의 Action 속성에 있는 PSEventJob 개체의 모든 속성을 표시합니다. 결과는 PSEventJob 개체에 작업을 구현하는 동적 스크립트 모듈이 포함된 Module 속성이 있음을 보여줍니다.

나머지 명령은 호출 연산자(&)를 사용하여 모듈에서 명령을 호출하고 $Random 변수의 값을 표시합니다. 호출 연산자를 사용하면 내보내지 않은 명령을 포함하여 모듈의 어떠한 명령도 호출할 수 있습니다. 이 경우 명령에는 Elapsed 이벤트가 발생할 때 생성된 임의의 숫자가 표시됩니다.

모듈에 대한 자세한 내용은 about_Modules.

매개 변수

-Force

이 cmdlet은 , Register-WmiEvent및 Register-EngineEvent의 SupportEvent 매개 변수Register-ObjectEvent를 사용하여 숨겨진 이벤트에 대한 구독자를 포함하여 모든 이벤트 구독자를 가져옵니다.

Type:SwitchParameter
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceIdentifier

이벤트 구독자만 가져오는 SourceIdentifier 속성 값을 지정합니다. 기본적으로 는 Get-EventSubscriber 세션의 모든 이벤트 구독자를 가져옵니다. 와일드카드는 사용할 수 없습니다. 이 매개 변수는 대/소문자를 구분합니다.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SubscriptionId

이 cmdlet이 가져오는 구독 식별자를 지정합니다. 기본적으로 는 Get-EventSubscriber 세션의 모든 이벤트 구독자를 가져옵니다.

Type:Int32
Aliases:Id
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

입력

None

개체를 이 cmdlet으로 파이프할 수 없습니다.

출력

PSEventSubscriber

이 cmdlet은 각 이벤트 구독자에 대해 PSEventSubscriber 개체를 반환합니다.

참고

사용자 지정 이벤트를 만드는 cmdlet은 New-Event 구독자를 생성하지 않습니다. 따라서 cmdlet은 Get-EventSubscriber 이러한 이벤트에 대한 구독자 개체를 찾을 수 없습니다. 그러나 cmdlet을 Register-EngineEvent 사용하여 사용자 지정 이벤트를 구독하는 경우(이벤트를 전달하거나 작업을 지정하기 위해) Get-EventSubscriber 생성되는 Register-EngineEvent 구독자를 찾습니다.

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