Register-WmiEvent

Register-WmiEvent
    [-Class] <String>
    [[-SourceIdentifier] <String>]
    [[-Action] <ScriptBlock>]
    [-Namespace <String>]
    [-Credential <PSCredential>]
    [-ComputerName <String>]
    [-Timeout <Int64>]
    [-MessageData <PSObject>]
    [-SupportEvent]
    [-Forward]
    [-MaxTriggerCount <Int32>]
    [<CommonParameters>]

Register-WmiEvent
    [-Query] <String>
    [[-SourceIdentifier] <String>]
    [[-Action] <ScriptBlock>]
    [-Namespace <String>]
    [-Credential <PSCredential>]
    [-ComputerName <String>]
    [-Timeout <Int64>]
    [-MessageData <PSObject>]
    [-SupportEvent]
    [-Forward]
    [-MaxTriggerCount <Int32>]
    [<CommonParameters>]

Register-WmiEvent cmdlet 订阅本地计算机或远程计算机上的 Windows Management Instrumentation （WMI） 事件。

引发订阅的 WMI 事件时，即使事件发生在远程计算机上，也会将其添加到本地会话中的事件队列。 若要获取事件队列中的事件，请使用 Get-Event cmdlet。

可以使用 Register-WmiEvent 的参数来订阅远程计算机上的事件，并指定有助于识别队列中的事件的事件的属性值。 还可以使用 Action 参数指定要在引发订阅事件时执行的操作。

当您订阅一个事件时，一个事件订阅者将被添加到您的当前会话中。 若要在会话中获取事件订阅者，请使用 Get-EventSubscriber cmdlet。 若要取消订阅，请使用 Unregister-Event cmdlet，从会话中删除事件订阅服务器。

新的通用信息模型 （CIM） cmdlet（引入了 Windows PowerShell 3.0），执行与 WMI cmdlet 相同的任务。 CIM cmdlet 符合 WS-Management （WSMan） 标准和 CIM 标准，该标准使 cmdlet 能够使用相同的技术来管理运行 Windows 操作系统的计算机和运行其他操作系统的计算机。 请考虑使用 Register-WmiEvent cmdlet，而不是使用 。

PS C:\> Register-WmiEvent -Class 'Win32_ProcessStartTrace' -SourceIdentifier "ProcessStarted"

此命令订阅 Win32_ProcessStartTrace 类生成的事件。 每当进程启动时，此类就会引发事件。

PS C:\> Register-WmiEvent -Query "select * from __instancecreationevent within 5 where targetinstance isa 'win32_process'" -SourceIdentifier "WMIProcess" -MessageData "Test 01" -TimeOut 500

此命令使用查询来订阅Win32_process实例创建事件。

PS C:\> $action = { Get-History | where { $_.commandline -like "*start-process*" } | export-cliXml "commandHistory.clixml" }
PS C:\> 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 返回表示事件操作的后台作业。 可以使用 作业 cmdlet（如 Get-Job 和 Receive-Job）来管理事件作业。

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

PS C:\> Register-WmiEvent -Class 'Win32_ProcessStartTrace' -SourceIdentifier "Start" -Computername Server01
PS C:\> Get-Event -SourceIdentifier "Start"

此示例在 Server01 远程计算机上注册事件。

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

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

不能通过管道将对象传递给此 cmdlet。

此 cmdlet 将不生成任何输出。

• 若要在 Windows Vista 或更高版本的 Windows 操作系统中使用此 cmdlet，请使用“以管理员身份运行”选项启动 Windows PowerShell。

  事件、事件订阅和事件队列仅存在于当前会话中。 如果关闭当前会话，事件队列将被丢弃，事件订阅也将被取消。