Register-WmiEvent

Register-WmiEvent [-类] <string> [[-SourceIdentifier] <string>] [[-Action] <scriptblock>] [-ComputerName <string>] [-Credential <PSCredential>] [-Forward] [-MessageData <psobject>] [-命名空间 <string>] [-SupportEvent] [-Timeout <Int64>] [<CommonParameters>]

Register-WmiEvent [-Query] <string> [[-SourceIdentifier] <string>] [[-Action] <scriptblock>] [-ComputerName <string>] [-Credential <PSCredential>] [-Forward] [-MessageData <psobject>] [-命名空间 <string>] [-SupportEvent] [-Timeout <Int64>] [<CommonParameters>]

C:\PS>register-wmiEvent -class 'Win32_ProcessStartTrace' -sourceIdentifier "ProcessStarted"

说明
-----------
此命令订阅由 Win32_ProcessStartTrace 类生成的事件。只要进程启动，此类就会引发一个事件。

C:\PS>register-wmiEvent -query "select * from __instancecreationevent within 5 where targetinstance isa 'win32_process'" -sourceIdentifier "WMIProcess" -messageData "Test 01" -timeout 500

说明
-----------
此命令使用一个查询订阅 Win32_process 实例创建事件。

C:\PS>$action = { get-history | where { $_.commandline -like "*start-process*" } | export-cliXml "commandHistory.clixml" }

C:\PS> register-wmiEvent -class 'Win32_ProcessStartTrace' -sourceIdentifier "ProcessStarted" -action $action

Id    Name            State      HasMoreData   Location  Command
--    ----            -----      -----------   --------  -------
1     ProcessStarted  NotStarted False                   get-history | where {...

说明
-----------
此示例说明如何使用操作来响应事件。在本例中，当进程启动时，当前会话中的任何 Start-Process 命令都会写入一个 XML 文件中。

使用 Action 参数时，Register-WmiEvent 会返回一个表示事件操作的后台作业。您可以使用 Job cmdlet（如 Get-Job 和 Receive-Job）来管理事件作业。

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

C:\PS>register-wmiEvent -class 'Win32_ProcessStartTrace' -sourceIdentifier "Start" -computername Server01 

C:\PS> get-event -sourceIdentifier "Start"

说明
-----------
此示例注册远程计算机 Server01 上的事件。

WMI 将这些事件返回到本地计算机并将其存储在当前会话的事件队列中。要检索这些事件，请运行本地 Get-Event 命令。