evntcmd
適用対象: Windows Server 2022、Windows Server 2019、Windows Server 2016、Windows Server 2012 R2、Windows Server 2012
構成ファイル内の情報に基づいて、トラップ、トラップ先、またはその両方へのイベントの変換を構成します。
構文
evntcmd [/s <computername>] [/v <verbositylevel>] [/n] <filename>
パラメーター
| パラメーター | 説明 |
|---|---|
/s <computername> |
トラップ、トラップ先、またはその両方へのイベントの変換を構成するコンピューターを名前で指定します。 コンピューターが指定されなかった場合は、構成がローカル コンピューター上で行われます。 |
/v <verbositylevel> |
トラップとトラップ先が構成されたときに表示される状態メッセージの種類を指定します。 このパラメーターは、0 から 10 の整数にする必要があります。 10 が指定された場合は、トレース メッセージや、トラップ構成が成功したかどうかに関する警告など、あらゆる種類のメッセージが表示されます。 0 が指定された場合は、メッセージが表示されません。 |
| /n | このコンピューターがトラップ構成の変更を受け取った場合は SNMP サービスを再起動しないように指定します。 |
<filename> |
構成するトラップとトラップ先へのイベントの変換に関する情報が含まれている構成ファイルを名前で指定します。 |
| /? | コマンド プロンプトにヘルプを表示します。 |
解説
トラップは構成するが、トラップ先は構成しない場合は、グラフィカル ユーティリティであるイベント トラップ トランスレーターを使用して有効な構成ファイルを作成できます。 SNMP サービスがインストールされている場合は、コマンド プロンプトで「evntwin」と入力することによって、イベント トラップ トランスレーターを開始できます。 必要なトラップを定義したら、[エクスポート] をクリックして、evntcmd での使用に適したファイルを作成します。 イベント トラップ トランスレーターを使用すると、構成ファイルを簡単に作成し、コマンド プロンプトで evntcmd を使用して構成ファイルで複数のコンピューター上のトラップをすばやく構成できます。
トラップを構成するための構文は次のとおりです。
#pragma add <eventlogfile> <eventsource> <eventID> [<count> [<period>]]次のテキストが該当する場合:
#pragma は、ファイル内のすべてのエントリの先頭に配置する必要があります。
パラメーターの add は、構成をトラップするイベントを追加する必要があることを指定します。
パラメーターの eventlogfile、eventsource、および eventID は必須です。eventlogfile はイベントが記録されるファイルを指定します。eventsource はイベントを生成するアプリケーションを指定します。eventID は各イベントを識別する一意の番号を指定します。
各イベントに対応する値を特定するには、コマンド プロンプトで「evntwin」と入力して、イベント トラップ トランスレーターを開始します。 [カスタム]、[編集] の順にクリックします。 [イベント ソース] で、フォルダーを参照して構成するイベントを探し、それをクリックしてから、[追加] をクリックします。 イベント ソース、イベント ログ ファイル、およびイベント ID に関する情報は、それぞれ、[ソース]、[ログ]、および [トラップ固有の ID] の下に表示されます。
count パラメーターは、オプションで、トラップ メッセージが送信される前にイベントが発生する必要がある回数を指定します。 このパラメーターを使用しなかった場合は、イベントが 1 回発生した後にトラップ メッセージが送信されます。
period パラメーターは、オプションですが、count パラメーターと一緒に使用する必要があります。 period パラメーターは、トラップ メッセージが送信される前に count パラメーターで指定された回数イベントが発生する必要がある時間の長さ (秒単位) を指定します。 このパラメーターを使用しなかった場合は、イベントが count パラメーターで指定された回数発生した後に、発生間の経過時間に関係なく、トラップ メッセージが送信されます。
トラップを削除するための構文は次のとおりです。
#pragma delete <eventlogfile> <eventsource> <eventID>次のテキストが該当する場合:
#pragma は、ファイル内のすべてのエントリの先頭に配置する必要があります。
パラメーターの delete は、構成をトラップするイベントを削除する必要があることを指定します。
パラメーターの eventlogfile、eventsource、および eventID は必須です。eventlogfile はイベントが記録されるファイルを指定します。eventsource はイベントを生成するアプリケーションを指定します。eventID は各イベントを識別する一意の番号を指定します。
各イベントに対応する値を特定するには、コマンド プロンプトで「evntwin」と入力して、イベント トラップ トランスレーターを開始します。 [カスタム]、[編集] の順にクリックします。 [イベント ソース] で、フォルダーを参照して構成するイベントを探し、それをクリックしてから、[追加] をクリックします。 イベント ソース、イベント ログ ファイル、およびイベント ID に関する情報は、それぞれ、[ソース]、[ログ]、および [トラップ固有の ID] の下に表示されます。
トラップ先を構成するための構文は次のとおりです。
#pragma add_TRAP_DEST <communityname> <hostID>次のテキストが該当する場合:
#pragma は、ファイル内のすべてのエントリの先頭に配置する必要があります。
パラメーターの add_TRAP_DEST は、コミュニティ内の指定されたホストにトラップ メッセージを送信する必要があることを指定します。
パラメーターの communityname は、トラップ メッセージが送信されるコミュニティを名前で指定します。
パラメーターの hostID は、トラップ メッセージを送信するホストを名前または IP アドレスで指定します。
トラップ先を削除するための構文は次のとおりです。
#pragma delete_TRAP_DEST <communityname> <hostID>次のテキストが該当する場合:
#pragma は、ファイル内のすべてのエントリの先頭に配置する必要があります。
パラメーターの delete_TRAP_DEST は、コミュニティ内の指定されたホストにトラップ メッセージを送信する必要がないことを指定します。
パラメーターの communityname は、トラップ メッセージが送信されないコミュニティを名前で指定します。
パラメーターの hostID は、トラップ メッセージを送信しないホストを名前または IP アドレスで指定します。
例
次の例は、evntcmd コマンドの構成ファイル内のエントリを示しています。 これらは、コマンド プロンプトで入力するようには設計されていません。
イベント ログ サービスが再起動された場合にトラップ メッセージを送信するには、次のように入力します。
#pragma add System Eventlog 2147489653
イベント ログ サービスが 3 分間で 2 回再起動された場合にトラップ メッセージを送信するには、次のように入力します。
#pragma add System Eventlog 2147489653 2 180
イベント ログ サービスが再起動されるごとのトラップ メッセージの送信を停止するには、次のように入力します。
#pragma delete System Eventlog 2147489653
Public という名前のコミュニティ内のトラップ メッセージを IP アドレスが 192.168.100.100 のホストに送信するには、次のように入力します。
#pragma add_TRAP_DEST public 192.168.100.100
Private という名前のコミュニティ内のトラップ メッセージを Host1 という名前のホストに送信するには、次のように入力します。
#pragma add_TRAP_DEST private Host1
トラップ先を構成しているのと同じコンピューターへの Private という名前のコミュニティ内でのトラップ メッセージの送信を停止するには、次のように入力します。
#pragma delete_TRAP_DEST private localhost