Freigeben über


Überprüfen des Azure Stack Hub-Systemstatus

Es ist sehr wichtig, dass Sie als Azure Stack Hub-Operator bei Bedarf die Integrität und den Status Ihres Systems ermitteln können. Das Azure Stack Hub-Überprüfungstool (Test-AzureStack) ist ein PowerShell-Cmdlet, mit dem Sie eine Reihe von Tests auf Ihrem System ausführen können, um vorliegende Fehler zu identifizieren. In der Regel werden Sie aufgefordert, dieses Tool über den privilegierten Endpunkt (PEP) auszuführen, wenn Sie sich wegen eines Problems an den Microsoft-Support wenden. Wenn die systemweiten Integritäts- und Statusinformationen vorliegen, kann der Microsoft-Support detaillierte Protokolle sammeln und analysieren, sich auf den Bereich konzentrieren, in dem der Fehler aufgetreten ist, und mit Ihnen zusammenarbeiten, um das Problem zu beheben.

Ausführen des Überprüfungstools und Zugreifen auf die Ergebnisse

Sie können den PEP verwenden, um das Überprüfungstool auszuführen. Die Ausführung des Tools kann eine Weile dauern. Die benötigte Zeit hängt von der Anzahl der virtuellen Computer in Ihrem System ab. Jeder Test gibt im PowerShell-Fenster einen PASS/FAIL-Status zurück.

Hier ist eine Gliederung des Prozesses für End-to-End-Validierungstests angegeben:

  1. Richten Sie die Vertrauensstellung ein. Führen Sie auf einem integrierten System in einer Windows PowerShell-Sitzung mit erhöhten Rechten den folgenden Befehl aus, um den PEP als vertrauenswürdigen Host auf der gehärteten virtuellen VM hinzuzufügen, die auf dem Hardwarelebenszyklus-Host oder der Arbeitsstation mit privilegiertem Zugriff ausgeführt wird.

    winrm s winrm/config/client '@{TrustedHosts="<IP Address of Privileged Endpoint>"}'
    

    Wenn Sie das ASDK (Azure Stack Development Kit) ausführen, melden Sie sich beim Development Kit-Host an.

  2. Greifen Sie auf den PEP zu. Führen Sie die folgenden Befehle aus, um eine PEP-Sitzung einzurichten:

    Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred 
    

    Tipp

    Verwenden Sie „AzS-ERCS01“ als „-ComputerName“, um auf den PEP auf einem ASDK-Hostcomputer (Azure Stack Development Kit) zuzugreifen.

  3. Führen Sie auf dem PEP Folgendes aus:

    Test-AzureStack
    

    Weitere Informationen finden Sie unter Überlegungen zu Parametern und Beispiele für Anwendungsfälle.

  4. Führen Sie Get-AzureStackLog aus, wenn für Tests FAIL (FEHLER) gemeldet wird. Eine Anleitung zu einem integrierten System finden Sie unter Ausführen von „Get-AzureStackLog“ in integrierten Azure Stack Hub-Systemen.

    Das Cmdlet sammelt Protokolle, die von Test-AzureStack generiert wurden. Wir empfehlen Ihnen, keine Protokolle zu erfassen und sich stattdessen an den Microsoft-Support zu wenden, wenn bei Tests eine WARNUNG gemeldet wird.

  5. Wenn Sie vom Microsoft-Support angewiesen wurden, das Überprüfungstool auszuführen, fordert der Mitarbeiter des Microsoft-Supports die von Ihnen gesammelten Protokolle an, um die Behebung Ihres Problems fortsetzen zu können.

Verfügbare Tests

Mithilfe des Überprüfungstools können Sie eine Reihe von Tests auf Systemebene sowie grundlegende Cloudszenarien ausführen, die Ihnen einen Einblick in den aktuellen Status ermöglichen, um Probleme in Ihrem System zu beheben.

Tests der Cloudinfrastruktur

Diese Tests mit geringer Auswirkung arbeiten auf einer Infrastrukturebene und liefern Ihnen Informationen zu verschiedenen Systemkomponenten und -funktionen. Tests sind derzeit in die folgenden Kategorien gruppiert:

Testkategorie Argument für „-Include“ und „-Ignore“
Zusammenfassung des Azure Stack Hub ACS AzsAcsSummary
Azure Stack Hub-Aktionsplanstatus AzsActionPlanStatus
Integrität des Azure Stack Hub-Agents AzsAgentHealth
Zusammenfassung der Azure Stack AKS Arc-Vorschau AzsAksArcPreviewSummary
Zusammenfassung von Azure Stack Hub: Active Directory AzsAdSummary
Azure Stack Hub: Benachrichtigungszusammenfassung AzsAlertSummary
Zusammenfassung der Azure Stack Hub-Anwendungsabstürze AzsApplicationCrashSummary
Zusammenfassung der Verfügbarkeit von Azure Stack Hub-Sicherungsfreigaben AzsBackupShareAccessibility
Zusammenfassung der Azure Stack Hub-Steuerungsebene AzsControlPlane
Azure Stack Hub DCB-Validierung AzsDCBValidation
Zusammenfassung von Azure Stack Hub Defender AzsDefenderSummary
Azure Stack Hub ECE-Bereitstellungsstatus AzsEceProvisioningStatus
Azure Stack Hub: Übersicht über externe Zertifikate AzsExternalCertificates
Zusammenfassung der Azure Stack Hub-GPU-Konfiguration AzsGpuConfigurationSummary
Aktivieren des Azure Stack Hub-Hardwaremonitors AzsGpuConfigurationSummary
Zusammenfassung Hostinginfrastruktur-Firmware für Azure Stack Hub AzsHostingInfraFWSummary
Zusammenfassung der Azure Stack Hub-Hostinginfrastruktur AzsHostingInfraSummary
Nutzung der Azure Stack Hub-Hostinginfrastruktur AzsHostingInfraUtilization
Azure Stack Hub-Identitätsanbieterkonnektivität AzsIdentityProviderConnectivity
Status des Azure Stack Hub-Identitätsanbieters AzsIdentityProviderStatus
Kapazität der Azure Stack Hub-Infrastruktur AzsInfraCapacity
Überprüfung der Azure Stack Hub-Infrastrukturdatei AzsInfraFileValidation
Leistung der Azure Stack Hub-Infrastruktur AzsInfraPerformance
Zusammenfassung der Infrastrukturrolle von Azure Stack Hub AzsInfraRoleSummary
Azure Stack Hub Infrastructure Update Memory AzsInfraUpdateMemory
Zusammenfassung des Azure Stack Hub-Infrastrukturupdates AzsInfraUpdateSummary
Azure Stack Hub NCImos-Validierung AzsNCImosValidation
Azure Stack Hub-Netzwerkinfrastruktur AzsNetworkInfra
Azure Stack Hub-OEM-Hardware AzsOemHardware
Azure Stack Hub OEM-Updatevoraussetzungen AzsOemUpdatePrereqs
Zusammenfassung von Azure Stack Hub-Portal und API AzsPortalAPISummary
Azure Stack Hub RDMA-Betriebsstatus AzsRdmaOperationalStatus
Authentifizierungsstatus des Azure Stack Hub-Ressourcenanbieters AzsResourceProviderAuthStatus
VM-Ereignisse der Azure Stack Hub-Skalierungseinheit AzsScaleUnitEvents
VM-Ressourcen der Azure Stack Hub-Skalierungseinheit AzsScaleUnitResources
Azure Stack Hub-Szenarien AzsScenarios
Zusammenfassung der Azure Stack Hub Service Fabric-Rolle AzsSFRoleSummary
Azure Stack Hub SQL-Diagnose AzsSQLDiagnostics
Zusammenfassung von Azure Stack Hub-SQL AzsSQLSummary
Zusammenfassung des Azure Stack Hub-Stempels AzsStampBMCSummary
Azure Stack Hub-Speicherdatenebene AzsStorageDataPlane
Zusammenfassung der Azure Stack Hub-Speicherdienste AzsStorageSvcsSummary
Zusammenfassung des Azure Stack Hub-SQL-Stores AzsStoreSummary
Zusammenfassung der Azure Stack Hub-Nutzung AzsUsage
Zusammenfassung der Azure Stack Hub-Nutzungsbrücke AzsUsageBridgeSummary
Zusammenfassung der Azure Stack Hub-VM-Platzierung AzsVmPlacement

Cloudszenariotests

Zusätzlich zu den Infrastrukturtests im vorherigen Abschnitt können Sie auch Cloudszenariotests ausführen, um die Funktionalität zwischen Infrastrukturkomponenten zu überprüfen. Da in diesen Tests die Bereitstellung von Ressourcen enthalten ist, sind für deren Durchführung Anmeldeinformationen für Cloudadministratoren erforderlich.

Hinweis

Derzeit können Sie Cloudszenariotests nicht mit AD FS-Anmeldeinformationen (Active Directory Federation Services, Active Directory-Verbunddienste) durchführen.

Die folgenden Cloudszenarien werden durch das Überprüfungstool getestet:

  • Ressourcengruppenerstellung
  • Planerstellung
  • Angebotserstellung
  • Speicherkontoerstellung
  • Erstellung des virtuellen Computers (VM)
  • Speichervorgang für Blobs
  • Speichervorgang für Warteschlangen
  • Speichervorgang für Tabellen

Überlegungen zu Parametern

  • Der Parameter List kann verwendet werden, um alle verfügbaren Testkategorien anzuzeigen.

  • Die Parameter Include und Ignore können verwendet werden, um Testkategorien einzubeziehen bzw. auszuschließen. Weitere Informationen zu diesen Argumenten finden Sie im folgenden Abschnitt.

    Test-AzureStack -Include AzsSFRoleSummary, AzsInfraCapacity
    
    Test-AzureStack -Ignore AzsInfraPerformance
    
  • Eine Mandanten-VM wird im Rahmen eines Cloudszenariotests bereitgestellt. Sie können DoNotDeployTenantVm verwenden, um diese VM-Bereitstellung zu deaktivieren.

  • Sie müssen den Parameter ServiceAdminCredential angeben, um die Cloudszenariotests entsprechend der Beschreibung im Abschnitt Beispiele für Anwendungsfälle auszuführen.

  • BackupSharePath und BackupShareCredential werden beim Testen von Einstellungen für die Infrastruktursicherung verwendet, wie im Abschnitt Beispiele für Anwendungsfälle gezeigt wird.

  • DetailedResults kann verwendet werden, um Erfolgreich/Fehler/Warnung-Informationen für jeden Test und die Gesamtausführung zu erhalten. Wurde diese Option nicht angegeben, gibt Test-AzureStack$true zurück, wenn keine Fehler vorliegen, und $false, wenn Fehler aufgetreten sind.

  • TimeoutSeconds kann verwendet werden, um eine bestimmte Zeit für jede abzuschließende Gruppe festzulegen.

  • Das Überprüfungstool unterstützt auch gängige PowerShell-Parameter: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable und OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.

Beispiele für Anwendungsfälle

Ausführen der Überprüfung ohne Cloudszenarien

Führen Sie das Überprüfungstool ohne den Parameter ServiceAdminCredential aus, um die Ausführung von Cloudszenariotests zu überspringen:

New-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred -SessionOption (New-PSSessionOption -Culture en-US -UICulture en-US)
Test-AzureStack

Ausführen der Überprüfung mit Cloudszenarien

Wenn für das Überprüfungstool der Parameter ServiceAdminCredentials angegeben wird, werden standardmäßig die Cloudszenariotests ausgeführt:

Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred 
Test-AzureStack -ServiceAdminCredential "<Cloud administrator user name>" 

Wenn Sie NUR Cloudszenarien ausführen möchten, ohne die übrigen Tests auszuführen, können Sie dazu den Parameter Include verwenden:

Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred 
Test-AzureStack -ServiceAdminCredential "<Cloud administrator user name>" -Include AzsScenarios   

Der Benutzername des Cloudadministrators muss im UPN-Format serviceadmin@contoso.onmicrosoft.com (Microsoft Entra ID) eingegeben werden. Geben Sie bei Aufforderung das Kennwort für das Cloudadministratorkonto ein.

Gruppen

Um die Bedienerfreundlichkeit zu verbessern, wurde ein Parameter Gruppe eingeführt, um mehrere Testkategorien gleichzeitig auszuführen. Derzeit sind drei Gruppen definiert: Default, UpdateReadiness und SecretRotationReadiness.

  • Standard: Standardausführung von Test-AzureStack. Diese Gruppe wird standardmäßig ausgeführt, wenn keine anderen Gruppen ausgewählt werden.

  • UpdateReadiness: Hierbei wird überprüft, ob die Azure Stack Hub-Instanz aktualisiert werden kann. Wird die Gruppe UpdateReadiness ausgeführt, werden Warnungen als Fehler in der Konsolenausgabe angezeigt und sollten als Hindernisse für die Aktualisierung angesehen werden. Die folgenden Kategorien sind Teil der UpdateReadiness-Gruppe:

    • AzsInfraFileValidation
    • AzsActionPlanStatus
    • AzsStampBMCSummary
  • SecretRotationReadiness: Hierbei wird überprüft, ob sich die Azure Stack Hub-Instanz in einem Status befindet, in dem die Geheimnisrotation durchgeführt werden kann. Wird die Gruppe SecretRotationReadiness ausgeführt, werden Warnungen als Fehler in der Konsolenausgabe angezeigt und sollten als Hindernisse für die Geheimnisrotation angesehen werden. Die folgenden Kategorien sind Teil der SecretRotationReadiness-Gruppe:

    • AzsAcsSummary
    • AzsDefenderSummary
    • AzsHostingInfraSummary
    • AzsInfraCapacity
    • AzsInfraRoleSummary
    • AzsPortalAPISummary
    • AzsSFRoleSummary
    • AzsStorageSvcsSummary
    • AzsStoreSummary

Beispiel für Gruppenparameter

Im folgenden Beispiel wird Test-AzureStack ausgeführt, um die Systembereitschaft zu testen, bevor ein Update oder Hotfix mit Gruppe installiert wird. Führen Sie vor dem Starten einer Update- oder Hotfixinstallation Test-AzureStack aus, um den Status Ihrer Azure Stack Hub-Instanz zu überprüfen:

Test-AzureStack -Group UpdateReadiness

Ausführen des Überprüfungstools zum Testen der Einstellungen für die Infrastruktursicherung

Vor der Konfiguration der Infrastruktursicherung können Sie mit dem Test AzsBackupShareAccessibility den Sicherungsfreigabepfad und die Sicherungsanmeldeinformationen testen:

Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred 
Test-AzureStack -Include AzsBackupShareAccessibility -BackupSharePath "\\<fileserver>\<fileshare>" -BackupShareCredential $using:backupcred

Nach der Konfiguration der Sicherung können Sie AzsBackupShareAccessibility ausführen, um zu überprüfen, ob über das ERCS auf die Freigabe zugegriffen werden kann:

Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred 
Test-AzureStack -Include AzsBackupShareAccessibility

Um neue Anmeldeinformationen mit der konfigurierten Sicherungsfreigabe zu testen, führen Sie Folgendes aus:

Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred 
Test-AzureStack -Include AzsBackupShareAccessibility -BackupShareCredential "<PSCredential for backup share>"

Ausführen des Überprüfungstools zum Testen der Netzwerkinfrastruktur

Dieser Test überprüft die Konnektivität der Netzwerkinfrastruktur, indem er das softwaredefinierte Netzwerk (SDN) von Azure Stack Hub umgeht. Er veranschaulicht Verbindungen von einer öffentlichen VIP mit den konfigurierten DNS-Forwardern, NTP-Servern und Authentifizierungsendpunkten. Dies schließt die Konnektivität mit Azure ein, wenn Microsoft Entra ID als Identitätsanbieter oder der Verbundserver verwendet wird, wenn AD FS als Identitätsanbieter verwendet wird.

Schließen Sie den Debug-Parameter ein, um eine detaillierte Ausgabe des Befehls zu erhalten:

Test-AzureStack -Include AzsNetworkInfra -Debug

Nächste Schritte

Weitere Informationen zu Azure Stack Hub-Diagnosetools und zur Protokollierung von Problemen finden Sie unter Erfassung von Diagnoseprotokollen.

Weitere Informationen zur Problembehandlung finden Sie unter Problembehandlung von Microsoft Azure Stack Hub.