Share via

Analisador de diagnóstico do AD FS ajuda

  • Artigo

O AD FS inclui várias configurações que dão suporte à ampla variedade de funcionalidades que ele fornece para autenticação e desenvolvimento de aplicativos. Durante a solução de problemas, é recomendável garantir que todas as configurações do AD FS estejam definidas corretamente. Às vezes, fazer uma verificação manual dessas configurações pode ser demorado. O Analisador de Diagnóstico de Ajuda do AD FS pode ajudar a executar as verificações básicas usando o módulo ADFSToolbox do PowerShell. Depois de executar as verificações, a Ajuda do AD FS fornece o Analisador de Diagnóstico para ajudar você a visualizar com facilidade os resultados e oferecer etapas de correção.

A operação de diagnóstico pode ser dividida em três etapas simples:

  • Etapa 1 – Configurar o módulo ADFSToolbox no servidor primário AD FS ou servidor WAP
  • Etapa 2 – Executar o diagnóstico e carregar o arquivo na Ajuda do AD FS
  • Etapa 3 – Exibir a análise de diagnóstico e resolver os problemas

Acesse Analisador de Diagnóstico de Ajuda do AD FS (https://aka.ms/adfsdiagnosticsanalyzer) para iniciar a solução de problemas.

AD FS diagnostics analyzer tool on AD FS Help

Etapa 1: Configurar o módulo ADFSToolbox no servidor do AD FS

Para executar o Analisador de Diagnóstico, é preciso instalar o módulo ADFSToolbox do PowerShell. Se o servidor do AD FS tiver conectividade com a Internet, você poderá instalar o módulo ADFSToolbox diretamente da galeria do PowerShell. Se não houver conectividade com a Internet, você poderá instalá-lo manualmente.

[!WARNING] Se você estiver usando o AD FS 2.1 ou inferior, deverá instalar a versão 1.0.13 do ADFSToolbox. O ADFSToolbox deixou de dar suporte ao AD FS 2.1 ou inferior nas últimas versões.

AD FS diagnostics analyzer - setup

Se o servidor AD FS tiver conectividade com a Internet, é recomendável instalar o módulo ADFSToolbox diretamente da galeria do PowerShell usando os seguintes comandos do PowerShell.

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

Configuração manual

O módulo ADFSToolbox precisa ser copiado manualmente para os servidores do AD FS ou do WAP. O procedimento a seguir copia o ADFSToolbox para o local desejado.

  1. Inicie uma janela do PowerShell com privilégios elevados em um computador que tenha acesso à Internet.

  2. Instale o módulo AD FS Toolbox.

    Install-Module -Name ADFSToolbox -Force

  3. Copie a pasta ADFSToolbox localizada em %SYSTEMDRIVE%\Program Files\WindowsPowerShell\Modules\ no computador local para o mesmo local no computador do AD FS ou do WAP.

  4. Inicie uma janela do PowerShell com privilégios elevados no computador do AD FS e execute o cmdlet a seguir para importar o módulo.

    Import-Module ADFSToolbox -Force

Etapa 2: Executar o cmdlet de diagnóstico

AD FS diagnostics analyzer tool - execute and upload results

Um comando individual pode ser usado para executar de modo conveniente os testes de diagnóstico em todos os servidores do AD FS no farm. O módulo PowerShell usa sessões remotas do PowerShell para executar os testes de diagnóstico em diferentes servidores no farm.

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

Em um farm do AD FS do Windows Server 2016 ou posterior, o comando lê a lista de servidores AD FS da configuração do AD FS. Em seguida, será feita a tentativa de executar os testes de diagnóstico em cada servidor da lista. Se a lista de servidores AD FS não estiver disponível (exemplo 2012R2), os testes serão executados na máquina local. Para especificar uma lista de servidores nos quais os testes devem ser executados, use o argumento ServerNames para fornecer uma lista de servidores. O exemplo a seguir é fornecido.

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

O resultado é um arquivo JSON criado no mesmo diretório no qual o comando foi executado. O nome do arquivo é AdfsDiagnosticsFile-<timestamp>. Um exemplo de nome de arquivo é AdfsDiagnosticsFile-07312019-184201.json.

Etapa 3: Carregar o arquivo de diagnóstico

Após a etapa 3 do artigo https://aka.ms/adfsdiagnosticsanalyzer, use o navegador de arquivos para selecionar o arquivo de resultado a ser carregado.

SelecioneCarregar para concluir o upload.

Quando você entra com uma conta da Microsoft, seus resultados de diagnóstico podem ser salvos para exibição posterior e podem ser enviados para o suporte da Microsoft. Se, a qualquer momento você abrir um caso de suporte, a Microsoft poderá visualizar os resultados do Analisador de diagnóstico e ajudar a solucionar seu problema mais rapidamente.

AD FS diagnostics analyzer tool - sign in

Etapa 4: Exibir a análise de diagnóstico e resolver os problemas

Há cinco seções dos resultados do teste:

  • Com falha: essa seção contém a lista de testes com falha.
  • Aviso: esta seção contém uma lista de testes que resultaram em um aviso. Esses problemas não resultam em problemas relacionados à autenticação em uma escala mais ampla, mas devem ser resolvidos o mais cedo possível.
  • Aprovados: esta seção contém a lista de testes que foram aprovados e não requerem nenhuma outra ação.
  • Não executados: esta seção contém a lista de testes que não puderam ser executados devido à falta de informações.
  • Não aplicável: esta seção contém a lista de testes que não foram executados porque não eram aplicáveis para o servidor específico no qual o comando estava sendo executado.

AD FS diagnostics analyzer tool - test results list

Cada resultado de teste é exibido com detalhes que descrevem o teste e as etapas de resolução. Os detalhes incluem:

  • Nome do teste: nome do teste executado
  • Descrição: uma descrição do teste
  • Detalhes: descrição da operação geral executada durante o teste
  • Etapas de resolução: as etapas sugeridas para resolver o problema destacado pelo teste

AD FS diagnostics analyzer tool - failure resolution