2分鐘閱讀

CQE 佇列註冊指南

說明如何將 CQE（Custom Query Engine）指令碼註冊為特定邏輯伺服器（LSSN）上的排程。設定目標伺服器、執行週期和開始時間，然後註冊到佇列。

🚀 前往 CQE 佇列註冊頁面 →

🔄 整體流程 (CQE Flow)

flowchart TD
    A[管理者: CQERepoPut<br/>在倉庫中註冊指令碼] --> 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 佇列註冊將已註冊的指令碼分配為一個或多個邏輯伺服器（LSSN）上的排程。設定目標伺服器、執行週期和開始時間並註冊到佇列後，各伺服器的代理程式會定期輪詢佇列，接收並執行指令碼。

指令碼註冊和執行設定在 CQE 儲存庫清單（/zh-TW/cqeRepoList）中進行。本頁面用於將已註冊的指令碼分配給伺服器。

🔍 畫面組成

1. 選擇指令碼 (mssn)

從已註冊指令碼清單中選擇要執行的指令碼。仅顯示 CQE 儲存庫中已註冊的指令碼。

2. 目標伺服器 (lssngroup)

輸入要分配指令碼的邏輯伺服器 ID（LSSN），用逗號分隔。範例: 70371,70372,70373 點擊伺服器選擇按鈕會彈出目前專案（csn）下已註冊伺服器的清單。

3. 執行設定

啟用 (Active): 註冊後是否立即啟動排程。關閉時指令碼僅註冊但不會執行。
重複 (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（自動化）

上述畫面操作對應以下 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 — 在儲存庫中註冊指令碼
CQEQueueGet — 代理程式輪詢佇列

完整規格: CQE 儲存庫指令碼管理指南、giipdb docs/30_Specs/CQE_SPECIFICATION.md。

版本: 1.0 最後更新: 2026-09-19 來源檔案: giipv3/public/help/cqeQueuePut.zh-TW.md