Register-ObjectEvent

Register-ObjectEvent [-InputObject] <psobject> [-EventName] <string> [[-SourceIdentifier] <string>] [[-Action] <scriptblock>] [-Forward] [-MessageData <psobject>] [-SupportEvent] [<CommonParameters>]

C:\PS>$query = New-Object System.Management.WqlEventQuery "__InstanceCreationEvent", (New-Object TimeSpan 0,0,1), "TargetInstance isa 'Win32_Process'" 

C:\PS> $processWatcher = New-Object System.Management.ManagementEventWatcher $query 

C:\PS> register-objectEvent -inputObject $processWatcher -eventName "EventArrived"

说明
-----------
此示例订阅启动新进程时生成的事件。

该命令使用 ManagementEventWatcher 对象获取 EventArrived 事件。查询对象指定这些事件是 Win32_Process 类的实例创建事件。

C:\PS>$query = New-Object System.Management.WqlEventQuery "__InstanceCreationEvent", (New-Object TimeSpan 0,0,1), "TargetInstance isa 'Win32_Process'" 

C:\PS> $processWatcher = New-Object System.Management.ManagementEventWatcher $query 

C:\PS> $action = { New-Event "PowerShell.ProcessCreated" -Sender $sender -EventArguments $SourceEventArgs.NewEvent.TargetInstance } 

C:\PS> register-objectEvent -inputObject $processWatcher -eventName "EventArrived" -action $action

Id    Name            State      HasMoreData     Location             Command
--    ----            -----      -----------     --------             -------
2     422cfe5a-65e... Running    True                                 New-Event "PowerShe...

说明
-----------
此示例演示了如何指定操作来响应事件。如果指定操作，则引发的事件不会添加到事件队列中，而是由该操作对事件进行响应。

在此示例中，当引发指示新进程已启动的实例创建事件时，便会引发新 ProcessCreated 事件。

操作使用仅针对事件操作填充的 $Sender 和 $SourceEventArgs 自动变量。

Register-ObjectEvent 命令返回表示操作的作业对象，该操作作为后台作业运行。可以使用 Job cmdlet（如 Get-Job 和 Receive-Job）来管理该后台作业。

有关详细信息，请参阅 about_Jobs。

C:\PS>$s = new-pssession -computername Server01, Server02

C:\PS> invoke-command -session $s -filepath ProcessCreationEvent.ps1

C:\PS> invoke-command -session $s { get-event }

# ProcessCreationEvent.ps1

function Enable-ProcessCreationEvent 
{ 
   $query = New-Object System.Management.WqlEventQuery "__InstanceCreationEvent", ` 
       (New-Object TimeSpan 0,0,1), ` 
       "TargetInstance isa 'Win32_Process'" 
   $processWatcher = New-Object System.Management.ManagementEventWatcher $query 

   $identifier = "WMI.ProcessCreated" 
   Register-ObjectEvent -input $processWatcher -eventName "EventArrived" `
      -sourceIdentifier $identifier -messageData "Test" -forward 
   } 
} 

EnableProcessCreationEvent

说明
-----------
此示例演示了如何订阅远程计算机上的对象事件。

第一个命令在两台远程计算机上创建 PSSession 并将它们保存在 $s 变量中。

第二个命令使用 Invoke-Command cmdlet 的 FilePath 参数在 $s 的每个 PSSession 中运行 ProcessCreationEvent.ps1 脚本。

该脚本包括 Register-ObjectEvent 命令，该命令通过 ManagementEventWatcher 对象及其 EventArrived 事件订阅 Win32_Process 对象上的实例创建事件。

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

C:\PS> $timer.Interval = 500

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

C:\PS> $job.gettype().fullname
System.Management.Automation.PSEventJob

C:\PS> $job | 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> $timer.Enabled = $true

C:\PS> & $job.module {$random}
60

C:\PS> & $job.module {$random}
47

说明
-----------
此示例说明如何在事件注册中包含 Action 时创建的 PSEventJob 对象中使用动态模块。

第一条命令使用 New-Object cmdlet 创建一个计时器对象。第二条命令将计时器间隔设置为 500（毫秒）。

第三条命令使用 Register-ObjectEvent cmdlet 注册该计时器对象的 Elapsed 事件。该命令包含处理该事件的操作。每当经过该计时器间隔时，就会引发一个事件并运行操作中的命令。在此示例中，Get-Random cmdlet 生成一个介于 0 和 100 之间的随机数，并将其保存在 $random 变量中。

在 Register-ObjectEvent 命令中使用 Action 参数时，该命令返回表示该操作的 PSEventJob 对象。该命令将作业对象保存在 $job 变量中。

Register-ObjectEvent cmdlet 返回的 PSEventJob 对象也包含在事件订阅者的 Action 属性中。有关详细信息，请参阅 Get-EventSubscriber。

第四条命令显示 $job 变量包含 PSEventJob 对象。第五条命令使用 Format-List cmdlet 在列表中显示 PSEventJob 对象的所有属性。

PSEventJob 具有 Module 属性，该属性包含实现该操作的动态脚本模块。

第六条命令启用计时器。

其余的命令使用调用运算符 (&) 调用模块中的命令并显示 $random 变量的值。您可以使用调用运算符调用模块中的任何命令，包括未导出的命令。在此示例中，这些命令显示 Elapsed 事件发生时所生成的随机数。

有关模块的详细信息，请参阅 about_Modules。