驗證 Azure Stack Hub 系統狀態

發行項
11/23/2024

身為 Azure Stack Hub 操作員，能夠判斷系統隨選的健康情況和狀態至關重要。 Azure Stack Hub 驗證工具（Test-AzureStack）是 PowerShell Cmdlet，可讓您在系統上執行一系列測試，以識別是否存在失敗。當您連絡Microsoft客戶服務支援（Microsoft 支援服務）時，通常會要求您透過特殊許可權端點（PEP）執行此工具。透過手邊的系統健康情況和狀態資訊，Microsoft 支援服務可以收集和分析詳細的記錄、專注於發生錯誤的區域，並與您合作以修正問題。

執行驗證工具並存取結果

您可以使用 PEP 來執行驗證工具。此工具可能需要一段時間才能執行。時間長度取決於您系統中的虛擬機數目。每個測試都會在 PowerShell 視窗中傳回 PASS/FAIL 狀態。

以下是端對端驗證測試程序的大綱：

建立信任。在整合式系統上，從提升許可權的 Windows PowerShell 會話執行下列命令，在硬體生命週期主機或特殊許可權存取工作站上執行的強化 VM 上，將 PEP 新增為受信任的主機。
```
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 所產生的記錄。如果測試報告 WARN，建議您不要收集記錄並連絡 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, AzsInfraCapacity
```
```
Test-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 參數同時執行多個測試類別。目前已定義三個群組： 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

群組參數範例

下列範例會執行 Test-AzureStack 來測試系統整備程度，再使用 Group 安裝更新或 Hotfix。開始安裝更新或 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 疑難解答。

共用方式為