Verifiera Azure Stack Hub-systemtillstånd
Som Azure Stack Hub-operatör är det viktigt att kunna fastställa systemets hälsotillstånd och status på begäran. Valideringsverktyget för Azure Stack Hub (Test-AzureStack)) är en PowerShell-cmdlet som gör att du kan köra en serie tester på systemet för att identifiera eventuella fel. Du uppmanas vanligtvis att köra det här verktyget via den privilegierade slutpunkten (PEP) när du kontaktar Microsofts kundtjänst (Microsoft Support) med ett problem. Med systemomfattande hälso- och statusinformation till hands kan Microsoft Support samla in och analysera detaljerade loggar, fokusera på området där felet inträffade och arbeta med dig för att åtgärda problemet.
Köra verifieringsverktyget och få åtkomst till resultat
Du kan använda PEP för att köra valideringsverktyget. Det kan ta en stund att köra verktyget. Hur lång tid det tar beror på antalet virtuella datorer i systemet. Varje test returnerar statusen PASS/FAIL i PowerShell-fönstret.
Här är en översikt över valideringstestningsprocessen från slutpunkt till slutpunkt:
Upprätta förtroendet. I ett integrerat system kör du följande kommando från en upphöjd Windows PowerShell session för att lägga till PEP som en betrodd värd på den härdade virtuella datorn som körs på maskinvarulivscykelvärden eller arbetsstationen för privilegierad åtkomst.
winrm s winrm/config/client '@{TrustedHosts="<IP Address of Privileged Endpoint>"}'Om du kör Azure Stack Development Kit (ASDK) loggar du in på development kit-värden.
Få åtkomst till PEP. Kör följande kommandon för att upprätta en PEP-session:
Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcredTips
Om du vill komma åt PEP på en ASDK-värddator (Azure Stack Development Kit) använder du AzS-ERCS01 för -ComputerName.
När du är i PEP, kör:
Test-AzureStackMer information finns i Parameteröverväganden och Exempel på användningsfall.
Om några tester rapporterar FAIL kör du
Get-AzureStackLog. Anvisningar om ett integrerat system finns i så här kör du Get-AzureStackLog på integrerade Azure Stack Hub-system.Cmdleten samlar in loggar som genererats av Test-AzureStack. Vi rekommenderar att du inte samlar in loggar och kontaktar Microsoft Support i stället om testrapporten WARN.
Om du uppmanas att köra valideringsverktyget av Microsoft Support begär den Microsoft Support representanten loggarna som du har samlat in för att fortsätta felsöka problemet.
Tester som är tillgängliga
Med valideringsverktyget kan du köra en serie tester på systemnivå och grundläggande molnscenarier som ger dig insikt i det aktuella tillståndet, så att du kan åtgärda problem i systemet.
Molninfrastrukturtester
Dessa tester med låg påverkan fungerar på infrastrukturnivå och ger dig information om olika systemkomponenter och funktioner. För närvarande grupperas testerna i följande kategorier:
| Testkategori | Argument för -Include och -Ignore |
|---|---|
| Azure Stack Hub ACS-sammanfattning | AzsAcsSummary |
| Åtgärdsplanstatus för Azure Stack Hub | AzsActionPlanStatus |
| Azure Stack Hub Agent Health | AzsAgentHealth |
| Sammanfattning av förhandsversionen av Azure Stack AKS Arc | AzsAksArcPreviewSummary |
| Sammanfattning av Azure Stack Hub Active Directory | AzsAdSummary |
| Aviseringssammanfattning för Azure Stack Hub | AzsAlertSummary |
| Sammanfattning av programkrasch i Azure Stack Hub | AzsApplicationCrashSummary |
| Tillgänglighetssammanfattning för Azure Stack Hub Backup-resurs | AzsBackupShareAccessibility |
| Översikt över Kontrollplan för Azure Stack Hub | AzsControlPlane |
| Azure Stack Hub DCB-validering | AzsDCBValidation |
| Sammanfattning av Azure Stack Hub Defender | AzsDefenderSummary |
| Azure Stack Hub ECE-etableringsstatus | AzsEceProvisioningStatus |
| Sammanfattning av externa Certifikat för Azure Stack Hub | AzsExternalCertificates |
| Översikt över GPU-konfiguration för Azure Stack Hub | AzsGpuConfigurationSummary |
| Aktivera Azure Stack Hub Hardware Monitor | AzsGpuConfigurationSummary |
| Sammanfattning av inbyggd programvara för Azure Stack Hub-värdinfrastruktur | AzsHostingInfraFWSummary |
| Sammanfattning av Azure Stack Hub-värdinfrastruktur | AzsHostingInfraSummary |
| Användning av Azure Stack Hub-värdinfrastruktur | AzsHostingInfraUtilization |
| Azure Stack Hub-identitetsprovideranslutning | AzsIdentityProviderConnectivity |
| Identitetsproviderstatus för Azure Stack Hub | AzsIdentityProviderStatus |
| Infrastrukturkapacitet för Azure Stack Hub | AzsInfraCapacity |
| Filvalidering för Azure Stack Hub-infrastruktur | AzsInfraFileValidation |
| Prestanda för Azure Stack Hub-infrastruktur | AzsInfraPerformance |
| Rollsammanfattning för Azure Stack Hub-infrastruktur | AzsInfraRoleSummary |
| Uppdateringsminne för Azure Stack Hub-infrastruktur | AzsInfraUpdateMemory |
| Sammanfattning av uppdatering av infrastruktur i Azure Stack Hub | AzsInfraUpdateSummary |
| Azure Stack Hub NCImos-validering | AzsNCImosValidation |
| Nätverksfras för Azure Stack Hub | AzsNetworkInfra |
| Oem-maskinvara för Azure Stack Hub | AzsOemHardware |
| Krav för OEM-uppdatering för Azure Stack Hub | AzsOemUpdatePrereqs |
| Sammanfattning av Azure Stack Hub-portalen och API:et | AzsPortalAPISummary |
| Rdma-driftstatus för Azure Stack Hub | AzsRdmaOperationalStatus |
| Autentiseringsstatus för Azure Stack Hub-resursprovider | AzsResourceProviderAuthStatus |
| Vm-händelser för Azure Stack Hub Scale Unit | AzsScaleUnitEvents |
| Vm-resurser för Azure Stack Hub-skalningsenhet | AzsScaleUnitResources |
| Azure Stack Hub-scenarier | AzsScenarios |
| Rollsammanfattning för Azure Stack Hub Service Fabric | AzsSFRoleSummary |
| Sql-diagnostik för Azure Stack Hub | AzsSQLDiagnostics |
| Sql-sammanfattning för Azure Stack Hub | AzsSQLSummary |
| Azure Stack Hub Stamp BMC Summary | AzsStampBMCSummary |
| Azure Stack Hub Storage-dataplan | AzsStorageDataPlane |
| Sammanfattning av Azure Stack Hub Storage Services | AzsStorageSvcsSummary |
| Sammanfattning av Azure Stack Hub SQL Store | AzsStoreSummary |
| Användningssammanfattning för Azure Stack Hub | AzsUsage |
| Sammanfattning av Azure Stack Hub Usage Bridge | AzsUsageBridgeSummary |
| Sammanfattning av placering av virtuell Azure Stack Hub-dator | AzsVmPlacement |
Molnscenariotester
Förutom infrastrukturtesterna i föregående avsnitt kan du även köra molnscenariotester för att kontrollera funktionerna i infrastrukturkomponenterna. Autentiseringsuppgifter för molnadministratör krävs för att köra dessa tester eftersom de omfattar resursdistribution.
Anteckning
För närvarande kan du inte köra molnscenariotester med autentiseringsuppgifter för Active Directory Federated Services (AD FS).
Följande molnscenarier testas av valideringsverktyget:
- Skapa resursgrupp
- Skapa plan
- Skapa erbjudande
- Skapa lagringskonto
- Skapa virtuell dator (VM)
- Bloblagringsåtgärd
- Kölagringsåtgärd
- Tabelllagringsåtgärd
Parameteröverväganden
Parameterlistan kan användas för att visa alla tillgängliga testkategorier.
Parametrarna Include och Ignore kan användas för att inkludera eller exkludera testkategorier. Mer information om dessa argument finns i följande avsnitt.
Test-AzureStack -Include AzsSFRoleSummary, AzsInfraCapacityTest-AzureStack -Ignore AzsInfraPerformanceEn virtuell klientdator distribueras som en del av molnscenariotesterna. Du kan använda DoNotDeployTenantVm för att inaktivera den här VM-distributionen.
Du måste ange parametern ServiceAdminCredential för att köra molnscenariotester enligt beskrivningen i avsnittet Användningsfallsexempel .
BackupSharePath och BackupShareCredential används när du testar säkerhetskopieringsinställningarna för infrastrukturen, som du ser i avsnittet Användningsfallsexempel .
DetailedResults kan användas för att hämta information om pass/fail/warning för varje test samt den övergripande körningen. När det inte anges returnerar Test-AzureStack$true om det inte finns några fel och $false om det uppstår fel.
TimeoutSeconds kan användas för att ange en specifik tid för varje grupp att slutföras.
Valideringsverktyget stöder också vanliga PowerShell-parametrar: Utförlig, Felsökning, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable och OutVariable. Mer information finns i Om vanliga parametrar.
Användningsfallsexempel
Köra validering utan molnscenarier
Kör valideringsverktyget utan parametern ServiceAdminCredential för att hoppa över körning av molnscenariotester:
New-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred -SessionOption (New-PSSessionOption -Culture en-US -UICulture en-US)
Test-AzureStack
Köra validering med molnscenarier
Om du anger verifieringsverktyget med parametern ServiceAdminCredentials körs molnscenariotesterna som standard:
Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred
Test-AzureStack -ServiceAdminCredential "<Cloud administrator user name>"
Om du bara vill köra molnscenarier utan att köra resten av testerna kan du använda parametern Include för att göra det:
Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred
Test-AzureStack -ServiceAdminCredential "<Cloud administrator user name>" -Include AzsScenarios
Molnadministratörens användarnamn måste skrivas i UPN-format: serviceadmin@contoso.onmicrosoft.com (Microsoft Entra ID). När du uppmanas till det skriver du lösenordet till molnadministratörskontot.
Grupper
För att förbättra operatorupplevelsen har en gruppparameter aktiverats för att köra flera testkategorier samtidigt. För närvarande finns det tre grupper definierade: Standard, UpdateReadiness och SecretRotationReadiness.
Standard: Anses vara en standardkörning av Test-AzureStack. Den här gruppen körs som standard om inga andra grupper har valts.
UpdateReadiness: En kontroll för att se om Azure Stack Hub-instansen kan uppdateras. När gruppen UpdateReadiness körs visas varningar som fel i konsolens utdata, och de bör betraktas som blockerare för uppdateringen. Följande kategorier ingår i gruppen UpdateReadiness :
- AzsInfraFileValidation
- AzsActionPlanStatus
- AzsStampBMCSummary
SecretRotationReadiness: En kontroll för att se om Azure Stack Hub-instansen är i ett tillstånd där hemlig rotation kan köras. När gruppen SecretRotationReadiness körs visas varningar som fel i konsolens utdata och de bör betraktas som blockerare för hemlig rotation. Följande kategorier ingår i gruppen SecretRotationReadiness:
- AzsAcsSummary
- AzsDefenderSummary
- AzsHostingInfraSummary
- AzsInfraCapacity
- AzsInfraRoleSummary
- AzsPortalAPISummary
- AzsSFRoleSummary
- AzsStorageSvcsSummary
- AzsStoreSummary
Exempel på gruppparameter
I följande exempel körs Test-AzureStack för att testa systemberedskap innan du installerar en uppdatering eller snabbkorrigering med hjälp av Grupp. Innan du startar installationen av en uppdatering eller snabbkorrigering kör du Test-AzureStack för att kontrollera statusen för din Azure Stack Hub:
Test-AzureStack -Group UpdateReadiness
Kör valideringsverktyget för att testa säkerhetskopieringsinställningarna för infrastrukturen
Innan du konfigurerar säkerhetskopiering av infrastrukturen kan du testa sökvägen och autentiseringsuppgifterna för säkerhetskopieringsresursen med hjälp av testet AzsBackupShareAccessibility :
Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred
Test-AzureStack -Include AzsBackupShareAccessibility -BackupSharePath "\\<fileserver>\<fileshare>" -BackupShareCredential $using:backupcred
När du har konfigurerat säkerhetskopieringen kan du köra AzsBackupShareAccessibility för att verifiera att resursen är tillgänglig från ERCS:
Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred
Test-AzureStack -Include AzsBackupShareAccessibility
Om du vill testa nya autentiseringsuppgifter med den konfigurerade säkerhetskopieringsresursen kör du:
Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred
Test-AzureStack -Include AzsBackupShareAccessibility -BackupShareCredential "<PSCredential for backup share>"
Kör valideringsverktyget för att testa nätverksinfrastrukturen
Det här testet kontrollerar anslutningen för nätverksinfrastrukturen som kringgår det programvarudefinierade nätverket (SDN) för Azure Stack Hub. Den visar anslutningen från en offentlig VIP till konfigurerade DNS-vidarebefordrare, NTP-servrar och autentiseringsslutpunkter. Detta inkluderar anslutning till Azure när du använder Microsoft Entra ID som identitetsprovider eller federerad server när du använder AD FS som identitetsprovider.
Inkludera felsökningsparametern för att få detaljerade utdata från kommandot:
Test-AzureStack -Include AzsNetworkInfra -Debug
Nästa steg
Mer information om diagnostikverktyg för Azure Stack Hub och problemloggning finns i Azure Stack Hub Diagnostic log collection (Azure Stack Hub Diagnostic log collection).
Mer information om felsökning finns i Felsökning av Microsoft Azure Stack Hub.