[index] SNMPプラグイン（AT-VST-APL版）リファレンスマニュアル 2.15.0

# 画面リファレンス / システム / アクションコマンド

アクションコマンドは何らかのイベント（エラー、トラップ受信など）が発生したときに実行するアクションを定義したものです。
イベント発生時にどのアクションを実行するかは「画面リファレンス」/「システム」/「イベントフィルター」で設定します。

## アクションコマンドの一覧

> Note

> > 列の見出し（「ID」「コマンドタイプ」「メモ」）をクリックすると、該当列を昇順・降順にソートできます。

表 1：アクションコマンドの一覧
項目 | 内容
--- | ---
表示件数 | 一覧のページに表示するアクションコマンドの件数を、10件、25件、50件、またはすべてから選択します。
「新規作成」ボタン | アクションコマンドを新しく登録します。 「アクションコマンドの作成」画面が表示されます。
クリップボードにコピー | 登録されたアクションコマンドのID、コマンドタイプ、メモを、タブ区切りテキスト形式でクリップボードに保存します。 アクションコマンドの一覧をテキストエディタにコピーしたい場合などに使います。 検索フィールドにより対象を絞り込むことができます。表示件数、ページは影響しません。
CSVファイルにエクスポート | 登録されたアクションコマンドのID、コマンドタイプ、メモを、CSV （カンマ区切りテキスト）ファイルとしてダウンロードします。 検索フィールドにより対象を絞り込むことができます。表示件数、ページは影響しません。
Excelファイルにエクスポート | 登録されたアクションコマンドのID、コマンドタイプ、メモを、Excelブック（拡張子：xlsx、Microsoft Excel 2007以降）ファイルとしてダウンロードします。 検索フィールドにより対象を絞り込むことができます。表示件数、ページは影響しません。
印刷 | 登録されたアクションコマンドのID、コマンドタイプ、メモを、Webブラウザーのポップアップウィンドウまたは新規タブに一覧表示し、印刷ダイアログを表示します。 検索フィールドにより対象を絞り込むことができます。表示件数、ページは影響しません。
検索フィールド | 検索したいキーワードを入力すると、一覧表示、コピー、CSV/Excelファイルにエクスポート、印刷の対象を絞り込むことができます。 大文字/小文字の違いは無視されます。
ID | アクションコマンドを作成した際に決定されるIDを表示します。
コマンドタイプ | SNMPプラグインに登録されたアクションコマンドのコマンドタイプを表示します。
メモ | SNMPプラグインに登録されたアクションコマンドのメモを表示します。
「編集」ボタン | 該当のアクションコマンドの「アクションコマンドの更新」画面を開きます。
「詳細」ボタン | 該当のアクションコマンドの「アクションコマンドの詳細」画面を開きます。
「削除」ボタン | 「アクションコマンドの削除」ダイアログが表示されます。 「はい」ボタンをクリックすると、該当のアクションコマンドが削除されます。「いいえ」ボタンまたはダイアログ左上の「閉じる（×）」ボタンをクリックすると、「イベントフィルターの一覧」に戻ります。
ページ選択 | 一覧に現在表示している範囲を、ページ単位で指定します。 先頭 先頭ページを表示します。 前へ 現在の表示ページの1つ前のページを表示します。 ページ番号 数字をクリックすると、該当のページを表示します。現在表示中のページは灰色のボタン背景で強調表示します。 次へ 現在の表示ページの1つ次のページを表示します。 最後 最終ページを表示します。

## アクションコマンドの作成

アクションコマンドを新規に作成します。

表 2：アクションコマンドの作成
項目 | 内容
--- | ---
コマンドタイプ | SNMPプラグインにデフォルトで用意されているコマンドタイプをドロップダウンリストから選択します。 AVM EX メール送信： AVM EXのSMTP設定を利用したメール送信が可能です。事前にAVM EXのシステム管理画面で、SMTP設定を完了させてください。SMTP OAuth2認証は、このコマンドタイプでのみサポートされます。 メール送信： SNMPプラグイン付属の簡易メールクライアント「minimail」が使用されます。minimailは、コマンドラインから起動する簡易的なメールクライアントです。このクライアントは、メールの送信のみ可能で受信はできません。 経路テストコマンド実行： Tracerouteを実行します。「パラメーター」欄が入力可能な状態になります。 リモートシェルコマンド実行： リモートシェル（rsh）コマンドを実行します。「パラメーター」欄が入力可能な状態になります。
コマンド | 本バージョンでは未サポートです。
パラメーター | SNMPプラグインにデフォルトで用意されているパラメーターに対して、詳細なオプションを指定します。
メモ | コマンドの説明を入力できます。4096文字以内で、半角および全角の英字・数字・かな・漢字・記号を指定できます。 コマンドタイプに応じてデフォルトの説明が入力されています。イベントフィルターにアクションコマンドを指定する際に識別しやすいよう、任意のメモを入力してください。
「新規作成」ボタン | 新規アクションコマンドの設定内容を保存します。

### パラメーター

アクションコマンドに「AVM EX メール送信」、「メール送信」、「経路テストコマンド実行」、または「リモートシェルコマンド実行」を指定した場合のパラメーターは、以下のように指定します。
■ AVM EX メール送信
書式：<オプション>

- <オプション>：

  表 3：AVM EX メール送信パラメーター オプション
  パラメーター名 | 説明
  --- | ---
  -t addr [,addr .. ] または --to addr [,addr .. ] | （必須）メール受信者（相手）のメールアドレスを指定します。カンマ区切りで複数指定可。
  -c addr [,addr .. ] または --cc addr [,addr .. ] | カーボンコピー送信先のメールアドレスを指定します。カンマ区切りで複数指定可。
  -s "string" または --subject "string" | （必須）メールのタイトルをダブルクォート（"）で囲んで指定します。 Note メールのタイトルに「特殊変数」を使えます。
  -m "content" または --mailbody "content" | 送信するメールの内容（本文）をダブルクォート（"）で囲んで指定します。改行は「\n」で指定します。 Note メール本文に「特殊変数」を使えます。

■ メール送信
書式：<サーバー名> <オプション>...

- <サーバー名>：
  メールサーバー名（必須）
- <オプション>：

  表 4：メール送信パラメーター オプション
  オプション | 説明
  --- | ---
  -p port または --port port | ポート番号を指定します。
  -f addr または --from addr | メール送信者（自分）のメールアドレスを指定します。
  -t addr [,addr .. ] または --to addr [,addr .. ] | （必須）メール受信者（相手）のメールアドレスを指定します。カンマ区切りで複数指定可。
  -c addr [,addr .. ] または --cc addr [,addr .. ] | カーボンコピー送信先のメールアドレスを指定します。カンマ区切りで複数指定可。
  -b addr [,addr .. ] または --bcc addr [,addr ..] | ブラインドカーボンコピー送信先のメールアドレスを指定します。カンマ区切りで複数指定可。
  -r addr または --replyto addr | メール受信者が返信する場合に使う返信先（自分）を指定します。
  -s "string" または --subject "string" | （必須）メールのタイトルをダブルクォート（"）で囲んで指定します。 Note メールのタイトルに「特殊変数」を使えます。
  -m "content" または --mailbody "content" | 送信するメールの内容（本文）をダブルクォート（"）で囲んで指定します。改行は「\n」で指定します。 Note メールの本文に「特殊変数」を使えます。
  -@ {JIS7|UTF8} または --charset {JIS7|UTF8} | 文字セットをJIS7またはUTF8のいずれかから指定します。
  -B または --OP25B | OP25B（Outbound Port 25 Blocking）を使用する場合に指定します。 -p（または--port）を指定しない場合、-p 587が指定されます。
  -S または --SMTPS | SMTPS（SMTP over SSL/TLS）を使用する場合に指定します。 -p（または--port）、-B（または--OP25B）を指定しない場合、-p 465が指定されます。
  -T または --STARTTLS | STARTTLSを使用する場合に指定します。 このオプションを使う場合、-S（または--SMTPS）の指定が必要です。
  -F または --no-check-certificate | 証明書を検証しない場合に指定します。
  -A または --SMTP-AUTH | SMTP認証（SMTP AUTH）を使用する場合に指定します。
  -P または --PLAIN | SMTP認証でPLAINを使用する場合に指定します。
  -L または --LOGIN | SMTP認証でLOGINを使用する場合に指定します。
  -C または --CRAM-MD5 | SMTP認証でCRAM-MD5を使用する場合に指定します。
  -D または --DIGEST-MD5 | SMTP認証でDIGEST-MD5を使用する場合に指定します。
  -u username または --userid username | メール送信に用いるユーザー名を指定します。
  -w password または --password password | メール送信に用いるユーザーのパスワードを指定します。

■ 経路テストコマンド実行
書式：<オプション> IPアドレス

- <オプション>：

  表 5：経路テストコマンド実行パラメーター オプション
  オプション | 説明
  --- | ---
  -m | 最大ホップ数（回）

■ リモートシェルコマンド実行
書式：<オプション> ホスト名 コマンドライン

- <オプション>：

  表 6：リモートシェルコマンド実行パラメーター オプション
  オプション | 説明
  --- | ---
  -l | リモートホスト上で使用するユーザー名を指定します。

### 特殊変数

アクションコマンドの「パラメーター」には、以下の特殊変数を指定できます。
特殊変数はパーセント記号（%）で始まる文字列です。パラメーター中にこれらの変数を記述した場合、アクションコマンドの実行時に、パラメーター内の各変数が具体的な値に展開された上でコマンドに引き渡されます。

表 7：アクションコマンド 特殊変数
変数名 | 説明
--- | ---
%name | ログイベント発生源の名前（ノードの名前など）
%adr | アドレス。IPアドレスとMACアドレスの両方がある場合は、IPアドレスが使われます。
%ip | IPアドレス。対象となる機器ノードにIPv4とIPv6のアドレスが指定されている場合は、IPv4のアドレスが優先されます。
%ipv4 | IPv4アドレス
%ipv6 | IPv6アドレス
%mac | MACアドレス
%msg | メッセージ（ログイベントの詳細）
%type | ログ種別
%subt | イベント
%level | ログレベル（「ユーザー」「経過表示」「デバッグ」のいずれか）
%time | ログイベントの発生日時
%aid | アクションコマンドID番号

> Note

> > 対象となる機器ノードにIPv4、IPv6アドレス、MACアドレスが指定されている場合で、アクションコマンドではいずれか1種類のアドレスのみが使用されます。
> > アドレスは、IPv4アドレス → IPv6アドレス → MACアドレス の優先順位に基づいて選択されます。
> > 例えば既にIPv4アドレス（%ip、%ipv4）が指定されている場合、IPv6アドレス（%ipv6）およびMACアドレス（%mac）の欄は「---」と表示されます。

> Note

> > 特殊変数%ipv6および%aidは未サポートです。

## アクションコマンドの詳細

アクションコマンドの詳細を表示します。

表 8：アクションコマンドの詳細
項目 | 内容
--- | ---
ID | アクションコマンドを作成した際に決定されるIDを表示します。
コマンドタイプ | コマンドタイプ（AVM EX メール送信、メール送信、経路テストコマンド実行、リモートシェルコマンド実行のいずれか）を表示します。
コマンド | 未サポートのため、空欄
パラメーター | SNMPプラグインにデフォルトで用意されているパラメーターに対して、詳細なオプションを指定します。
メモ | アクションコマンドのメモを表示します。
編集 | クリックすると、該当のアクションコマンドの「アクションコマンドの更新」画面を開きます。
削除 | 「アクションコマンドの削除」ダイアログが表示されます。 「はい」ボタンをクリックすると、該当のアクションコマンドが削除されます。「いいえ」ボタンまたはダイアログ左上の「閉じる（×）」ボタンをクリックすると、「アクションコマンドの詳細」に戻ります。

## アクションコマンドの更新

アクションコマンドの設定を変更します。

表 9：アクションコマンドの更新
項目 | 内容
--- | ---
ID | アクションコマンドを作成した際に決定されるIDを表示します。
コマンドタイプ | SNMPプラグインにデフォルトで用意されているコマンドタイプをドロップダウンリストから選択します。 AVM EX メール送信： AVM EXのSMTP設定を利用したメール送信が可能です。事前にAVM EXのシステム管理画面で、SMTP設定を完了させてください。SMTP OAuth2認証は、このコマンドタイプでのみサポートされます。 メール送信： SNMPプラグイン付属の簡易メールクライアント「minimail」が使用されます。minimailは、コマンドラインから起動する簡易的なメールクライアントです。このクライアントは、メールの送信のみ可能で受信はできません。 経路テストコマンド実行： Tracerouteを実行します。「パラメーター」欄が入力可能な状態になります。 リモートシェルコマンド実行： リモートシェル（rsh）コマンドを実行します。「パラメーター」欄が入力可能な状態になります。
コマンド | 未サポートのため、空欄
パラメーター | SNMPプラグインにデフォルトで用意されているパラメーターに対して、詳細なオプションを指定します。 オプションのパラメーターは、「パラメーター」を参照してください。 また、オプションの各パラメーターの値には、発生したイベントに応じた特殊変数を使用できます。詳しくは、「特殊変数」を参照してください。
メモ | コマンドの説明を入力できます。4096文字以内で、半角および全角の英字・数字・かな・漢字・記号を指定できます。 コマンドタイプに応じてデフォルトの説明が入力されています。イベントフィルターにアクションコマンドを指定する際に識別しやすいよう、任意のメモを入力してください。
「保存」ボタン | アクションコマンドの設定内容の変更を保存します。