Azure Stack 验证报表Azure Stack validation report

使用 Azure Stack 就绪性检查器工具运行验证来为 Azure Stack 环境的部署和维护提供支持。Use the Azure Stack Readiness Checker tool to run validations that support deployment and servicing of an Azure Stack environment. 该工具将结果写入到 .json 报表文件。The tool writes results to a .json report file. 该报表显示有关 Azure Stack 部署的先决条件状态的详细数据和汇总数据。The report displays detailed and summarized data about the state of prerequisites for deployment of Azure Stack. 该报表还显示有关现有 Azure Stack 部署的机密轮换的信息。The report also displays information about secrets rotation for existing Azure Stack deployments.

在何处可以找到该报表Where to find the report

该工具运行时,它会将结果记录到 AzsReadinessCheckerReport.json 中。When the tool runs, it logs results to AzsReadinessCheckerReport.json. 该工具还会创建一个名为 AzsReadinessChecker.log 的日志。The tool also creates a log named AzsReadinessChecker.log. 这些文件的位置会随验证结果一起显示在 PowerShell 中:The location of these files displays along with the validation results in PowerShell:

运行验证

当在同一计算机上运行后续验证检查时,这两个文件都会持久保留这些验证检查的结果。Both files persist the results of subsequent validation checks when run on the same computer. 例如,可以运行该工具来验证证书,再次运行它来验证 Azure 标识,第三次运行它来验证注册。For example, the tool can be run to validate certificates, run again to validate Azure identity, and then a third time to validate registration. 所有三次验证的结果都在生成的 .json 报表中。The results of all three validations are available in the resulting .json report.

默认情况下,这两个文件都写入到 C:\Users\username\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessCheckerReport.jsonBy default, both files are written to C:\Users\username\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessCheckerReport.json.

  • 可以在命令行的末尾使用 -OutputPath <path> 参数来指定不同的报告位置。Use the -OutputPath <path> parameter at the end of the command line to specify a different report location.
  • 可以在命令行的末尾使用 -CleanReport 参数从 AzsReadinessCheckerReport.json 中清除有关以前运行此工具的相关信息。Use the -CleanReport parameter at the end of the command line to clear information about previous runs of the tool from AzsReadinessCheckerReport.json.

查看报告View the report

若要在 PowerShell 中查看报表,请将报表路径提供为 -ReportPath 的值。To view the report in PowerShell, supply the path to the report as a value for -ReportPath. 此命令显示报表内容,并指明尚没有结果的验证。This command displays the contents of the report and identifies validations that do not yet have results.

例如,若要从打开到报表所在位置的 PowerShell 提示符查看报表,请运行以下命令:For example, to view the report from a PowerShell prompt that is open to the location where the report is located, run the following command:

Read-AzsReadinessReport -ReportPath .\AzsReadinessReport.json

输出类似于以下示例:The output is similar to the following example:

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.partner.onmschina.cn
Azure Environment             : AzureChinaCloud
Azure Active Directory Tenant : contoso.partner.onmschina.cn
Error Details                 : 

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

Azure Identity Validation found no errors or warnings.

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

Azure Stack Graph Validation results not available.

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

Azure Stack 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 :

查看报表摘要View the report summary

若要查看报表摘要,可以在 PowerShell 命令的末尾添加 -summary 参数。To view a summary of the report, you can add the -summary parameter to the end of the PowerShell command. 例如:For example:

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

摘要会显示没有结果的验证并且会指明已完成的验证是通过还是失败。The summary shows validations that do not have results, and indicates pass or fail for validations that are complete. 输出类似于以下示例:The output is similar to the following example:

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 Graph Validation Summary ###############

Azure Stack Graph Validation results not available.

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

Azure Stack ADFS Validation results not available.

查看经筛选的报表View a filtered report

若要查看基于单一验证类型筛选的报表,请将 -ReportSections 参数与以下值之一结合使用:To view a report that is filtered on a single type of validation, use the -ReportSections parameter with one of the following values:

  • 证书Certificate
  • AzureRegistrationAzureRegistration
  • AzureIdentityAzureIdentity
  • GraphGraph
  • ADFSADFS
  • 作业Jobs
  • 全部All

例如,若要仅查看证书的报表摘要,请使用以下 PowerShell 命令行:For example, to view the report summary for certificates only, use the following PowerShell command line:

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