使用 ADConnectivityTool PowerShell 模块排查Microsoft Entra 连接问题

ADConnectivity 工具是一个 PowerShell 模块,用于以下任一项:

  • 在安装期间,当网络连接问题阻止成功验证 Active Directory 凭据时。
  • 在 PowerShell 会话中调用函数的用户安装后。

该工具位于:C:\Program Files\Microsoft Entra Connect\Tools\ADConnectivityTool.psm1

安装过程中的 ADConnectivityTool

在 Microsoft Entra Connect 向导中的“连接目录”页上,如果发生网络问题,ADConnectivityTool 将自动使用其函数之一来确定发生的情况。 以下项可以被视为网络问题:

  • 用户提供的森林名称输入有误或该森林不存在。
  • 与用户提供的林相关联的域控制器中已关闭 UDP 端口 389
  • 在“AD 林帐户”窗口中提供的凭据无权检索与目标林关联的域控制器
  • 与用户提供的 Forest 关联的域控制器中的任一 TCP 端口 53、88 或 389 被关闭。
  • UDP 389 和 TCP 端口(或端口)均已关闭
  • 无法为提供的林和/或其关联的域控制器解析 DNS

只要找到这些问题,Microsoft Entra Connect 向导中会显示相关的错误消息:

错误

例如,当我们尝试在 连接目录 屏幕上添加目录时,Microsoft Entra Connect 需要验证这一点,并且希望能够通过端口 389 与域控制器通信。 如果无法,我们将看到屏幕截图中显示的错误。

幕后实际发生的情况是,Microsoft Entra Connect 调用 Start-NetworkConnectivityDiagnosisTools 函数。 当凭据验证由于网络连接问题而失败时,将调用此函数。

最后,每当从向导调用该工具时,都生成详细的日志文件。 该日志位于 C:\ProgramData\AADConnect\ADConnectivityTool-<date>-<time>.log

ADConnectivityTools 安装后

安装 Microsoft Entra Connect 后,可以使用 ADConnectivityTools PowerShell 模块中的任何函数。

可以在 ADConnectivityTools 参考文档 中找到函数相关的参考信息

Start-ConnectivityValidation

我们将调用此函数,因为将 ADConnectivityTool.psm1 导入到 PowerShell 之后,就只能手动调用该函数

此函数执行Microsoft Entra Connect 向导运行的相同逻辑来验证提供的 AD 凭据。 但是,它为问题提供了一个更冗长的解释,并提出了一个建议的解决方案。

连接验证由以下步骤组成:

  • 获取域 FQDN(完全限制的域名)对象
  • 验证用户是否选择了“创建新 AD 帐户”,这些凭据属于企业管理员组
  • 获取林 FQDN 对象
  • 确认至少有一个与先前获取的林 FQDN 对象关联的域是可访问的
  • 验证林函数级别是否是 Windows Server 2003 或更高版本。

如果用户成功执行了所有这些操作,则可以添加目录。

如果用户运行此函数,在问题解决后(或者根本不存在问题),输出将提示用户返回到 Microsoft Entra Connect 向导,然后再次尝试输入凭据。

后续步骤