Partilhar via

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

  • Artigo

Utilize a ferramenta Verificador de Preparação do Azure Stack Hub para executar validações que suportem a implementação e manutenção de um ambiente do Azure Stack Hub. A ferramenta escreve resultados num ficheiro de relatório .json. O relatório apresenta dados detalhados e resumidos sobre o estado dos pré-requisitos para a implementação do Azure Stack Hub. O relatório também apresenta informações sobre a rotação de segredos para implementações existentes do Azure Stack Hub.

Onde encontrar o relatório

Quando a ferramenta é executada, regista os resultados em AzsReadinessCheckerReport.json. A ferramenta também cria um registo com o nome AzsReadinessChecker.log. A localização destes ficheiros é apresentada juntamente com os resultados de validação no PowerShell:

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

Ambos os ficheiros mantêm os resultados das 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 registo. Os resultados das três validações estão disponíveis no relatório .json resultante.

Por predefinição, ambos os ficheiros são escritos em C:\Users\username\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessCheckerReport.json.

  • Utilize o -OutputPath <path> parâmetro no final da linha de comandos para especificar uma localização de relatório diferente.
  • Utilize o -CleanReport parâmetro no final da linha de comandos para limpar informações sobre execuções anteriores da ferramenta a partir de AzsReadinessCheckerReport.json.

Veja o relatório

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

Por exemplo, para ver o relatório a partir de uma linha de comandos do PowerShell aberta para a localização onde o relatório está localizado, execute o seguinte comando:

Read-AzsReadinessReport -ReportPath .\AzsReadinessReport.json

O resultado é 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 :

Ver o resumo do relatório

Para ver um resumo do relatório, 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 pass ou fail para validações que estão concluídas. O resultado é 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.

Ver um relatório filtrado

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

  • Certificado
  • AzureRegistration
  • AzureIdentity
  • Graph
  • ADFS
  • Tarefas
  • Todos

Por exemplo, para ver o resumo do relatório apenas para certificados, utilize a seguinte linha de comandos do PowerShell:

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