Endpoint Central 批量部署软件实操教程，三步搞定 500 台终端

• 适用对象：ManageEngine Endpoint Central 运维人员
• 环境要求：中央控制台已就绪，目标终端已安装并上线 Agent

本文以一次 500 台终端的软件分发为例，按「准备安装包 → 建部署配置 → 看结果与回滚」三步拆解。每步给出控制台菜单路径、可复制命令与验证方法。

说明：不同版本菜单文案略有差异，本文以官方标准流程为准；若你的控制台标签不同，按相同功能定位即可。

执行前检查清单

开始之前逐项确认，任一项不满足都会导致分发失败：

第一步：准备安装包（Add Package）

1.1 添加包

菜单路径：

软件分发 → 添加包（Add Package）

在添加包窗口填写：

1.2 选择包来源（500 台必决策点）

• 网络共享路径（Network Path）：适用于同网段内分发。共享文件夹须赋予 Everyone 组读取权限，且所有目标计算机均可访问。优点是不占控制台仓库、带宽走内网。
• HTTP 路径（HTTP Path）：适用于分支网点、远程或跨 VPN 的终端。安装文件上传到控制台仓库，由 Agent 经 HTTP 拉取，避免共享权限与内网连通问题。

若目标机访问网络共享不稳定，可在添加包时勾选「复制文件/文件夹到客户端」（Copy file/folder to client machines），让 Agent 先缓存再安装，降低因瞬时断连导致的失败。

1.3 静默参数（关键字段）

Endpoint Central 将"安装命令"中的指令原样交由目标机 Agent 执行。静默安装指不弹界面、无需人工干预的自动安装。

MSI 标准静默安装：

msiexec /i app.msi /qn

生产环境推荐（带日志、禁止自动重启）：

msiexec /i app.msi /qn /norestart /l*v C:\temp\install.log

常见 MSI 参数含义：

EXE 安装包静默参数（因打包器而异，无统一标准）：

EXE 没有通用静默参数。参数以软件官方文档为准；文档缺失时，用测试机实测确认。命令行加 /? 或 -h 通常可打印该安装器支持的参数。

EXE 成功返回码异常：部分 EXE 安装器即使成功也返回非 0（如返回 1 或自定义码）。Endpoint Central 以命令返回码判定成败（认 0 和 3010 为成功），这类安装器会被误判为"失败"。对策：在包设置中配置自定义成功代码（Success Codes），把该安装器的成功返回码加入白名单。

1.4 配置卸载命令（用于回滚）

建包时在"卸载命令"字段填写，避免回滚时再临时查找：

:: MSI 按产品 GUID 卸载
msiexec /x {PRODUCT-GUID} /qn /norestart

:: 已知旧版 .msi 也可直接指向上一版本安装包
msiexec /x old_app.msi /qn

产品 GUID 可在测试机注册表 HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall 下查到，或用 PowerShell 获取：

Get-CimInstance Win32_Product | Where-Object {$_.Name -like "*软件名*"} | Select Name, IdentifyingNumber

Get-WmiObject 在新版 PowerShell 中已弃用，建议用 Get-CimInstance。

1.5 测试机验证（必须，不可跳过）

1. 走完第二步的部署流程，先只选 1 台测试机作为目标，提交部署。
2. 远程连接测试机，确认：软件已安装、可正常启动、无残留弹窗。
3. 检查安装日志返回码（详细返回码在 Agent 日志中，控制台仅显示成功/失败汇总）：

只有测试机返回码为 0（或 3010 且已规划重启），才进入第二步全量。

第二步：建部署配置（Deploy）

注意：第一步只是"定义包"，不会自动安装。真正的推送发生在本步骤创建部署配置并提交后。

2.1 进入部署配置

菜单路径：

软件分发 → 安装/卸载软件 → Windows → 计算机配置（Computer Configuration）

点击后进入配置向导，按以下顺序填写。

2.2 命名配置

填写配置名称与描述，如 WPS_12.1.0_全量推送_20260729。命名带版本和日期，便于后续审计与回滚定位。

2.3 定义包设置（选择第一步创建的包）

• 操作类型：选「安装」（回滚时选「卸载」）。
• 包名称：从下拉菜单选择第一步创建的包（如 WPS_12.1.0）。

此步是新手最容易漏的——忘记关联已建好的包，导致部署了空配置。

2.4 安装身份（Install As）

选错上下文是 1603 权限失败的常见根因：计算机级软件用了 Run As User 却无足够权限，或反之。

2.5 部署策略（Deployment Policy）——时间窗在这里设

部署策略是一组可复用的策略，包含：

• 部署窗口（Deployment Window）：设定允许安装的时间段，如 20:00 – 06:00。
• 重启/关机策略：安装后是否允许自动重启、如何通知用户。
• 跳过用户 / 通知消息：向终端用户弹出的提示文案。

可直接选用系统预置策略，或「创建/修改」自定义策略。建议把"下班后窗口 + 失败重试 + 关冲突进程"固化成一个策略模板反复复用。

2.6 关闭冲突进程（Pre-deployment Activity）

若软件安装需先退出自身进程（如旧版浏览器、杀软自我防护），在**部署前活动（Pre-deployment Activity）**中配置「结束进程（Kill Process）」并列出进程名；部分版本也可在部署策略中设置。

不同版本入口文案不同（“部署前活动 / 前部署操作 / Deployment Policy”），按你控制台的相同功能定位即可。

2.7 定义目标

目标选择维度：

• 按部门 / OU：域环境按组织架构一次圈选，如"销售部 OU"。
• 按自定义集合（Collection）：将"Win10 64 位""某 IP 段"存为集合，可复用。
• 按计算机组 / 手动勾选：特殊机型或小范围使用。

500 台建议分批（每批 100 台），降低控制台与网络压力，也便于灰度。

2.8 执行设置（Execution Settings）

2.9 计划设置（Scheduler Settings）

• Install After（生效时间）：部署在该日期时间之后才开始推。
• Do not apply after（失效时间）：超过该时间不再对新目标生效，避免配置无限重试。

若只设了"部署窗口"却选了"立即部署"，窗口会被绕过——时间窗只在计划部署下生效。

2.10 提交部署（关键触发动作）

配置完成后，底部有两个按钮，必须点其中一个才会真正下发：

• 部署（Deploy）：配置进入 Agent 的 90 分钟刷新周期（或系统启动时、或部署窗口内）生效，不是秒级推送。
• 立即部署（Deploy Immediately）：忽略刷新周期，立刻向在线终端推送。

代理刷新周期说明：Endpoint Central Agent 默认约每 90 分钟与控制台同步一次（可在 Agent 设置调整）。提交"部署"后，需等待下一个刷新周期 Agent 才会拉取任务——这是"配完没动静"最常见的原因，不是失败了。想加速可手动触发 Agent 刷新或在目标机服务中重启 Endpoint Central Agent 服务。

第三步：看结果与回滚

3.1 查看进度

菜单路径：

软件分发 → 部署状态（Deployment Status）

面板实时显示每台终端状态：成功 / 失败 / 进行中，以及汇总计数。详细返回码需查看对应终端的 Agent 日志。

3.2 失败机处理

1. 在失败列表中点击机器，查看错误码与日志。
2. 对照下表定位原因并修复：

3. 修复后右键该机器 → 重新部署，无需全量重跑。

3.3 回滚到旧版本

新版本出现兼容性问题时：

软件分发 → 选中新版本包 → 安装/卸载软件 → 计算机配置 → 操作类型选「卸载」→ 部署卸载到目标集合
软件分发 → 选中旧版本包 → 安装/卸载软件 → 计算机配置 → 操作类型选「安装」→ 重新部署到目标集合

前提：第一步建包时已填写卸载命令。建议新旧两个版本包长期保留在控制台，便于随时切换。

常见问题与排查

Q1：500 台同时拉安装包，带宽打满怎么办？

• 分批部署 + 设部署窗口；
• 跨分支用 HTTP 路径上传到控制台仓库，或配置「分发服务器（Distribution Server）」就近下发。

Q2：域外终端收不到策略？

• 这些机器状态为"未管理"，需先通过 DMZ 中继或手动安装包部署 Agent，上线后再纳入集合。

Q3：配完部署没反应，是失败了吗？

• 多半是在等 Agent 刷新周期（默认约 90 分钟）。先在「部署状态」确认是否显示"进行中/待执行"，而非直接判定失败。

Q4：安装完成但软件打不开？

• 查安装日志返回码；3010 表示需重启，排期统一重启即可。
• 检查是否缺少运行库依赖（见错误码表 0x643）。

Q5：EXE 静默参数怎么确认？

• 查官方文档；无文档时运行 setup.exe /? 打印参数，或测试机实测。

操作要点

1. 静默参数先试点：1–5 台验证通过（返回码 0）再全量，避免 500 台同时失败。
2. Agent 是前提：未上线终端无法接收策略，先完成 Agent 铺装。
3. 回滚要留后路：建包即填卸载命令，新旧版本包都保留。
4. 分批 + 部署窗口：减轻网络与控制台压力，也便于灰度发现问题。
5. 别漏"部署"按钮：定义包≠推送，必须提交 Deploy/Deploy Immediately 才生效；提交后等刷新周期，勿误判。
6. Install As 与包来源：计算机级软件用 System User，跨网点用 HTTP 路径，共享路径须 Everyone 读权限。