大网数据广告活动
Azure 身份与安全

在 Azure Active Directory 中安装连接运行状况代理

· 52CE 我爱测

本 Azure AD Connect Health 文章介绍了 Active Directory 联合身份验证服务 (AD FS) 和同步的代理安装。

本文介绍如何安装和配置 Azure Active Directory (Azure AD) 连接运行状况代理。 若要下载代理,请参阅 这些说明。

要求

下表列出了使用 Azure AD Connect Health 的要求。

要求 说明
(P1 或 P2) 订阅有 Azure AD Premium。 Azure AD Connect Health 是 Azure AD Premium (P1 或 P2) 的一项功能。 有关详细信息,请参阅 注册 Azure AD Premium。 若要开始30天免费试用,请参阅 开始试用。
你是 Azure AD 中的全局管理员。 默认情况下,只有全局管理员才能安装和配置运行状况代理,访问门户,并在 Azure AD Connect Health 中执行任何操作。 有关详细信息,请参阅 Administering your Azure AD directory(管理 Azure AD 目录)。 通过使用 azure RBAC) (基于角色的访问控制,你可以允许组织中的其他用户访问 Azure AD Connect Health。 有关详细信息,请参阅 适用于 Azure AD Connect Health 的 AZURE RBAC。 重要提示:使用工作或学校帐户安装代理。 不能使用 Microsoft 帐户。 有关详细信息,请参阅以 组织身份注册 Azure。
每个目标服务器上都安装了 Azure AD Connect Health 代理。 必须在目标服务器上安装和配置运行状况代理,以便它们可以接收数据并提供监视和分析功能。 例如,若要从你的 Active Directory 联合身份验证服务 (AD FS) 基础结构获取数据,必须在 AD FS 服务器和 Web 应用程序代理服务器上安装代理。 同样,若要从本地 Azure AD 域服务 (Azure AD DS) 基础结构获取数据,必须在域控制器上安装代理。
Azure 服务终结点具有出站连接。 在安装期间和运行时,代理需要连接到 Azure AD Connect Health 服务终结点。 如果防火墙阻止出站连接,请将 出站连接终结点 添加到允许列表中。
出站连接基于 IP 地址。 有关基于 IP 地址的防火墙筛选的信息,请参阅 AZURE ip 范围。
对出站流量的 TLS 检查已筛选或禁用。 如果网络层上的出站流量存在 TLS 检查或终止,则代理注册步骤或数据上传操作可能会失败。 有关详细信息,请参阅 设置 TLS 检测。
服务器上的防火墙端口正在运行代理。 代理要求打开以下防火墙端口,以便它能够与 Azure AD Connect Health 服务终结点进行通信: <li>TCP 端口 443</li><li>TCP 端口 5671</li> 最新版本的代理不需要端口5671。 升级到最新版本,以便只需要端口443。 有关详细信息,请参阅 混合标识所需的端口和协议。
如果启用了 Internet Explorer 增强的安全性,则允许指定的网站。 如果启用了 Internet Explorer 增强的安全性,则在安装代理的服务器上允许以下网站:<li>https://login.microsoftonline.com</li><li>https://secure.aadcdn.microsoftonline-p.com</li><li>https://login.windows.net</li><li>https: / /aadcdn.msftauth.net</li><li>受 Azure AD 信任的组织的联合服务器 (例如,https: / /sts.contoso.com) </li> 有关详细信息,请参阅 如何配置 Internet Explorer。 如果网络中有一个代理,请参阅此表末尾显示的注释。
安装了 PowerShell 版本4.0 或更高版本。 Windows Server 2012 包括 PowerShell 版本3.0。 此版本对于 代理来说是不够的 。 Windows Server 2012 R2 及更高版本包括足够的最新版本的 PowerShell。
已禁用 FIPS (美国联邦信息处理标准) 。 Azure AD Connect Health 代理不支持 FIPS。

Important: Windows Server Core 不支持安装 Azure AD Connect Health 代理。

Note: 如果有高度锁定的环境,则需要添加比表为 Internet Explorer 增强的安全性而列出的 Url 更多的 Url。 还要添加下一部分的表中列出的 Url。

Azure 服务终结点的出站连接

在安装和运行时,代理需要连接到 Azure AD Connect Health 服务终结点。 如果防火墙阻止出站连接,请确保默认情况下,下表中的 Url 不会被阻止。

不要禁用对这些 Url 的安全监视或检查。 相反,允许它们允许其他 internet 流量。

这些 Url 允许与 Azure AD Connect Health 服务终结点进行通信。 在本文的后面部分中,你将了解如何使用 检查出站连接 Test-AzureADConnectHealthConnectivity 。

域环境 所需的 Azure 服务终结点
一般公共 <li>*.blob.core.windows.net </li><li>*.aadconnecthealth.azure.com </li><li>* servicebus.windows.net-端口: 5671 (此终结点在最新版本的代理中不是必需的。 ) </li><li>*.adhybridhealth.azure.com/</li><li>https://management.azure.com </li><li>https://policykeyservice.dc.ad.msft.net/</li><li>https://login.windows.net</li><li>https://login.microsoftonline.com</li><li>https://secure.aadcdn.microsoftonline-p.com </li><li>https: / /www.office.com (此终结点仅用于在注册过程中发现目的。 ) </li> <li>https://aadcdn.msftauth.net</li><li>https://aadcdn.msauth.net</li>
Azure 德国 <li>*.blob.core.cloudapi.de </li><li>*.servicebus.cloudapi.de </li> <li>*.aadconnecthealth.microsoftazure.de </li><li>https://management.microsoftazure.de </li><li>https://policykeyservice.aadcdi.microsoftazure.de </li><li>https://login.microsoftonline.de </li><li>https://secure.aadcdn.microsoftonline-p.de </li><li>https: / /www.office.de (此终结点仅用于在注册过程中发现目的。 ) </li> <li>https://aadcdn.msftauth.net</li><li>https://aadcdn.msauth.net</li>
Azure Government <li>*.blob.core.usgovcloudapi.net </li> <li>*.servicebus.usgovcloudapi.net </li> <li>*.aadconnecthealth.microsoftazure.us </li> <li>https://management.usgovcloudapi.net </li><li>https://policykeyservice.aadcdi.azure.us </li><li>https://login.microsoftonline.us </li><li>https://secure.aadcdn.microsoftonline-p.com </li><li>https: / /www.office.com (此终结点仅用于在注册过程中发现目的。 ) </li> <li>https://aadcdn.msftauth.net</li><li>https://aadcdn.msauth.net</li>

安装代理

下载并安装 Azure AD Connect Health 代理:

为 AD FS 安装代理

Note: 你的 AD FS 服务器应该不同于同步服务器。 请勿在同步服务器上安装 AD FS 代理。

在安装代理之前,请确保 AD FS server 主机名是唯一的且不在 AD FS 服务中。 若要启动代理安装,请双击下载的 .exe 文件。 在第一个窗口中,选择 " 安装"。

显示 Azure AD Connect Health AD FS 代理的安装窗口的屏幕截图。

安装完成后,选择 " 立即配置"。

显示 Azure AD Connect Health AD FS 代理安装的确认消息的屏幕截图。

此时将打开 PowerShell 窗口以启动代理注册过程。 出现提示时,请使用有权注册代理的 Azure AD 帐户登录。 默认情况下,全局管理员帐户具有权限。

显示 Azure AD Connect Health AD FS 的登录窗口的屏幕截图。

登录后,PowerShell 将继续。 完成后,可以关闭 PowerShell。 配置已完成。

此时,代理服务应自动启动,以允许代理安全地将所需的数据上传到云服务。

如果尚未满足所有先决条件,PowerShell 窗口中会出现警告。 在安装代理之前,请务必完成这些 要求 。 以下屏幕截图显示了这些警告的示例。

显示 Azure AD Connect Health AD FS 配置脚本的屏幕截图。

若要验证代理是否已安装,请在服务器上查找以下服务。 如果已完成配置,这些服务应已运行。 否则,它们会被停止,直到配置完成。

  • Azure AD Connect Health AD FS Diagnostics 服务
  • Azure AD Connect Health AD FS Insights 服务
  • Azure AD Connect Health AD FS Monitoring 服务

显示 Azure AD Connect Health AD FS 服务的屏幕截图。

为 AD FS 启用审核

Note: 本部分仅适用于 AD FS 服务器。 无需在 Web 应用程序代理服务器上执行这些步骤。

使用情况分析功能需要收集和分析数据。 因此,Azure AD Connect Health 代理需要 AD FS 审核日志中的信息。 默认情况下未启用这些日志。 使用以下过程来启用 AD FS 审核并在 AD FS 服务器上查找 AD FS 审核日志。

在 Windows Server 2012 R2 上启用 AD FS 审核的步骤
  1. 在 "开始" 屏幕上,打开 服务器管理器,然后打开 " 本地安全策略"。 或在任务栏上,打开 服务器管理器,然后选择 " 工具/本地安全策略"。

  2. 请参阅 安全 \ 本地策略 \ 安全策略分配 文件夹。 然后双击 " 生成安全审核"。

  3. 在 “本地安全设置” 选项卡上,验证是否列出了 AD FS 服务帐户。 如果未列出,请选择 " 添加用户或组",并将其添加到列表。 然后选择“确定”。

  4. 若要启用审核,请使用提升的权限打开命令提示符窗口。 然后,运行以下命令:

    auditpol.exe /set /subcategory:{0CCE9222-69AE-11D9-BED3-505054503030} /failure:enable /success:enable

  5. 关闭“本地安全策略”。

    IMPORTANT 以下步骤仅适用于主 AD FS 服务器。

  6. 打开“AD FS 管理”管理单元。 (在 服务器管理器 中,选择 "工具" > AD FS 管理"。 )

  7. 在 " 操作 " 窗格中,选择 " 编辑联合身份验证服务属性"。

  8. 在 " 联合身份验证服务属性 " 对话框中,选择 " 事件 " 选项卡。

  9. 选中 " 成功审核" 和 "失败审核 " 复选框,然后选择 "确定"。

  10. 若要通过 PowerShell 启用详细日志记录,请使用以下命令:

    Set-AdfsProperties -LOGLevel Verbose

在 Windows Server 2016 上针对 AD FS 启用审核
  1. 在 "开始" 屏幕上,打开 服务器管理器,然后打开 " 本地安全策略"。 或在任务栏上,打开 服务器管理器,然后选择 " 工具/本地安全策略"。

  2. 中转到 " 安全 \ 本地策略 \ 安全策略分配 " 文件夹,然后双击 " 生成安全审核"。

  3. 在 “本地安全设置” 选项卡上,验证是否列出了 AD FS 服务帐户。 如果未列出,请选择 " 添加用户或组",并将 AD FS 服务帐户添加到列表。 然后选择“确定”。

  4. 若要启用审核,请使用提升的权限打开命令提示符窗口。 然后,运行以下命令:

    auditpol.exe /set /subcategory:{0CCE9222-69AE-11D9-BED3-505054503030} /failure:enable /success:enable

  5. 关闭“本地安全策略”。

    IMPORTANT 以下步骤仅适用于主 AD FS 服务器。

  6. 打开“AD FS 管理”管理单元。 (在 服务器管理器 中,选择 "工具" > AD FS 管理"。 )

  7. 在 " 操作 " 窗格中,选择 " 编辑联合身份验证服务属性"。

  8. 在 " 联合身份验证服务属性 " 对话框中,选择 " 事件 " 选项卡。

  9. 选中 " 成功审核" 和 "失败审核 " 复选框,然后选择 "确定"。 默认情况下,成功审核和失败审核均为启用状态。

  10. 打开 PowerShell 窗口并运行以下命令:

    Set-AdfsProperties -AuditLevel Verbose

默认情况下,已启用 "基本" 审核级别。 有关详细信息,请参阅 Windows Server 2016 中的 AD FS 审核增强功能。

查找 AD FS 审核日志的步骤
  1. 打开“事件查看器”。

  2. 中转到 " Windows 日志",然后选择 " 安全性"。

  3. 在右侧选择 " 筛选当前日志"。

  4. 对于 事件源,请选择 " AD FS 审核"。

    有关审核日志的详细信息,请参阅 操作问题。

    显示 "筛选当前日志" 窗口的屏幕截图。 在 "事件来源" 字段中,"AD FS 审核" 处于选中状态。

Warning: 组策略可以禁用 AD FS 审核。 如果 AD FS 审核处于禁用状态,则无法使用有关登录活动的使用情况分析。 确保没有禁用 AD FS 审核的组策略。

安装代理进行同步

在最新版本的 Azure AD Connect 中会自动安装用于同步的 Azure AD Connect Health 代理。 若要使用 Azure AD Connect 进行同步,请 下载最新版本的 Azure AD Connect 并安装它。

若要验证代理是否已安装,请在服务器上查看以下服务。 如果已完成配置,则服务应已在运行。 否则,服务会停止,直到配置完成。

  • Azure AD Connect Health Sync Insights 服务
  • Azure AD Connect Health Sync 监视服务

显示服务器上的同步服务的正在运行的 Azure AD Connect Health 屏幕截图。

Note: 请记住,必须 (P1 或 P2) Azure AD Premium 才能使用 Azure AD Connect Health。 如果没有 Azure AD Premium,则无法在 Azure 门户中完成配置。 有关详细信息,请参阅 要求。

手动注册用于同步的 Azure AD Connect Health

如果成功安装 Azure AD Connect 后,同步代理注册 Azure AD Connect Health 失败,则可以使用 PowerShell 命令手动注册代理。

Important: 仅当在安装 Azure AD Connect 后代理注册失败时,才使用此 PowerShell 命令。

使用以下 PowerShell 命令为同步手动注册 Azure AD Connect Health 代理。 成功注册代理之后,Azure AD Connect Health 服务会启动。

Register-AzureADConnectHealthSyncAgent -AttributeFiltering $false -StagingMode $false

此命令采用以下参数:

  • AttributeFiltering: $true 如果 Azure AD Connect 未同步默认属性集,且已自定义为使用筛选的属性集,则 (默认) 。 否则使用 $false。
  • StagingMode: $false 如果 Azure AD Connect 服务器 未 处于暂存模式,则 (默认) 。 如果将服务器配置为处于暂存模式,请使用 $true 。

当系统提示你进行身份验证时,请使用相同的全局管理员帐户 (如 admin@domain.onmicrosoft.com 用于配置 Azure AD Connect 的) 。

为 Azure AD DS 安装代理

若要启动代理安装,请双击下载的 .exe 文件。 在第一个窗口中,选择 " 安装"。

显示 AD DS 安装窗口的 Azure AD Connect Health 代理的屏幕截图。

安装完成后,请选择 " 立即配置"。

显示为 Azure AD DS 完成 Azure AD Connect Health 代理安装的窗口的屏幕截图。

此时将打开一个命令提示符窗口。 PowerShell 将运行 Register-AzureADConnectHealthADDSAgent 。 出现提示时,请登录到 Azure。

显示 Azure AD DS 的 Azure AD Connect Health 代理的登录窗口的屏幕截图。

登录后,PowerShell 将继续。 完成后,可以关闭 PowerShell。 配置已完成。

此时,应自动启动服务,允许代理监视和收集数据。 如果你尚未满足前面几节中所述的所有先决条件,则 PowerShell 窗口中会出现警告。 在安装代理之前,请务必完成这些 要求 。 以下屏幕截图显示了这些警告的示例。

显示 Azure AD DS 配置的 Azure AD Connect Health 代理的警告的屏幕截图。

若要验证代理是否已安装,请在域控制器上查找以下服务:

  • Azure AD Connect Health AD DS Insights 服务
  • Azure AD Connect Health AD DS 监视服务

如果已完成配置,这些服务应已运行。 否则,它们会被停止,直到配置完成。

显示域控制器上正在运行的服务的屏幕截图。

在多个服务器上快速安装代理

  1. 在 Azure AD 中创建用户帐户。 使用密码对其进行保护。

  2. 使用门户在 Azure AD Connect Health 中为此本地 Azure AD 帐户分配 所有者 角色。 请执行这些步骤。 将角色分配给所有服务实例。

  3. 下载本地域控制器中用于安装的 .Exe MSI 文件。

  4. 运行以下脚本。 将参数替换为新的用户帐户及其密码。

    AdHealthAddsAgentSetup.exe /quiet
    Start-Sleep 30
    $userName = "NEWUSER@DOMAIN"
    $secpasswd = ConvertTo-SecureString "PASSWORD" -AsPlainText -Force
    $myCreds = New-Object System.Management.Automation.PSCredential ($userName, $secpasswd)
    import-module "C:\Program Files\Azure Ad Connect Health Adds Agent\PowerShell\AdHealthAdds"
     
    Register-AzureADConnectHealthADDSAgent -Credential $myCreds
    
    

完成后,可以通过执行以下一项或多项任务来删除本地帐户的访问权限:

  • 删除 Azure AD Connect Health 的本地帐户的角色分配。
  • 旋转本地帐户的密码。
  • 禁用 Azure AD 本地帐户。
  • 删除 Azure AD 本地帐户。

使用 PowerShell 注册代理

安装适当的代理 setup.exe 文件后,可以使用以下 PowerShell 命令来注册代理,具体取决于角色。 打开 PowerShell 窗口并运行相应的命令:

    Register-AzureADConnectHealthADFSAgent
    Register-AzureADConnectHealthADDSAgent
    Register-AzureADConnectHealthSyncAgent

Note: 若要针对主权云进行注册,请使用以下命令行:

Register-AzureADConnectHealthADFSAgent -UserPrincipalName upn-of-the-user
Register-AzureADConnectHealthADDSAgent -UserPrincipalName upn-of-the-user
Register-AzureADConnectHealthSyncAgent -UserPrincipalName upn-of-the-user

这些命令接受 Credential 作为参数来完成注册 noninteractively,或在运行 Server Core 的计算机上完成注册。 请记住:

  • 可以 Credential 在作为参数传递的 PowerShell 变量中捕获。
  • 你可以提供有权注册代理但 未 启用多重身份验证的任何 Azure AD 标识。
  • 默认情况下,全局管理员具有注册代理的权限。 还可以允许不太特权的标识执行此步骤。 有关详细信息,请参阅 AZURE RBAC。
    $cred = Get-Credential
    Register-AzureADConnectHealthADFSAgent -Credential $cred

将 Azure AD Connect Health 代理配置为使用 HTTP 代理

你可以配置 Azure AD Connect Health 代理来使用 HTTP 代理。

Note:

  • 不支持 Netsh WinHttp set ProxyServerAddress。 代理使用 System.Net 而不是 Windows HTTP 服务发出 web 请求。
  • 配置的 HTTP 代理地址用于传递加密的 HTTPS 消息。
  • 不支持经过身份验证的代理(使用 HTTPBasic)。

更改代理的代理配置

若要将 Azure AD Connect Health 代理配置为使用 HTTP 代理,你可以:

  • 导入现有的代理设置。
  • 手动指定代理地址。
  • 清除现有的代理配置。

Note: 若要更新代理设置,必须重新启动所有 Azure AD Connect Health 代理服务。 运行以下命令:

Restart-Service AzureADConnectHealth*

导入现有的代理设置

你可以导入 Internet Explorer HTTP 代理设置,以便 Azure AD Connect Health 代理可以使用这些设置。 在运行 health 代理的每台服务器上,运行以下 PowerShell 命令:

Set-AzureAdConnectHealthProxySettings -ImportFromInternetSettings

你可以导入 WinHTTP 代理设置,以便 Azure AD Connect Health 代理可以使用它们。 在运行 health 代理的每台服务器上,运行以下 PowerShell 命令:

Set-AzureAdConnectHealthProxySettings -ImportFromWinHttp
手动指定代理地址

您可以手动指定代理服务器。 在运行 health 代理的每台服务器上,运行以下 PowerShell 命令:

Set-AzureAdConnectHealthProxySettings -HttpsProxyAddress address:port

下面是一个示例:

Set-AzureAdConnectHealthProxySettings -HttpsProxyAddress myproxyserver: 443

在本示例中:

  • 此 address 设置可以是 DNS 可解析的服务器名称或 IPv4 地址。
  • 您可以省略 port 。 否则,443为默认端口。
清除现有的代理配置

可以运行以下命令清除现有的代理配置:

Set-AzureAdConnectHealthProxySettings -NoProxy

读取当前的代理设置

可以通过运行以下命令来读取当前的代理设置:

Get-AzureAdConnectHealthProxySettings

测试与 Azure AD Connect Health 服务的连接

有时,Azure AD Connect Health 代理可能会失去与 Azure AD Connect Health 服务的连接。 此连接丢失的原因可能包括网络问题、权限问题以及各种其他问题。

如果代理无法将数据发送到 Azure AD Connect Health 服务超过两个小时,门户中会出现以下警报: "运行状况服务数据不是最新的"。

可以通过运行以下 PowerShell 命令来确定受影响的 Azure AD Connect Health 代理是否可以将数据上传到 Azure AD Connect Health 服务:

Test-AzureADConnectHealthConnectivity -Role ADFS

role 参数目前可接受以下值:

  • ADFS
  • 同步
  • ADDS

Note: 若要使用连接工具,必须先注册代理。 如果无法完成代理注册,请确保满足 Azure AD Connect Health 的所有 要求 。 默认情况下,在代理注册过程中测试连接。

后续步骤

请查看以下相关文章:

历史资料。此文对应 2022-08-12 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 billmath)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。

资料来源与适用范围

资料来源
Microsoft / Azure 中文运维文档历史快照
适用范围
历史中文快照 2022-08-12;详见原文产品版本;文档日期 10/20/2020
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。