Compartilhar via

Relatório de validação do Azure Stack Hub

  • Artigo

Use a ferramenta verificador de preparação do Azure Stack Hub para executar validações que dão suporte à implantação e manutenção de um ambiente do Azure Stack Hub. A ferramenta grava resultados em um arquivo de relatório .json. O relatório exibe dados detalhados e resumidos sobre o estado dos pré-requisitos para implantação do Azure Stack Hub. O relatório também exibe informações sobre a rotação de segredos para implantações existentes do Azure Stack Hub.

Onde localizar o relatório

Quando a ferramenta é executada, ela registra os resultados em AzsReadinessCheckerReport.json. A ferramenta também cria um log chamado AzsReadinessChecker.log. O local desses arquivos é exibido junto com os resultados da validação no PowerShell:

resultados de validação de execução para o Verificador de Preparação do Azure Stack Hub

Ambos os arquivos persistem os resultados de verificações de validação subsequentes quando executados no mesmo computador. Por exemplo, a ferramenta pode ser executada para validar certificados, executar novamente para validar a identidade do Azure e, em seguida, uma terceira vez para validar o registro. Os resultados de todas as três validações estão disponíveis no relatório .json resultante.

Por padrão, ambos os arquivos são gravados em C:\Users\username\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessCheckerReport.json.

  • Use o -OutputPath <path> parâmetro no final da linha de comando para especificar um local de relatório diferente.
  • Use o -CleanReport parâmetro no final da linha de comando para limpar informações sobre execuções anteriores da ferramenta de AzsReadinessCheckerReport.json.

Exibir o relatório

Para exibir o relatório no PowerShell, forneça o caminho para o relatório como um valor para -ReportPath. Esse comando exibe o conteúdo do relatório e identifica validações que ainda não têm resultados.

Por exemplo, para exibir o relatório de um prompt do PowerShell aberto no local onde o relatório está localizado, execute o seguinte comando:

Read-AzsReadinessReport -ReportPath .\AzsReadinessReport.json

A saída deverá ser semelhante ao seguinte exemplo:

Reading All Validation(s) from Report C:\Contoso-AzsReadinessCheckerReport.json

############### Certificate Validation Summary ###############

Certificate Validation results not available.

############### Registration Validation Summary ###############

Azure Registration Validation results not available.

############### Azure Identity Results ###############

Test                          : ServiceAdministrator
Result                        : OK
AAD Service Admin             : admin@contoso.onmicrosoft.com
Azure Environment             : AzureCloud
Azure Active Directory Tenant : contoso.onmicrosoft.com
Error Details                 : 

############### Azure Identity Validation Summary ###############

Azure Identity Validation found no errors or warnings.

############### Azure Stack Hub Graph Validation Summary ###############

Azure Stack Hub Graph Validation results not available.

############### Azure Stack Hub ADFS Validation Summary ###############

Azure Stack Hub ADFS Validation results not available.

############### AzsReadiness Job Summary ###############

Index             : 0
Operations        : 
StartTime         : 2018/10/22 14:24:16
EndTime           : 2018/10/22 14:24:19
Duration          : 3
PSBoundParameters :

Exibir o resumo do relatório

Para exibir um resumo do relatório, você pode adicionar o -summary parâmetro ao final do comando do PowerShell. Por exemplo:

Read-AzsReadinessReport -ReportPath .\Contoso-AzsReadinessReport.json -summary

O resumo mostra validações que não têm resultados e indica aprovação ou falha para validações concluídas. A saída deverá ser semelhante ao seguinte exemplo:

Reading All Validation(s) from Report C:\Contoso-AzsReadinessCheckerReport.json

############### Certificate Validation Summary ###############

Certificate Validation found no errors or warnings.

############### Registration Validation Summary ###############

Registration Validation found no errors or warnings.

############### Azure Identity Validation Summary ###############

Azure Identity Validation found no errors or warnings.

############### Azure Stack Hub Graph Validation Summary ###############

Azure Stack Hub Graph Validation results not available.

############### Azure Stack Hub ADFS Validation Summary ###############

Azure Stack Hub ADFS Validation results not available.

Exibir um relatório filtrado

Para exibir um relatório filtrado em um único tipo de validação, use o -ReportSections parâmetro com um dos seguintes valores:

  • Certificado
  • AzureRegistration
  • AzureIdentity
  • Grafo
  • ADFS
  • Trabalhos
  • Tudo

Por exemplo, para exibir o resumo do relatório somente para certificados, use a seguinte linha de comando do PowerShell:

Read-AzsReadinessReport -ReportPath .\Contoso-AzsReadinessReport.json -ReportSections Certificate - Summary