Register-WmiEvent

Register-WmiEvent [-Class] <string> [[-SourceIdentifier] <string>] [[-Action] <scriptblock>] [-ComputerName <string>] [-Credential <PSCredential>] [-Forward] [-MessageData <psobject>] [-Namespace <string>] [-SupportEvent] [-Timeout <Int64>] [<CommonParameters>]

Register-WmiEvent [-Query] <string> [[-SourceIdentifier] <string>] [[-Action] <scriptblock>] [-ComputerName <string>] [-Credential <PSCredential>] [-Forward] [-MessageData <psobject>] [-Namespace <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 によって返されます。Get-Job および Receive-Job などの Job コマンドレットを使用して、イベント ジョブを管理できます。

詳細については、「about_Jobs」を参照してください。

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

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

説明
-----------
この例では、Server01 リモート コンピューターのイベントを登録します。

イベントは WMI によってローカル コンピューターに返され、現在のセッションのイベント キューに保存されます。イベントを取得するには、ローカル Get-Event コマンドを実行します。