你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

azcmagent CLI 参考

Azure Connected Machine 代理命令行工具 azcmagent 可帮助你配置、管理服务器与 Azure Arc 的连接并对其进行故障排除。azcmagent CLI 与 Azure Connected Machine 代理一起安装，用于控制专门针对运行该 CLI 的服务器执行的操作。 将服务器连接到 Azure Arc 后，可以使用 Azure CLI 或 Azure PowerShell 模块启用扩展、管理标记以及对服务器资源执行其他操作。

除非另有规定，否则命令语法和标志代表最新版本的 Azure Connected Machine 代理中的可用选项。 有关详细信息，请参阅 Azure Connected Machine 代理的新增功能。

命令

Command	目的
azcmagent 检查	针对 Azure Arc 终结点运行网络连接检查
azcmagent 配置	管理代理设置
azcmagent 连接	将服务器连接到 Azure Arc
azcmagent 断开连接	断开服务器与 Azure Arc 的连接
azcmagent genkey	为异步加入生成公钥-私钥对
azcmagent 帮助	获取命令帮助
azcmagent 许可证	显示最终用户许可协议
azcmagent 日志	收集日志以排查代理问题
azcmagent 展示	显示代理状态
azcmagent 版本	显示代理版本

常见问题

如何安装 azcmagent CLI？

azcmagent CLI 与 Azure Connected Machine 代理捆绑在一起。 请查看 Azure Arc 的部署选项，了解如何安装和配置该代理。

CLI 安装在何处？

在 Windows 操作系统上，CLI 的安装位置为 %PROGRAMFILES%\AzureConnectedMachineAgent\azcmagent.exe。 在安装过程中，此路径会自动添加到系统 PATH 变量中。 你可能需要关闭再重新打开控制台以刷新 PATH 变量，并且只有这样才能在不指定完整路径的情况下运行 azcmagent。

在 Linux 操作系统上，CLI 的安装位置为 /opt/azcmagent/bin/azcmagent

azcmagent CLI 与适用于已启用 Azure Arc 的服务器的 Azure CLI 有什么差别？

azcmagent CLI 用于配置本地代理。 它负责将代理连接到 Azure、断开连接代理，以及配置代理 URL 和安全功能等本地设置。

连接代理后，Azure CLI 和其他管理体验用于与 Azure 中的 Azure Arc 资源交互。 这些工具可帮助你管理扩展、将资源移动到另一个订阅或资源组，以及远程更改 Arc 服务器的某些设置。