構成ジョブで変数を使用する

最終公開日 : Sep 25, 2026
構成ジョブとは、1つ以上の管理対象インスタンスで実行できる構成コマンドのセットです。複数のインスタンスで同じ構成を実行する場合、構成で使用されるパラメータに異なる値を使用したい場合があります。これらのパラメータに異なる値を割り当てたり、複数のインスタンスでジョブを実行したりできるように、変数を定義できます。
たとえば、ロードバランシング仮想サーバーを追加し、2つのサービスを追加し、そのサービスを仮想サーバーにバインドする基本的なロードバランシング構成を考えてみましょう。ここで、2つのインスタンスで同じ構成を使用したいが、仮想サーバーとサービスの名前およびIPアドレスには異なる値を使用したい場合があります。構成ジョブ機能を使用すると、変数を使用して仮想サーバーとサービスの名前およびIPアドレスを定義することで、これを実現できます。
この例では、次のコマンドと変数が使用されています。
add lb vserver <servername> HTTP <ipaddress> <portnumber>
add service <servicename1> <ipaddress1> HTTP 80
add service <servicename2> <ipaddress2> HTTP 80
bind lb vserver <servername> <servicename1>
bind lb vserver <servername> <servicename2>
NetScaler® ADM で変数を定義して構成ジョブを作成するには:
  1. インフラストラクチャ > 構成ジョブ に移動します。
  2. ジョブの作成 をクリックします。
  3. ジョブの作成 ページで、ジョブ名、インスタンスタイプ、構成タイプなどのカスタムジョブパラメータを選択します。
  4. 構成エディターで、ロードバランシング仮想サーバー、2つのサービスを追加し、サービスを仮想サーバーにバインドするコマンドを入力します。変数に変換する値をダブルクリックして選択し、変数に変換 をクリックします。たとえば、ロードバランシングサーバーのIPアドレス *ipaddress* を選択し、次の図に示すように 変数に変換 をクリックします。
    変数に変換
  5. 変数の値がドル記号で囲まれていることを確認したら、変数をクリックして、名前、表示名、タイプなど、変数の詳細をさらに指定します。変数のデフォルト値をさらに指定する場合は、詳細設定オプションをクリックすることもできます。保存をクリックし、次に次へをクリックします。
    変数を定義 1
    残りのコマンドを入力し、すべての変数を定義します。
    変数を定義 2
  6. 構成ジョブの作成または編集中に定義したすべての変数を、統合された単一ビューで確認できます。
  7. 統合された単一ビューですべての変数を表示するには、次のいずれかを実行します。
    • 構成ジョブを作成する際、インフラストラクチャ > 構成ジョブに移動し、ジョブの作成を選択します。ジョブの作成ページで、構成ジョブの作成中に追加したすべての変数を確認できます。
    • 構成ジョブを編集する際、ネットワーク \> 構成ジョブに移動し、ジョブ名を選択して編集をクリックします。ジョブの構成ページで、構成ジョブの作成中に追加されたすべての変数を確認できます。
  8. 次に、変数のプレビュータブをクリックして、構成ジョブの作成または編集中に定義した変数を統合された単一ビューでプレビューできます。
    変数をプレビュー 1
  9. 新しいポップアップウィンドウが表示され、名前、表示名、タイプ、デフォルト値など、変数のすべてのパラメータが表形式で表示されます。これらのパラメータを編集および変更することもできます。いずれかのパラメータを編集または変更した後、完了ボタンをクリックします。
    変数をプレビュー 2
  10. 次に、構成エディタでコマンドを適切に再配置および並べ替えることができます。コマンド行をドラッグアンドドロップすることで、コマンドをある行から別の行に移動できます。また、テキストボックスのコマンド行番号を変更するだけで、コマンド行をある行から任意のターゲット行に移動または再配置することもできます。
  11. 構成ジョブを実行するインスタンスを選択します。
  12. 変数値を指定タブで、変数値の入力ファイルをアップロードオプションを選択し、入力キーファイルのダウンロードをクリックします。この例では、各インスタンスのサーバー名、サーバーとサービスのIPアドレス、ポート番号、サービス名を指定する必要があります。ファイルを保存してアップロードします。値が正確に定義されていない場合、システムがエラーをスローする可能性があります。
  13. 入力キーファイルはローカルシステムにダウンロードされ、以前に選択した各NetScalerインスタンスの変数値を指定して編集できます。Upload をクリックして、入力キーファイルをNetScaler ADMにアップロードします。Next をクリックします。入力キーファイルはローカルシステムにダウンロードされ、以前に選択した各NetScalerインスタンスの変数値を指定して編集できます。
    注 入力キーファイルでは、変数は次の3つのレベルで定義されます。
    • グローバルレベル
    • インスタンスグループレベル
    • インスタンスレベル
    グローバル変数は、すべてのインスタンスに適用される変数です。インスタンスグループレベルの変数値は、グループで定義されているすべてのインスタンスに適用されます。インスタンスレベルの変数値は、特定のインスタンスにのみ適用されます。
    NetScaler ADMは、インスタンスレベルの値を最優先します。個々のインスタンスの変数に値が指定されていない場合、NetScaler ADMはグループレベルで指定された値を使用します。グループレベルで値が指定されていない場合、NetScaler ADMはグローバルレベルで指定された変数値を使用します。3つのすべてのレベルで変数に入力を指定した場合、NetScaler ADMはインスタンスレベルの値をデフォルト値として使用します。
  14. Upload をクリックして、入力キーファイルをNetScaler ADMにアップロードします。Next をクリックします。
    重要
    MacからCSVファイルをアップロードすると、MacはCSVファイルをコンマではなくセミコロンで保存します。これにより、入力ファイルをアップロードしてジョブを実行すると、構成が失敗します。Macを使用している場合は、テキストエディタを使用して必要な変更を加え、ファイルをアップロードしてください。
  15. すべてのインスタンスに共通の変数を指定することもできます。Upload をクリックして、入力キーファイルをNetScaler ADMにアップロードします。
    変数値を含むキー入力ファイルは、構成ジョブに(同じファイル名で)保持されます。構成ジョブの作成または編集時に、以前に使用およびアップロードしたこれらの入力ファイルを表示および編集できます。
    構成ジョブの作成中に実行構成ジョブを表示するには、Network \> Configuration Jobs に移動し、Create Job をクリックします。Create Job ページで、Specify Variable Values タブの Common Variable Values for all Instances オプションを選択して、アップロードされたファイルを表示します。入力ファイルを編集するには、入力ファイルをダウンロードし、編集してアップロードします(同じファイル名を保持します)。
    構成ジョブの編集中に、すでに実行された構成ジョブを表示するには、Network \> Configuration Jobs に移動し、ジョブ名を選択して Edit をクリックします。Configure Job ページで、Specify Variable Values タブの Common Variable Values for all Instances オプションを選択して、アップロードされたファイルを表示します。入力ファイルを編集するには、入力ファイルをダウンロードし、編集してアップロードします(同じファイル名を保持します)。
  16. Job Preview タブで、各インスタンスまたはインスタンスグループで実行されるコマンドを評価および検証できます。
  17. 「実行」タブでは、ジョブを今すぐ実行するか、後で実行するようにスケジュールするかを選択できます。コマンドが失敗した場合にNetScaler ADMが取るべきアクションや、ジョブの成功または失敗に関するメール通知を他の詳細とともに送信するかどうかも選択できます。
    「ジョブのスケジュール」(/en-us/netscaler-application-delivery-management-software/media/executetabconfigjob-citrix.png)
ジョブを設定して実行した後、「インフラストラクチャ > 構成ジョブ」に移動し、設定したジョブを選択すると、ジョブの詳細を確認できます。「詳細」をクリックし、次に「変数詳細」をクリックすると、ジョブに追加された変数の一覧が表示されます。
「変数の一覧」(/en-us/netscaler-application-delivery-management-software/media/var6.png)
注
ステップ5で変数に指定した値は、ジョブを保存して終了した場合、または後で実行するようにジョブをスケジュールした場合に、NetScaler ADMによって保持されます。
Related information