CCA 命令工具

借助 CCA 命令工具 CcaCmd.exe,管理员可从端点配置部署代理,从而提供对部署代理及其行为的高级控制。

管理员可使用此工具做好部署主映像的准备工作。这些命令可单独运行,也可以作为现有部署脚本的一部分在批处理文件中运行。

在此部分:

使用 CCA 命令工具之前

在使用 CcaCmd.exe 之前,必须满足以下条件:

  1. 在端点上安装 ClientCommunicationsAgent.msi。
  2. 以下权限必须在主页 > [服务器] > 部署组 > [部署组] > 设置 > 部署代理权限中启用:

    • 允许自助注册 - 映射到 CCA 命令工具开关 /URL/MOVE <GROUP NAME>
    • 允许注销 - 映射到 CCA 命令工具开关 /UNREGISTER/IMAGEPREP
    • 允许更新启动 - 映射到 CCA 命令工具开关 /UPDATEAGENTS/UPDATECONFIGS
  3. 您必须是本地管理员组的成员并使用提升的令牌运行。

使用 CCA 命令工具

CcaCmd.exe 命令如下:

命令

说明

/url

更改用于与管理服务器通信的 URL。
您可以选择添加一个用以自助注册的部署组。此操作需要为部署组启用允许自助注册权限。
请参阅部署代理权限

/imageprep

准备对此计算机进行部署,其将在下次轮询时注册。此命令可与 /unregister 命令结合使用。

运行 /imageprep 时,部署代理将自动在启动时检查和下载新配置,不考虑部署组设置。

/unregister

从管理服务器中注销部署代理并停止部署代理服务。请勿卸载任何 User Workspace Manager 代理或配置。这需要在部署组设置中启用允许注销

一旦注销计算机,必须重新启动部署代理服务才能使计算机重新注册。

/updateagents

启动安装分配给部署组的代理,覆盖安装计划。这需要在部署组设置中启用允许更新启动
如果安装程序提出请求,则会触发系统重启。可通过提供 /suppressreboot 选项来禁止系统重启。代理更新为异步更新。使用 /isupdating 检查部署代理是否仍在应用更新。

/updateconfigs

启动安装分配给部署组的配置,覆盖安装计划。这需要在部署组设置中启用允许更新启动。配置更新为异步更新。使用 /isupdating 检查部署代理是否仍在应用更新。

/isupdating

确定先前对 /updateagents/updateconfigs 的调用是否仍在处理更新。

/pollnow

发起服务器轮询。

/move <group_name>

发起将计算机移动至指定组的请求。

请注意,要移动计算机,必须同时在当前部署组和目标部署组中启用允许自助注册权限。请参阅部署代理权限

发起移动请求时,管理命令提示将确认何时提交操作。但是,系统不会针对生成的移动命令提供报告。除非已在两个部署组中设置所需的权限,否则将不能执行此命令。

相关主题