排查 Azure Connected Machine 代理连接问题

本文提供了有关排查在配置适用于 Windows 或 Linux 的 Azure Connected Machine 代理时可能出现的问题的信息。 文中包括配置与服务的连接时的交互式和大规模安装方法。 如需常规信息，请参阅已启用 Azure Arc 的服务器概述。

代理错误代码

使用下表确定并解决在使用打印到控制台或脚本输出的 AZCM0000（“0000”可以是任何四位数）配置 Azure Connected Machine 代理时出现的问题。

代理详细日志

在遵循本文后面所述的故障排除步骤之前，所需的最少信息为详细日志。 使用 verbose (-v) 参数时，它包含 azcmagent 工具命令的输出。 对于 Windows，日志文件将写入 %ProgramData%\AzureConnectedMachineAgent\Log\azcmagent.log；对于 Linux，日志文件将写入 /var/opt/azcmagent/log/azcmagent.log。

Windows

下面是执行交互式安装时，使用 Connected Machine Agent 为 Windows 启用详细日志记录的命令示例。

& "$env:ProgramFiles\AzureConnectedMachineAgent\azcmagent.exe" connect --resource-group "resourceGroupName" --tenant-id "tenantID" --location "regionName" --subscription-id "subscriptionID" --verbose

下面是使用服务主体执行大规模安装时，使用 Connected Machine Agent 为 Windows 启用详细日志记录的命令示例。

& "$env:ProgramFiles\AzureConnectedMachineAgent\azcmagent.exe" connect `
  --service-principal-id "{serviceprincipalAppID}" `
  --service-principal-secret "{serviceprincipalPassword}" `
  --resource-group "{ResourceGroupName}" `
  --tenant-id "{tenantID}" `
  --location "{resourceLocation}" `
  --subscription-id "{subscriptionID}"
  --verbose

Linux

下面是执行交互式安装时，使用 Connected Machine Agent 为 Linux 启用详细日志记录的命令示例。

azcmagent connect --resource-group "resourceGroupName" --tenant-id "tenantID" --location "regionName" --subscription-id "subscriptionID" --verbose

下面是使用服务主体执行大规模安装时，使用 Connected Machine Agent 为 Linux 启用详细日志记录的命令示例。

azcmagent connect \
  --service-principal-id "{serviceprincipalAppID}" \
  --service-principal-secret "{serviceprincipalPassword}" \
  --resource-group "{ResourceGroupName}" \
  --tenant-id "{tenantID}" \
  --location "{resourceLocation}" \
  --subscription-id "{subscriptionID}"
  --verbose

服务的代理连接问题

下表列出了一些已知错误以及如何排除和解决这些问题的建议。

后续步骤

如果你的问题未在本文中列出，或者无法解决你遇到的问题，请尝试通过以下途径之一获取更多支持：

• 通过 Microsoft Q&A 获取 Azure 专家的解答。

• 提出 Azure 支持事件。 请转到 Azure 支持站点提交请求。