Get-Event

  • リファレンス
モジュール:
Microsoft.PowerShell.Utility

イベント キュー内のイベントを取得します。

構文

Get-Event
   [[-SourceIdentifier] <String>]
   [<CommonParameters>]
Get-Event
   [-EventIdentifier] <Int32>
   [<CommonParameters>]

説明

コマンドレットは Get-Event 、現在のセッションの PowerShell イベント キュー内のイベントを取得します。 すべてのイベントを取得することも、EventIdentifier パラメーターまたは SourceIdentifier パラメーターを使用してイベントを指定することもできます。

イベントは、発生時に、イベント キューに追加されます。 イベント キューには、登録したイベント、コマンドレットを使用して New-Event 作成されたイベント、PowerShell の終了時に発生するイベントが含まれます。 イベントを使用 Get-Event または Wait-Event 取得できます。

このコマンドレットは、イベント ビューアーのログからイベントを取得しません。 これらのイベントを取得するには、次を使用 Get-WinEvent します Get-EventLog。

例

例 1: すべてのイベントを取得する

PS C:\> Get-Event

このコマンドは、イベント キュー内のすべてのイベントを取得します。

例 2: ソース識別子でイベントを取得する

PS C:\> Get-Event -SourceIdentifier "PowerShell.ProcessCreated"

このコマンドは、SourceIdentifier プロパティの値が PowerShell.ProcessCreated であるイベントを取得します。

例 3: 生成された時刻に基づいてイベントを取得する

PS C:\> $Events = Get-Event
PS C:\> $Events[0] | Format-List -Property *
ComputerName     :
RunspaceId       : c2153740-256d-46c0-a57c-b805917d1b7b
EventIdentifier  : 1
Sender           : System.Management.ManagementEventWatcher
SourceEventArgs  : System.Management.EventArrivedEventArgs
SourceArgs       : {System.Management.ManagementEventWatcher, System.Management.EventArrivedEventArgs}
SourceIdentifier : ProcessStarted
TimeGenerated    : 11/13/2008 12:09:32 PM
MessageData      : PS C:\> Get-Event | Where {$_.TimeGenerated -ge "11/13/2008 12:15:00 PM"}
ComputerName     :
RunspaceId       : c2153740-256d-46c0-a57c-b8059325d1a0
EventIdentifier  : 1
Sender           : System.Management.ManagementEventWatcher
SourceEventArgs  : System.Management.EventArrivedEventArgs
SourceArgs       : {System.Management.ManagementEventWatcher, System.Management.EventArrivedEventArgs}
SourceIdentifier : ProcessStarted
TimeGenerated    : 11/13/2008 12:15:00 PM
MessageData      :

この例では SourceIdentifier 以外のプロパティを使用してイベントを取得する方法を示します。

最初のコマンドは、イベント キュー内のすべてのイベントを取得し、変数に $Events 保存します。

2 番目のコマンドでは、配列表記を使用して、変数内の配列の最初の (0 インデックス) イベントを $Events 取得します。 コマンドはパイプライン演算子 (|) を使用してコマンドにイベントを Format-List 送信し、イベントのすべてのプロパティを一覧に表示します。 これによって、イベント オブジェクトのプロパティを調べることができます。

3 番目のコマンドは、コマンドレットを Where-Object 使用して、生成された時刻に基づいてイベントを取得する方法を示しています。

例 4: 識別子でイベントを取得する

PS C:\> Get-Event -EventIdentifier 2

このコマンドは、イベント識別子が 2 のイベントを取得します。

パラメーター

-EventIdentifier

このコマンドレットがイベントを取得するイベント識別子を指定します。

Type:Int32
Aliases:Id
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SourceIdentifier

このコマンドレットがイベントを取得するソース識別子を指定します。 既定では、イベント キュー内のすべてのイベントです。 ワイルドカードは使用できません。

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

入力

None

このコマンドレットにオブジェクトをパイプすることはできません。

出力

PSEventArgs

このコマンドレットは、イベントごとに P Standard Edition ventArgs オブジェクトを返します。 このオブジェクトの説明を表示するには、ヘルプ トピックの「Notes」セクションを入力 Get-Help Get-Event -Full して参照してください。

メモ

Linux または macOS プラットフォームで使用できるイベント ソースはありません。

イベント、イベント サブスクリプション、およびイベント キューは、現在のセッションにのみ存在します。 現在のセッションを閉じた場合、イベント キューが破棄され、イベント サブスクリプションが取り消されます。

このコマンドレットはGet-Event、次のプロパティを持つ P Standard Edition ventArgs オブジェクト (System.Management.Automation.P Standard Edition ventArgs) を返します。

  • Computername。 イベントが発生したコンピューターの名前。 このプロパティ値は、リモート コンピューターからイベントが転送された場合にのみ入力されます。

  • RunspaceId。 イベントが発生したセッションを一意に識別する GUID。 このプロパティ値は、リモート コンピューターからイベントが転送された場合にのみ入力されます。

  • EventIdentifier。 現在のセッションにおけるイベント通知を一意に識別する整数 (Int32)。

  • 送信者。 イベントを生成したオブジェクト。 Action パラメーターの値には、$Sender自動変数に sender オブジェクトが含まれています。

  • SourceEventArgs。 存在する場合は、EventArgs から派生した最初のパラメーター。 たとえば、シグネチャがオブジェクトの送信者である Timers.ElapsedEventArgs e という形式のタイマー経過イベントでは、SourceEventArgs プロパティに Timers.ElapsedEventArgs が含まれます。 Action パラメーターの値には、$EventArgs自動変数にこの値が含まれています。

  • SourceArgs。 元のイベント署名のすべてのパラメーター。 標準イベントシグネチャの場合は、 $Args[0] 送信者を表し $Args[1] 、SourceEventArgs を 表します。 Action パラメーターの値には、$Args自動変数にこの値が含まれています。

  • SourceIdentifier。 イベント サブスクリプションを識別する文字列。 Action パラメーターの値には、自動変数の SourceIdentifier プロパティ$Eventにこの値が含まれています。

  • TimeGenerated。 イベントが生成された時刻を表す DateTime オブジェクト。 Action パラメーターの値には、自動変数の TimeGenerated プロパティ$Eventにこの値が含まれています。

  • MessageData。 イベント サブスクリプションに関連付けられているデータ。 ユーザーは、イベントを登録するときに、このデータを指定します。 Action パラメーターの値には、自動変数の MessageData プロパティ$Eventにこの値が含まれています。