大网数据广告活动
域与目录服务

AD FS 帮助诊断分析器

· 52CE 我爱测

本文档介绍 AD FS 帮助诊断分析器,以及如何使用 AD FS 诊断 PowerShell 模块执行基本检查。

AD FS 提供了许多设置,这些设置支持它提供的用于身份验证和应用程序开发的各种功能。 在故障排除过程中,建议确保正确配置所有 AD FS 设置。 手动检查这些设置有时会耗费时间。 AD FS 帮助诊断分析器可帮助使用 ADFSToolbox PowerShell 模块执行基本检查。 执行检查后,AD FS 帮助将提供诊断分析器来帮助你轻松地可视化结果并提供补救步骤。

完整操作采用3个简单步骤:

  1. 在主 AD FS 服务器或 WAP 服务器上设置 ADFSToolbox 模块
  2. 执行诊断,并将文件上传到 AD FS 帮助
  3. 查看诊断分析并解决任何问题

请参阅AD FS 帮助诊断分析器 (https://aka.ms/adfsdiagnosticsanalyzer) ,开始进行故障排除。

AD FS 诊断分析器工具 AD FS 帮助

步骤1:在 AD FS server 上设置 ADFSToolbox 模块

若要运行诊断分析器,必须安装 ADFSToolbox PowerShell 模块。 如果 AD FS 服务器已连接到 internet,则可以直接从 PowerShell 库安装 ADFSToolbox 模块。 如果未连接到 internet,则可以手动安装它。

WARNING 如果使用 AD FS 2.1 或更低版本,则必须安装 ADFSToolbox 版本1.0.13。 ADFSToolbox 不再支持最新版本的 AD FS 2.1 或更低版本。

AD FS 诊断分析器-安装程序

使用 PowerShell 库进行安装

如果 AD FS 服务器具有 internet 连接,建议使用下面提供的 PowerShell 命令直接从 PowerShell 库安装 ADFSToolbox 模块。

 Install-Module -Name ADFSToolbox -force
 Import-Module ADFSToolbox -force

手动设置

必须将 ADFSToolbox 模块手动复制到 AD FS 或 WAP 服务器。 请根据以下说明操作。

  1. 在可访问 internet 的计算机上启动提升的 PowerShell 窗口。

  2. 安装 AD FS 工具箱 "模块。

    Install-Module -Name ADFSToolbox -Force
    
  3. 将位于本地计算机上的 ADFSToolbox 文件夹复制 %SYSTEMDRIVE%\Program Files\WindowsPowerShell\Modules\ 到 AD FS 或 WAP 计算机上的同一位置。

  4. 在 AD FS 机上启动提升的 PowerShell 窗口,并运行以下 cmdlet 以导入模块。

    Import-Module ADFSToolbox -Force
    

步骤2:执行诊断 cmdlet

AD FS 诊断分析器工具-执行并上传结果

可以使用单个命令在场中的所有 AD FS 服务器上方便地执行诊断测试。 PowerShell 模块将使用远程 PS 会话在场中的不同服务器之间执行诊断测试。

    Export-AdfsDiagnosticsFile [-ServerNames <list of servers>]

在服务器2016或更高版本 AD FS 场中,该命令将从 AD FS 配置中读取 AD FS 服务器的列表。 然后,将针对列表中的每个服务器尝试诊断测试。 如果 AD FS 服务器的列表不可用 (示例 2012R2) ,则针对本地计算机运行测试。 若要指定要对其执行测试的服务器的列表,请使用ServerNames参数提供服务器的列表。 下面提供了一个示例

    Export-AdfsDiagnosticsFile -ServerNames @("adfs1.contoso.com", "adfs2.contoso.com")

结果是在运行命令的同一目录中创建的 JSON 文件。 文件的名称为 AdfsDiagnosticsFile- <timestamp> 。 示例文件名 AdfsDiagnosticsFile-07312019-184201.js。

步骤3:上传诊断文件

在第3步中 https://aka.ms/adfsdiagnosticsanalyzer ,使用文件浏览器选择要上传的结果文件。

单击 "上传" 完成上传。

通过使用 Microsoft 帐户登录,可以保存诊断结果以供以后查看,并且可以发送给 Microsoft 支持部门。 如果你随时打开支持案例,Microsoft 将能够查看诊断分析器结果,并帮助你更快地解决问题。

AD FS 诊断分析器工具-登录

步骤4:查看诊断分析并解决任何问题

测试结果有五个部分:

  1. Failed:此部分包含失败的测试的列表。 每个结果包含:
  2. 警告:此部分包含导致警告的测试的列表。 这些问题不会导致在更广泛的范围内进行身份验证的任何问题,但应最早地解决这些问题。
  3. 通过:此部分包含通过的测试列表,并且没有用户的操作项。
  4. 不运行:此部分包含由于缺少信息而无法运行的测试的列表。
  5. 不适用:此部分包含未执行的测试列表,因为这些测试不适用于执行命令的特定服务器。

AD FS 诊断分析器工具-"测试结果" 列表 中显示每个测试结果,并详细说明了这些步骤:

  1. 测试名称:已执行的测试的名称
  2. 说明:对测试的说明。
  3. 详细信息:在测试过程中执行的总体操作的说明
  4. 解决步骤:解决测试中突出显示的问题的建议步骤

AD FS 诊断分析器工具-故障解决方法

下一步

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

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

资料来源与适用范围

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

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

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