Azure Stack Hub 驗證報告Azure Stack Hub validation report

使用Azure Stack Hub 整備檢查程式工具來執行驗證,這些驗證支援 Azure Stack Hub 環境的部署和維護。Use the Azure Stack Hub Readiness Checker tool to run validations that support deployment and servicing of an Azure Stack Hub environment. 此工具會將結果寫入 .json 報告檔案。The tool writes results to a .json report file. 報告會針對 Azure Stack Hub 部署的必要條件狀態,顯示相關的詳細和摘要資料。The report displays detailed and summarized data about the state of prerequisites for deployment of Azure Stack Hub. 報告也會顯示現有 Azure Stack Hub 部署祕密輪替的相關資訊。The report also displays information about secrets rotation for existing Azure Stack Hub deployments.

報告的所在位置Where to find the report

工具在執行時,會將結果記錄至 AzsReadinessCheckerReport.jsonWhen 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:

Azure Stack Hub 整備檢查程式的執行驗證結果

這兩個檔案都會保存同一部電腦上所執行的後續驗證檢查結果。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 don't yet have results.

例如,若要從 PowerShell 提示字元檢視對報告所在位置開啟的報告,請執行下列命令:For example, to view the report from a PowerShell prompt that's 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.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 :

檢視報告摘要View the report summary

若要檢視報告的摘要,您可以將 -summary 參數新增至 PowerShell 命令的結尾。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 don't 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 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.

檢視篩選的報告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
  • 圖形Graph
  • 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