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

使用部署脚本将混合计算机连接到 Azure

可以通过手动执行一组步骤，为环境中的一个或多个 Windows 或 Linux 计算机启用已启用 Azure Arc 的服务器。或者，可以运行我们提供的模板脚本来使用自动化方法。此脚本可以自动下载和安装两个代理。

如果没有 Azure 订阅，请在开始之前创建一个免费帐户。

SQL Server 的自动连接

将 Windows 或 Linux 服务器连接到还安装了 Microsoft SQL Server 的 Azure Arc 时，SQL Server 实例也会自动连接到 Azure Arc。 Azure Arc 启用的 SQL Server 为你的 SQL Server 实例和数据库提供详细清单和额外管理功能。在连接过程中，扩展将部署到已启用 Azure Arc 的服务器，并将新角色应用到 SQL Server 和数据库。如果您不想自动将您的 SQL 服务器连接到 Azure Arc，可以通过在将其连接到 Azure Arc 时，向 Windows 或 Linux 服务器添加名称为 ArcSQLServerExtensionDeployment 且值为 Disabled 的标记来选择退出。

有关详细信息，请参阅管理 Azure Arc 启用的 SQL Server 自动连接。

先决条件

这种安装和配置代理的方法要求你在计算机上拥有管理员权限。在 Linux 上，使用根帐户，在 Windows 上，你必须是本地管理员组的成员。
在开始之前，请查看 Connected Machine 代理先决条件，并验证订阅和资源是否符合要求。有关支持的区域和其他相关注意事项的信息，请参阅支持的 Azure 区域。

Note

遵循最佳安全做法，避免使用具有 所有者 访问权限的 Azure 帐户来加入服务器。相反，请使用仅分配了 Azure Connected Machine 注册或 Azure Connected Machine 资源管理员角色的帐户。若要了解详细信息，请参阅 Azure 标识管理和访问控制安全最佳做法。

从 Azure 门户生成安装脚本

使用 Azure 门户创建脚本，自动下载和安装代理，并建立与 Azure Arc 的连接。要完成此过程，请执行以下步骤：

在 Azure 门户顶部，搜索并选择 Azure Arc。
在服务菜单中，展开 “基础结构”，然后选择“ 计算机”。
选择“ 载入/创建”，然后选择“ 载入现有计算机”。
在 “基本信息 ”页上，提供以下内容：
1. 选择计算机的“订阅”和“资源组”。
2. 在 “区域”下，选择要存储服务器的元数据的 Azure 区域。
3. 在 “操作系统” 下，选择脚本配置为在其上运行的操作系统。
4. 在 “连接”方法下：
  1. 选择 公共终结点 或 专用终结点。如果选择 “专用终结点”，可以选择现有的专用链接范围或创建新的专用链接范围。
  2. 如果要使用 代理服务器 URL，请输入代理服务器 IP 地址或计算机以格式 http://<proxyURL>:<proxyport>使用的名称和端口号。
  3. 如果选择 公共终结点 并想要使用 Azure Arc 网关，请选择现有的 网关资源 或创建一个新的。
5. 在 “身份验证”下，手动选择“ 对计算机进行身份验证”，然后选择“ 下一步”。
在 “标记”下，查看建议的默认 物理位置标记 并输入值，或指定一个或多个 自定义标记 来支持标准。
选择“下一步”。
在 “下载并运行脚本”下，查看摘要信息。如果需要进行更改，请选择 “上一页 ”并进行必要的编辑。
选择“ 下载”，然后选择“ 关闭”。

对于 Windows，你会被提示保存 OnboardingScript.ps1，而对于 Linux，你会保存 OnboardingScript.sh 到计算机。

可以运行 Windows Installer 包 AzureConnectedMachineAgent.msi 来手动安装 Connected Machine 代理。可以从 Microsoft 下载中心下载最新版本的 Windows 代理 Windows Installer 包。

Note

要安装或卸载代理，必须拥有“管理员”权限。
必须先下载安装程序包并将其复制到目标服务器上的文件夹，或者从共享网络文件夹下载并复制。如果在没有任何选项的情况下运行安装程序包，则会启动安装向导，你可以按照该向导以交互方式安装代理。

如果计算机需要通过代理服务器与服务通信，请在安装代理后运行以下步骤中所述的命令。此命令将设置代理服务器系统环境变量 https_proxy。使用此配置时，代理将使用 HTTP 协议通过代理服务器进行通信。

如果不熟悉 Windows Installer 包的命令行选项，请查看 Msiexec 标准命令行选项和 Msiexec 命令行选项。

例如，要查看帮助和快速参考选项，请运行包含 /? 参数的安装程序。

msiexec.exe /i AzureConnectedMachineAgent.msi /?

若要以无提示方式安装代理并在文件夹中创建安装程序日志文件 C:\Support\Logs ，请运行以下命令。
```
msiexec.exe /i AzureConnectedMachineAgent.msi /qn /l*v "C:\Support\Logs\Azcmagentsetup.log"
```
如果完成安装后代理无法启动，请检查日志以获取详细的错误信息。日志目录为 %ProgramData%\AzureConnectedMachineAgent\log。
如果计算机需要通过代理服务器进行通信，请运行以下命令来设置代理服务器环境变量。将{proxy-url}替换为你的代理服务器地址（例如proxy.example.com），并将{proxy-port}替换为端口号（例如8080）。
```
[Environment]::SetEnvironmentVariable("https_proxy", "http://{proxy-url}:{proxy-port}", "Machine")
$env:https_proxy = [System.Environment]::GetEnvironmentVariable("https_proxy","Machine")
# For the changes to take effect, the agent service needs to be restarted after the proxy environment variable is set.
Restart-Service -Name HIMDS
```
Note

代理不支持设置代理身份验证。

有关详细信息，请参阅配置特定于代理的代理配置。
安装代理后，将其配置为与 Azure Arc 服务通信。

参数
- --resource-group（字符串，示例： myResourceGroup
- --tenant-id（字符串，示例： aaaabbbb-0000-cccc-1111-dddd2222eeee
- --subscription-id（字符串，示例： aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e
- --location（字符串，示例： eastus
- --cloud（字符串，示例： AzureCloud
- --proxy（字符串，示例： http://proxy.example.com:8080
```
& "$env:ProgramFiles\AzureConnectedMachineAgent\azcmagent.exe" connect `
  --resource-group "myResourceGroup" `
  --tenant-id "aaaabbbb-0000-cccc-1111-dddd2222eeee" `
  --location "eastus" `
  --subscription-id "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e"
```

登录服务器。
打开权限提升的 PowerShell 命令提示符。

Note

该脚本仅支持从 64 位版本的 Windows PowerShell 运行。
切换到您使用 cd 命令将脚本复制到的文件夹或共享中，然后通过运行 .\OnboardingScript.ps1 脚本在服务器上执行该脚本。例如：
```
cd $env:USERPROFILE\Downloads
.\OnboardingScript.ps1
```

如果完成安装后代理无法启动，请检查日志以获取详细的错误信息。日志目录为 %ProgramData%\AzureConnectedMachineAgent\log。

在 Linux 上安装代理

手动安装
脚本安装

适用于 Linux 的 Connected Machine 代理以分发版的首选包格式（.RPM 或 .DEB）提供，托管于 Microsoft 包存储库中。 shell 脚本捆绑包 Install_linux_azcmagent.sh 执行以下操作：

将主机配置为从 packages.microsoft.com 下载代理包。
安装混合资源提供程序包。

（可选）可以通过包含 --proxy "{proxy-url}:{proxy-port}" 参数使用代理信息来配置代理。使用此配置时，代理将使用 HTTP 协议通过代理服务器进行通信。

该脚本还包含用于识别受支持和不受支持分发包的逻辑，并可验证执行安装所需的权限。

若要下载并安装代理，请运行以下命令：

# Download the installation package.
wget https://aka.ms/azcmagent -O ~/Install_linux_azcmagent.sh

# Install the Azure Connected Machine agent.
bash ~/Install_linux_azcmagent.sh

如果计算机需要通过代理服务器进行通信以连接到 Internet，请包括参数 --proxy ，例如：

# Download the installation package.
wget https://aka.ms/azcmagent -O ~/Install_linux_azcmagent.sh

# Install the Azure Connected Machine agent.
bash ~/Install_linux_azcmagent.sh --proxy "proxy.contoso.com:8080"

安装代理后，将其配置为与 Azure Arc 服务通信：

参数
- --resource-group（字符串，示例： myResourceGroup
- --tenant-id（字符串，示例： aaaabbbb-0000-cccc-1111-dddd2222eeee
- --subscription-id（字符串，示例： aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e
- --location（字符串，示例： eastus
- --cloud（字符串，示例： AzureCloud
- --proxy（字符串，示例： http://proxy.example.com:8080
```
azcmagent connect \
  --resource-group "myResourceGroup" \
  --tenant-id "aaaabbbb-0000-cccc-1111-dddd2222eeee" \
  --location "eastus" \
  --subscription-id "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e" \
  --cloud "AzureCloud"
```

使用具有根访问权限的帐户登录到服务器。
切换到脚本所复制到的文件夹或共享，然后在服务器上运行 ./OnboardingScript.sh 脚本来执行复制的脚本。
```
cd ~/Downloads
./OnboardingScript.sh
```
如果收到“权限被拒绝”错误，请确保脚本成为可执行文件：
```
chmod +x ~/Downloads/OnboardingScript.sh
./OnboardingScript.sh
```

如果完成安装后代理无法启动，请检查日志以获取详细的错误信息。日志目录为 /var/opt/azcmagent/log。

验证与 Azure Arc 的连接

安装代理并将其配置为连接到已启用 Azure Arc 的服务器后，请转到 Azure 门户以验证服务器是否已成功连接。

显示 Azure 门户中成功的计算机连接的屏幕截图。

后续步骤

有关故障排除信息，可参阅 Connected Machine 代理故障排除指南。
查看规划和部署指南，以便对按任意规模部署启用了 Azure Arc 的服务器进行规划，并实现集中管理和监视。
可以使用 Azure Policy 管理计算机，以执行诸如虚拟机 (VM) 来宾配置等任务。 Azure Policy 还有助于验证计算机是否向预期的 Log Analytics 工作区报告。还可以使用 VM 洞察和其他监视工具监视虚拟机。

反馈

此页面是否有帮助？

Last updated on 2026-01-29