驗證 Azure Stack Hub 系統狀態
身為 Azure Stack Hub 操作員，能夠依需求判斷系統的健康情況和狀態非常重要。 Azure Stack Hub 驗證工具 (Test-AzureStack) 是一個 PowerShell Cmdlet，可讓您在系統上執行一系列的測試來找出失敗 (如果有的話)。 當您連絡 Microsoft 客戶服務支援 (Microsoft 支援服務) 解決問題時，通常會要求您透過特殊權限端點 (PEP) 來執行此工具。 利用現有的全系統健康情況和狀態資訊，Microsoft 支援服務可以收集和分析詳細的記錄，專注於錯誤發生的區域，並與您一起解決問題。
執行驗證工具並存取結果
您可以使用 PEP 來執行驗證工具。 此工具可能需要一段時間才能執行。 時間長度取決於您系統中的虛擬機器數目。 每項測試會在 PowerShell 視窗中傳回 PASS/FAIL (通過/失敗) 狀態。
以下是端對端驗證測試流程的大綱：
建立信任關係。 在整合的系統中，從提升權限的 Windows PowerShell 工作階段執行下列命令，將 PEP 新增為在硬體生命週期主機或特殊權限存取工作站上執行的強化 VM 的受信任主機。
winrm s winrm/config/client '@{TrustedHosts="<IP Address of Privileged Endpoint>"}'如果您是執行 Azure Stack 開發套件 (ASDK)，請登入開發套件主機。
存取 PEP。 執行下列命令來建立 PEP 工作階段：
Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred提示
若要存取 Azure Stack 開發套件 (ASDK) 主機電腦上的 PEP，請使用 AzS-ERCS01 for -ComputerName。
當您在 PEP 中，請執行：
Test-AzureStack如果任何測試報告 FAIL (失敗)，請執行
Get-AzureStackLog。 如需整合系統的指示，請參閱在 Azure Stack Hub 整合系統上執行 Get-AzureStackLog。此 Cmdlet 會收集 Test-AzureStack 所產生的記錄。 如果測試回報 [警告]，我們建議您不要收集記錄，而是連絡 Microsoft 支援服務。
如果您已透過 Microsoft 支援服務指示來執行驗證工具，Microsoft 支援服務代表會要求您提供收集的記錄，以繼續對問題進行疑難排解。
測試可供使用
驗證工具可讓您執行一系列系統層級的測試和基本雲端案例，使您能夠深入了解目前狀態，並讓您修正系統中的問題。
雲端基礎結構測試
這些影響不大的測試適用於基礎結構層級，並為您提供有關各種系統元件和函式的相關資訊。 目前，測試分組為以下類別：
| 測試分類 | -Include 和 -Ignore 的引數 |
|---|---|
| Azure Stack Hub ACS 摘要 | AzsAcsSummary |
| Azure Stack Hub 動作計劃狀態 | AzsActionPlanStatus |
| Azure Stack Hub 代理程式健康情況 | AzsAgentHealth |
| Azure Stack AKS Arc 預覽摘要 | AzsAksArcPreviewSummary |
| Azure Stack Hub Active Directory 摘要 | AzsAdSummary |
| Azure Stack Hub 警示摘要 | AzsAlertSummary |
| Azure Stack Hub 應用程式損毀摘要 | AzsApplicationCrashSummary |
| Azure Stack Hub 備份共用的可及性摘要 | AzsBackupShareAccessibility |
| Azure Stack Hub 控制平面摘要 | AzsControlPlane |
| Azure Stack Hub DCB 驗證 | AzsDCBValidation |
| Azure Stack Hub Defender 摘要 | AzsDefenderSummary |
| Azure Stack Hub ECE 布建狀態 | AzsEceProvisioningStatus |
| Azure Stack Hub 外部憑證摘要 | AzsExternalCertificates |
| Azure Stack Hub GPU 組態摘要 | AzsGpuConfigurationSummary |
| Azure Stack Hub 硬體監視器啟用 | AzsGpuConfigurationSummary |
| Azure Stack Hub 裝載基礎結構韌體摘要 | AzsHostingInfraFWSummary |
| Azure Stack Hub 裝載基礎結構摘要 | AzsHostingInfraSummary |
| Azure Stack Hub 裝載基礎結構使用率 | AzsHostingInfraUtilization |
| Azure Stack Hub 識別提供者連線能力 | AzsIdentityProviderConnectivity |
| Azure Stack Hub 識別提供者狀態 | AzsIdentityProviderStatus |
| Azure Stack Hub 基礎結構容量 | AzsInfraCapacity |
| Azure Stack Hub 基礎結構檔案驗證 | AzsInfraFileValidation |
| Azure Stack Hub 基礎結構效能 | AzsInfraPerformance |
| Azure Stack Hub 基礎結構角色摘要 | AzsInfraRoleSummary |
| Azure Stack Hub 基礎結構更新記憶體 | AzsInfraUpdateMemory |
| Azure Stack Hub 基礎結構更新摘要 | AzsInfraUpdateSummary |
| Azure Stack Hub NCImos 驗證 | AzsNCImosValidation |
| Azure Stack Hub 網路基礎結構 | AzsNetworkInfra |
| Azure Stack Hub OEM 硬體 | AzsOemHardware |
| Azure Stack Hub OEM 更新必要條件 | AzsOemUpdatePrereqs |
| Azure Stack Hub 入口網站和 API 摘要 | AzsPortalAPISummary |
| Azure Stack Hub RDMA 作業狀態 | AzsRdmaOperationalStatus |
| Azure Stack Hub 資源提供者驗證狀態 | AzsResourceProviderAuthStatus |
| Azure Stack Hub 縮放單位 VM 事件 | AzsScaleUnitEvents |
| Azure Stack Hub 縮放單位 VM 資源 | AzsScaleUnitResources |
| Azure Stack Hub 案例 | AzsScenarios |
| Azure Stack Hub Service Fabric 角色摘要 | AzsSFRoleSummary |
| Azure Stack Hub SQL 診斷 | AzsSQLDiagnostics |
| Azure Stack Hub SQL 摘要 | AzsSQLSummary |
| Azure Stack Hub 戳記 BMC 摘要 | AzsStampBMCSummary |
| Azure Stack Hub 儲存體資料平面 | AzsStorageDataPlane |
| Azure Stack Hub 儲存體服務摘要 | AzsStorageSvcsSummary |
| Azure Stack Hub SQL 存放區摘要 | AzsStoreSummary |
| Azure Stack Hub 使用量摘要 | AzsUsage |
| Azure Stack Hub 使用量網橋摘要 | AzsUsageBridgeSummary |
| Azure Stack Hub VM 放置摘要 | AzsVmPlacement |
雲端案例測試
除了上一節中的基礎結構測試之外，您也可以執行雲端案例測試來檢查基礎結構元件的功能。 因為這些測試涉及資源部署，所以需要雲端系統管理員認證才能執行這些測試。
注意
您目前無法使用 Active Directory 同盟服務 (AD FS) 認證執行雲端案例測試。
下列雲端案例都經過驗證工具測試：
- 資源群組建立
- 方案建立
- 供應項目建立
- 儲存體帳戶建立
- 虛擬機器建立 (VM)
- Blob 儲存體作業
- 佇列儲存體作業
- 資料表儲存體作業
參數考量
List 參數可用來顯示所有可用的測試類別。
Include 和 Ignore 參數可用來包含或排除測試分類。 如需關於些引數的詳細資訊，請參閱下一節。
Test-AzureStack -Include AzsSFRoleSummary, AzsInfraCapacityTest-AzureStack -Ignore AzsInfraPerformance租用戶 VM 會隨著雲端案例測試而部署。 您可以使用 DoNotDeployTenantVm 來停用此 VM 部署。
您必須提供 ServiceAdminCredential 參數來執行雲端案例測試，如使用案例範例一節中所述。
在測試基礎結構備份設定時，使用了 BackupSharePath 和 BackupShareCredential，如使用案例範例一節中所示。
DetailedResults 可用來取得每個測試及整體執行的成功/失敗/警告資訊。 未指定時，如果沒有任何失敗，Test-AzureStack 會傳回 $true，如果發生失敗，則傳回 $false。
TimeoutSeconds 可用來設定完成每個群組的特定時間。
驗證工具也支援一般 PowerShell 參數：Verbose、Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、OutBuffer、PipelineVariable 和 OutVariable。 如需詳細資訊，請參閱關於一般參數。
使用案例範例
執行沒有雲端案例的驗證
執行沒有 ServiceAdminCredential 參數的驗證工具，以略過執行雲端案例測試：
New-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred -SessionOption (New-PSSessionOption -Culture en-US -UICulture en-US)
Test-AzureStack
執行具有雲端案例的驗證
依預設提供具有 ServiceAdminCredentials 參數的驗證工具，以執行雲端案例測試：
Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred
Test-AzureStack -ServiceAdminCredential "<Cloud administrator user name>"
如果您希望僅執行雲端案例而不執行其餘測試，則可以使用 Include 參數來執行這項操作：
Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred
Test-AzureStack -ServiceAdminCredential "<Cloud administrator user name>" -Include AzsScenarios
雲端管理員使用者名稱必須以UPN格式輸入： serviceadmin@contoso.onmicrosoft.com (Microsoft Entra ID) 。 出現提示時，輸入雲端管理員帳戶的密碼。
群組
為改善操作員的體驗，我們已啟用可同時執行多個測試分類的 Group 參數。 目前有 3 個已定義的群組：Default、UpdateReadiness 和 SecretRotationReadiness。
預設值：我們將其視為 Test-AzureStack 的標準執行。 如果未選取任何其他群組，則會預設執行此群組。
UpdateReadiness：查看是否可以更新 Azure Stack Hub 執行個體。 執行 UpdateReadiness 群組時，主控台輸出中的警告會顯示為錯誤，而且應被視為更新的阻礙。 下列是屬於 UpdateReadiness 群組的類別：
- AzsInfraFileValidation
- AzsActionPlanStatus
- AzsStampBMCSummary
SecretRotationReadiness：查看 Azure Stack Hub 執行個體是否處在可執行祕密輪替的狀態。 執行 SecretRotationReadiness 群組時，主控台輸出中的警告會顯示為錯誤，而且應被視為祕密輪替的阻礙。 下列是屬於 SecretRotationReadiness 群組的類別：
- AzsAcsSummary
- AzsDefenderSummary
- AzsHostingInfraSummary
- AzsInfraCapacity
- AzsInfraRoleSummary
- AzsPortalAPISummary
- AzsSFRoleSummary
- AzsStorageSvcsSummary
- AzsStoreSummary
群組參數範例
下列範例會在使用 Group 安裝更新或 Hotfix 之前，執行 Test-AzureStack 來測試系統的整備狀態。 在開始安裝更新或 Hotfix 之前，執行 Test-AzureStack 來檢查您的 Azure Stack Hub 狀態：
Test-AzureStack -Group UpdateReadiness
執行驗證工具以測試基礎結構備份設定
設定基礎結構備份之前，您可以使用 AzsBackupShareAccessibility 測試來測試備份共用路徑和認證：
Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred
Test-AzureStack -Include AzsBackupShareAccessibility -BackupSharePath "\\<fileserver>\<fileshare>" -BackupShareCredential $using:backupcred
設定好備份之後，您可以執行 AzsBackupShareAccessibility 以驗證是否可以從 ERCS 存取共用：
Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred
Test-AzureStack -Include AzsBackupShareAccessibility
若要對設定的備份共用測試新認證，請執行：
Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred
Test-AzureStack -Include AzsBackupShareAccessibility -BackupShareCredential "<PSCredential for backup share>"
執行驗證工具來測試網路基礎結構
此測試會略過 Azure Stack Hub 軟體所定義的網路 (SDN)，藉此確認網路基礎結構的連線能力。 其會示範從公用 VIP 對所設定 DNS 轉寄站、NTP 伺服器和驗證端點的連線。 這包括使用 Microsoft Entra ID 身分識別提供者時，或當使用AD FS作為識別提供者時的同盟伺服器時，與 Azure 的連線能力。
請納入偵錯參數以取得命令的詳細輸出：
Test-AzureStack -Include AzsNetworkInfra -Debug
後續步驟
若要深入了解 Azure Stack Hub 診斷工具和問題記錄的詳細資訊，請參閱 Azure Stack Hub 診斷記錄集合。
若要深入了解疑難排解，請參閱 Microsoft Azure Stack Hub 疑難排解。
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應