3分で読了

CQE キュー登録ガイド

CQE（Custom Query Engine）スクリプトを特定論理サーバー（LSSN）にスケジュールとして登録する方法を説明します。実行対象サーバー、実行周期、開始日時を設定してキューに登録します。

🚀 CQE キュー登録ページへ移動 →

🔄 全体フロー (CQE Flow)

flowchart TD
    A[管理者: CQERepoPut<br/>スクリプトをrepoに登録] --> B[tMgmtScript<br/>スクリプトリポジトリ]
    B --> C[管理者: CQEQueuePut<br/>対象サーバーにスケジュール割り当て]
    C --> D[tMgmtScriptList<br/>LSSN別スケジュール]
    D --> E[エージェント: CQEQueueGet<br/>定期ポーリング]
    E --> F[tMgmtQue<br/>実行キューからms_bodyを受信]
    F --> G[エージェント: ローカルで<br/>スクリプト実行]
    G --> H[KVSPut<br/>結果を報告]
    style A fill:#e1f5fe
    style B fill:#b3e5fc
    style C fill:#e1f5fe
    style D fill:#b3e5fc
    style E fill:#e8f5e9
    style F fill:#c8e6c9
    style G fill:#fff9c4
    style H fill:#ffccbc

📋 概要

CQE キュー登録は、登録済みスクリプトを1つ以上の論理サーバー（LSSN）にスケジュールとして割り当てる画面です。対象サーバー、実行周期、開始日時を設定してキューに登録すると、各サーバーのエージェントが定期的にキューをポーリングしてスクリプトを受信・実行します。

スクリプト登録と実行設定は CQE リポジトリ一覧（/ja/cqeRepoList）で行います。このページではすでに登録済みのスクリプトを選択してサーバーに割り当てます。

🔍 画面構成

1. スクリプト選択 (mssn)

登録済みスクリプト一覧から実行するスクリプト会选择します。一覧にはCQEリポジトリに登録済みのスクリプトのみ表示されます。

2. 対象サーバー (lssngroup)

スクリプトを割り当てる論理サーバーID（LSSN）をカンマ区切りで入力します。例: 70371,70372,70373 サーバー選択ボタンをクリックすると、現在プロジェクト（csn）に登録されたサーバー一覧がポップアップで表示されます。

3. 実行設定

有効 (Active): 登録直後にスケジュールを有効にするかどacíaを設定します。オフの場合、スクリプトは登録されますが実行されません。
繰り返し (Repeat): 0 または 1 = 一回限り、2 = 再帰（間隔ごとに繰り返し）。
実行間隔（分）: 繰り返し実行の場合の間隔を分で設定します。
開始日時: 初回実行が始まるUTC日時を入力します。

4. スクリプト種類 (script_type)

実行種類选择: ps1(PowerShell)、cmd、wsf、cmdui、ps1ui。詳細は CQE リポジトリスクリプト管理ガイドの「🔌 CQE API」節を参照してください。

5. カスタム変数 (custom_values)

任意フィールドです。サーバー別注入値を入力すると、スクリプト本文の {{CustomVariables}} がその値で置換されます。

6. キュー登録

すべての設定を終えたらこのボタンをクリックして、選択したサーバーにスクリプトをスケジュールとして登録します。

⚙️ 要件

**ログインセッション（CSN）**が必要です。
スクリプトはすでにCQEリポジトリに登録되어いいる必要があります。
対象LSSNが現在のプロジェクトに登録されている必要があります。

💡 注意事項

開始日時は UTC 基準で入力します。ローカル日時をそのまま入力すると、エージェントが未来日時として認識しスクリプトが永久に実行されない可能性があります。
スクリプトの {{sk}}、{{lssn}} プレースホルダーはエージェントがランタイムに自動注入します。
一回限り（repeat=1）スケジュールの active は強制実行後に 0 に下がります。再帰実行を継続するには手動で再度有効化する必要があります。

🔌 CQE API（自動化向け）

上記のUI操作は次のCQE APIバーブに対応します。

CQEQueuePut mssn lssngroup csn interval active script_type custom_values repeat startdate auid
- mssn: スクリプト固有ID
- lssngroup: カンマ区切りLSSN一覧
- interval: 実行間隔（分）
- repeat: 0/1=一回限り、2=再帰
- startdate: 開始日時（UTC）
- custom_values: {{CustomVariables}} 置換値
CQERepoPut — スクリプトをrepoに登録
CQEQueueGet — エージェントのキューポーリング

全体仕様: CQE リポジトリスクリプト管理ガイド、giipdb docs/30_Specs/CQE_SPECIFICATION.md。

バージョン: 1.0 最終更新: 2026-09-19 ソースファイル: giipv3/public/help/cqeQueuePut.ja.md