Verifiera Azure Stack Hub-systemtillstånd
Som Azure Stack Hub-operatör är det viktigt att kunna fastställa hälsotillståndet och statusen för systemet 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 i systemet för att identifiera fel om det finns. Du uppmanas vanligtvis att köra det här verktyget via den privilegierade slutpunkten (PEP) när du kontaktar Microsofts kundtjänstsupport (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å maskinvarulivscykelns värd eller arbetsstationen 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 $localcredDricks
Om du vill komma åt PEP på en Värddator för Azure Stack Development Kit (ASDK) 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 hur du kör 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 VARNAR.
Om du uppmanas att köra valideringsverktyget av Microsoft Support begär 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 insikter om 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 |
| Status för Åtgärdsplan för Azure Stack Hub | AzsActionPlanStatus |
| Azure Stack Hub Agent Health | AzsAgentHealth |
| Förhandsversionssammanfattning för Azure Stack AKS Arc | AzsAksArcPreviewSummary |
| Sammanfattning av Azure Stack Hub Active Directory | AzsAdSummary |
| Azure Stack Hub-aviseringssammanfattning | AzsAlertSummary |
| Kraschsammanfattning för Azure Stack Hub-program | 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 |
| Ece-etableringsstatus för Azure Stack Hub | AzsEceProvisioningStatus |
| Sammanfattning av externa Certifikat i Azure Stack Hub | AzsExternalCertificates |
| Konfigurationssammanfattning för Azure Stack Hub GPU | AzsGpuConfigurationSummary |
| Aktivera Azure Stack Hub Hardware Monitor | AzsGpuConfigurationSummary |
| Sammanfattning av inbyggd programvara för Azure Stack Hub-värdinfrastruktur | AzsHostingInfraFWSummary |
| Översikt över Azure Stack Hub-värdinfrastruktur | AzsHostingInfraSummary |
| Användning av Azure Stack Hub-värdinfrastruktur | AzsHostingInfraUtilization |
| Azure Stack Hub-identitetsprovideranslutning | AzsIdentityProviderConnectivity |
| Status för Azure Stack Hub-identitetsprovider | AzsIdentityProviderStatus |
| Infrastrukturkapacitet för Azure Stack Hub | AzsInfraCapacity |
| Validering av infrastrukturfil i Azure Stack Hub | 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 för Azure Stack Hub | AzsInfraUpdateSummary |
| NcImos-validering för Azure Stack Hub | 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 |
| Azure Stack Hub-portalen och API-sammanfattning | 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 |
| BMC-sammanfattning av Azure Stack Hub-stämpel | 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 |
| Placeringssammanfattning för 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 funktioner mellan infrastrukturkomponenter. Autentiseringsuppgifter för molnadministratör krävs för att köra dessa tester eftersom de omfattar resursdistribution.
Kommentar
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
- Problem med att 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 Inkludera och Ignorera 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 Exempel på användningsfall .
BackupSharePath och BackupShareCredential används vid testning av säkerhetskopieringsinställningar för infrastruktur, som du ser i avsnittet Exempel på användningsfall .
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 finns fel.
TimeoutSeconds kan användas för att ange en viss tid för varje grupp att slutföras.
Valideringsverktyget stöder också vanliga PowerShell-parametrar: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable och OutVariable. Mer information finns i Om vanliga parametrar.
Använd fallexempel
Köra validering utan molnscenarier
Kör valideringsverktyget utan parametern ServiceAdminCredential för att hoppa över att köra 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 tillhandahåller valideringsverktyget 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 Inkludera 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ällningar 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 genom att kringgå 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.