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:

1. 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.

2. 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 $localcred 
   

   Tips

   Om du vill komma åt PEP på en ASDK-värddator (Azure Stack Development Kit) använder du AzS-ERCS01 för -ComputerName.

3. När du är i PEP, kör:

   Test-AzureStack
   

   Mer information finns i Parameteröverväganden och Exempel på användningsfall.

4. 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.

5. 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:

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.

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, AzsInfraCapacity
  

  Test-AzureStack -Ignore AzsInfraPerformance
  

• En 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.