Get-EventSubscriber

Get-EventSubscriber [-SubscriptionId] <int> [-Force] [<CommonParameters>]

Get-EventSubscriber [[-SourceIdentifier] <string>] [-Force] [<CommonParameters>]

C:\PS>$timer = New-Object Timers.Timer 

C:\PS> $timer | Get-Member -Type Event 

C:\PS> Register-ObjectEvent -inputObject $timer -EventName Elapsed -SourceIdentifier Timer.Elapsed

C:\PS> Get-EventSubscriber

C:\PS> $timer = New-Object Timers.Timer 

C:\PS> $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)

C:\PS> Register-ObjectEvent -InputObject $timer -EventName Elapsed -SourceIdentifier Timer.Elapsed

C:\PS> Get-EventSubscriber 

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

Описание
-----------
В этом примере используется команда Get-EventSubscriber для получения подписчика на событие таймера. 

Первая команда создает экземпляр объекта таймера с помощью командлета New-Object. Новый объект таймера сохраняется в переменной $timer.

Вторая команда отображает события, доступные для объектов таймера, с помощью командлета Get-Member. В этой команде используется параметр Type командлета Get-Member со значением Event.

Третья команда регистрирует событие Elapsed объекта таймера с помощью командлета Register-ObjectEvent.

Четвертая команда использует командлет Get-EventSubscriber для получения подписчика на событие Elapsed.

C:\PS>$timer  = New-Object Timers.Timer

C:\PS> $timer.Interval = 500

C:\PS> Register-ObjectEvent -inputObject $timer -eventName Elapsed -sourceIdentifier Timer.Random -Action { $random = Get-Random -Min 0 -Max 100 }

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


C:\PS> $timer.Enabled = $true

C:\PS> $subscriber = Get-EventSubcriber -sourceIdentifer Timer.Random

C:\PS> ($subscriber.action).gettype().fullname
PSEventJob

C:\PS> $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     : {}
...

C:\PS> & $subscriber.action.module {$random}
96

C:\PS> & $subscriber.action.module {$random}
23

Описание
-----------
В этом примере показано использование динамического модуля в объекте PSEventJob свойства Action подписчика на событие.

Первая команда с помощью командлета New-Object создает объект таймера. Вторая команда устанавливает интервал времени таймера равным 500 (миллисекундам).

Третья команда регистрирует событие Elapsed объекта таймера с помощью командлета Register-ObjectEvent. Она содержит действие, обрабатывающее событие. Когда интервал времени таймера истекает, появляется событие, и выполняются команды, содержащиеся в действии. В этом случае командлет Get-Random создает случайное число от 0 до 100 и сохраняет его в переменной $random. Идентификатор источника события — Timer.Random.

При использовании параметра Action в команде Register-ObjectEvent эта команда возвращает объект PSEventJob, представляющий действие. 

Четвертая команда включает таймер.

Пятая команда использует командлет Get-EventSubscriber для получения подписчика на событие Timer.Random. Она сохраняет объект подписчика на событие в переменной $subscriber.

Шестая команда показывает, что свойство Action объекта подписчика на событие содержит объект PSEventJob. Фактически, оно содержит тот же объект PSEventJob, который возвращен командой Register-ObjectEvent.

Седьмая команда использует командлет Format-List для отображения всех свойств объекта PSEventJob в свойстве Action в списке. Результат показывает, что объект PSEventJob имеет свойство Module, содержащее динамический модуль скрипта, который реализует действие.

В остальных командах используется оператор вызова (&) для вызова команды в модуле и отображения значения переменной $random. Оператор вызова можно использовать для вызова любой команды в модуле, включая команды, которые не экспортируются. В этом случае команды показывают случайное число, создаваемое при появлении события Elapsed.

Дополнительные сведения о модулях см. в разделе about_Modules.