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

AD FS Help Diagnostics Analyzer

· 52CE 我爱测

This article describes AD FS Help Diagnostics Analyzer and how it can perform the basic checks using AD FS diagnostics PowerShell module.

Important: The AD FS Help site has been retired. The Diagnostic Analyzer is now located in github and is part of the AD FS Offline tools.

AD FS includes numerous settings that support the wide variety of functionality it provides for authentication and application development. During troubleshooting, it's recommended to ensure that all of the AD FS settings are correctly configured. Doing a manual check of these settings can sometimes be time consuming.
The diagnostics operation can be divided into three simple steps:

  • Step 1 - Set up the ADFSToolbox module on the primary AD FS server or WAP server
  • Step 2 - Execute the diagnostics and upload the file to AD FS Help
  • Step 3 - View diagnostics analysis and resolve any issues

Go to the Diagnostic Analyzer under AD FS Offline tools to start troubleshooting.

Step 1: Set up the ADFSToolbox module on AD FS server

To run the Diagnostics Analyzer, you must install the ADFSToolbox PowerShell module. If the AD FS server has connectivity to the internet, you can install the ADFSToolbox module directly from the PowerShell gallery. If there's no connectivity to the internet, you can manually install it.

[!WARNING] If you're using AD FS 2.1 or lower, you must install version 1.0.13 of ADFSToolbox. ADFSToolbox no longer supports AD FS 2.1 or lower on the latest versions.

AD FS diagnostics analyzer - setup

Setup using PowerShell gallery

If the AD FS server has internet connectivity, it's recommended to install the ADFSToolbox module directly from the PowerShell gallery using the following PowerShell commands.

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

Setup manually

The ADFSToolbox module must be manually copied over to the AD FS or WAP servers. The following procedure copies the ADFSToolbox to the desired location.

  1. Launch an elevated PowerShell window on a machine that has internet access.

  2. Install the AD FS Toolbox module.

    Install-Module -Name ADFSToolbox -Force
    
  3. Copy the ADFSToolbox folder located %SYSTEMDRIVE%\Program Files\WindowsPowerShell\Modules\ on your local machine to the same location on your AD FS or WAP machine.

  4. Launch an elevated PowerShell window on your AD FS machine and run the following cmdlet to import the module.

    Import-Module ADFSToolbox -Force
    

Step 2: Execute the diagnostics cmdlet

AD FS diagnostics analyzer tool - execute and upload results

A single command can be used to conveniently execute the diagnostics tests across all the AD FS servers in the farm. The PowerShell module uses remote PowerShell sessions to execute the diagnostics tests across different servers in the farm.

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

In a Windows Server 2016 or later AD FS farm, the command reads the list of AD FS servers from AD FS configuration. The diagnostics tests are then attempted against each server in the list. If the list of AD FS servers isn't available (example 2012R2), then the tests are run against the local machine. To specify a list of servers against which the tests are to be executed, use the ServerNames argument to provide a list of servers. The following example is provided.

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

The result is a JSON file that is created in the same directory where the command was run. The name of the file is AdfsDiagnosticsFile-<timestamp>. An example file name is AdfsDiagnosticsFile-07312019-184201.json.

Step 3: Upload the diagnostics file

Following step 3 in the article, use the file browser to select the result file to upload.

Select Upload to finish the upload.

When you sign in with a Microsoft account, your diagnostics results can be saved for a later viewing point and can be sent to Microsoft support. If at any point you open a support case, Microsoft is able to view the Diagnostic Analyzer results and help troubleshoot your issue faster.

AD FS diagnostics analyzer tool - sign in

Step 4: View diagnostics analysis and resolve any issues

There are five sections of the test results:

  • Failed: This section contains list of tests that failed.
  • Warning: This section contains a list of tests that resulted in a warning. These issues don't result in any issues around authentication on a broader scale but should be addressed as early as possible.
  • Passed: This section contains the list of tests that passed and require no other action.
  • Not run: This section contains the list of tests that couldn't be run due to missing information.
  • Not applicable: This section contains the list of tests that weren't executed because they weren't applicable for the particular server on which the command was executing.

AD FS diagnostics analyzer tool - test results list

Each test result is displayed with details that describe the test and the resolution steps. Details include:

  • Test name: Name of the test that was executed
  • Description: A description of the test
  • Details: Description of the overall operation performed during the test
  • Resolution steps: The suggested steps to resolve the issue highlighted by the test

AD FS diagnostics analyzer tool - failure resolution

Related links

Source: Microsoft Learn / Windows Server documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.

资料来源与适用范围

资料来源
Microsoft Learn / Windows Server documentation
适用范围
Windows Server · Source date 04/08/2025
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0 (documentation), MIT (code samples)

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

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