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-CN/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-CN.md