Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gilt für: Azure Local 2311.2 und höher
Dieser Artikel enthält Informationen zum Download und zur Verwendung des Azure Local Support Diagnostic Tool. Das Tool besteht aus einer Reihe von PowerShell-Befehlen zur Vereinfachung der Datenerfassung, der Fehlersuche und der Behebung häufiger Probleme.
Dieses Tool ist kein Ersatz für Expertenwissen. Sollten Sie Probleme haben, wenden Sie sich bitte an den Microsoft-Support, um Hilfe zu erhalten.
Vorteile
Das Azure Local Support Diagnostic Tool verwendet einfache Befehle, um Probleme zu identifizieren, ohne dass Sie über Produktkenntnisse verfügen müssen.
Das Tool bietet:
Einfache Installation und Updates: Installieren und aktualisieren Sie nativ mit der PowerShell-Galerie, ohne zusätzliche Anforderungen.
Diagnoseprüfungen: Bietet Diagnoseprüfungen auf der Grundlage von allgemeinen Problemen, Vorfällen und Telemetriedaten.
Automatische Datensammlung: Sammelt automatisch wichtige Daten, die Sie dem Microsoft-Support zur Verfügung stellen können.
Regelmäßige Updates: Updates mit neuen Prüfungen und nützlichen Befehlen zur Verwaltung, Problembehandlung und Diagnose von Problemen auf Azure Local.
Voraussetzungen
Bevor Sie das PowerShell-Modul verwenden:
Stellen Sie sicher, dass Sie ein Konto verwenden, das über Administratorzugriff auf die lokalen Azure-Computer verfügt.
Stellen Sie sicher, dass PSRemoting auf den lokalen Azure-Computern konfiguriert ist. Führen Sie
Enable-PSRemotingaus, um Remote PowerShell zu konfigurieren. Weitere Informationen finden Sie in der Referenzdokumentation Enable-PSRemoting .
Installieren oder Aktualisieren des Azure Local Support Diagnostic Tools
Starten Sie PowerShell als Administrator und führen Sie dann die folgenden Befehle aus:
Führen Sie den folgenden Befehl zum Installieren des Tools aus:
Install-Module –Name Microsoft.AzureStack.HCI.CSSTools
Wenn Sie das Modul bereits installiert haben, können Sie mit dem folgenden Cmdlet aktualisieren:
Update-Module -Name Microsoft.AzureStack.HCI.CSSTools
Hinweis
Wenn Sie das Modul importieren, versucht es, automatisch aus der PowerShell-Galerie zu aktualisieren. Sie können auch mithilfe der nachstehenden Methoden manuell aktualisieren.
Stellen Sie sicher, dass das neueste Modul in den aktuellen Runspace geladen ist, indem Sie das Modul entfernen und importieren.
Remove-Module -Name Microsoft.AzureStack.HCI.CSSTools
Import-Module -Name Microsoft.AzureStack.HCI.CSSTools
Hinweis
Stellen Sie sicher, dass alle Computer in Azure Local aktualisiert wurden, um dieselbe Version zu verwenden. Entfernen Sie vorhandene PSSessions, um sicherzustellen, dass die richtige Modulversion in den Remote-Runspace geladen wird.
Verwenden des Diagnosetools für den lokalen Azure-Support
Dieser Abschnitt enthält verschiedene Cmdlets für die Verwendung des Azure Local Support Diagnostic Tools.
Verfügbare Cmdlets anzeigen
Führen Sie das folgende Cmdlet aus, um eine Liste der verfügbaren Cmdlets im PowerShell-Modul anzuzeigen:
Get-Command -Module Microsoft.AzureStack.HCI.CSSTools
Ausführen von Diagnoseüberprüfungen
Sie können eine Systemdiagnose am System durchführen, um häufige Probleme zu erkennen. Die folgenden Komponenten sind verfügbar:
- BaseSystem
- Registrierung
Invoke-AzsSupportDiagnosticCheck -Component <Component>
Sammeln von Daten für Support
Führen Sie den folgenden Befehl aus, um Daten mithilfe eines unserer vordefinierten Sammlungssätze zu sammeln:
New-AzsSupportDataBundle –Component <Component>Um alle Datensammlungen zu prüfen, drücken Sie
CTRL+SPACEnach dem ParameterComponent.Um Ihren eigenen Datensatz zu sammeln, führen Sie den folgenden Befehl aus:
$ClusterCommands = @(<clusterCommand1>,<clusterCommand2>) $nodeCommands = @(<nodeCommand1>,<nodeCommand2>) $nodeEvents = @(<eventLogName1>,<eventLogName2>) $nodeRegistry = @(<registryPath1>,<registryPath2>) $nodeFolders = @(<folderPath1>,<folderPath2>) New-AzsSupportDataBundle -ClusterCommands $clusterCommands ` -NodeCommands $nodeCommands ` -NodeEvents $nodeEvents ` -NodeRegistry $nodeRegistry ` -NodeFolders $nodeFolders ` -ComputerName @(<computerName1>,<computerName2>)
Beispielszenarien
Zur Fehlersuche bei Azure Local führen Sie die folgenden Befehle aus:
Bei Bereitstellungsproblemen
Um einen detaillierten Bericht über Ihre Bereitstellung zu erstellen, einschließlich erfolgreich ausgeführter Schritte, übersprungener Schritte und Fehlerdetails, führen Sie den folgenden Befehl aus:
Get-AzsSupportEceDeploymentDetails
Bei Update- oder Upgradeproblemen
Get-AzsSupportEceUpdateDetails
Für Speicherprobleme
Start-AzsSupportStorageDiagnostic
Vollständige Anleitungen zur Problembehandlung für speicherbezogene Probleme finden Sie unter "Troubleshooting-Storage-With-Support-Diagnostics-Tool".
Für Fragen zur Registrierung
Invoke-AzsSupportDiagnosticCheck -Component Registration
Hier ist ein Beispielergebnis für ein Registrierungsproblem:
PS C:\temp> Invoke-AzsSupportDiagnosticCheck -Component Registration
Starting known issue check for Azure Stack HCI: Registration.
Starting Azure Stack HCI base system validation.
Gathering information from all clustered nodes.
We are preparing to collect diagnostic information from your environment
We started the diagnostic data collection! This might take some time.
Finished collecting diagnostic information.
====[ Validating registration state on node: HCI-N-1 ]====
[Pass] [Azure Stack HCI - General registration state]
Validate that the cluster is registered
Details: Validation successfull
[Fail] [Azure Stack HCI - Azure Connection state]
Validate that the cluster is in a connected state
Details: This Azure Stack HCI node does not seem to be connected to azure. Ensure that this node is in a connected state.
Documentation: https://learn.microsoft.com/azure-stack/hci/deploy/troubleshoot-hci-registration.
[Pass] [Azure Arc Agent - Connection state]
Validate that the azure arc agent is connected
Details: Validation successfull
[Pass] [Azure Arc Agent - Service state]
Validate that all azure arc services are running
Details: Validation successfull
[Pass] [Azure Arc Agent - Heartbeat state]
Validate that the azure arc agent has sent out a heartbeat at least a day ago
Details: Validation successfull
[Pass] [Azure Stack HCI - Arc Agent onboarded]
Validate that all arc agent checks are passed
Details: Validation successfull
[Fail] [Validation summary]
Details: At least one node reported an invalid registration state.
We will collect log information from your envirorment.
Creating local storage container for diagnostic data.
Gathering cluster data ... this might take a while.
Cluster data collection complete.
We are preparing to collect diagnostic information from your environment
We started the diagnostic data collection! This might take some time.
Waiting for all diagnostic output to be generated and compressed ... this might take a while.
Finished collecting diagnostic information.
Starting copy of items ... this might take a while.
All items copied.
Successfully created archive C:\temp\6c5a4685-6e32-4b68-aeec-05475f8d6c6f\log-collection-RegistrationInformation07-22_06-03-2024.zip. Removing raw data C:\temp\6c5a4685-6e32-4b68-aeec-05475f8d6c6f\container.
Data collection done . Please upload the file to the Microsoft Workspace.
Bei grundlegenden Problemen mit dem Azure Local-System
Invoke-AzsSupportDiagnosticCheck -Component BaseSystem
Hier ist eine Beispielausgabe für Basissystemprobleme:
PS C:\temp> Invoke-AzsSupportDiagnosticCheck -Component BaseSystem
Starting known issue check for Azure Stack HCI: BaseSystem.
Gathering information from all clustered nodes.
We are preparing to collect diagnostic information from your environment
We started the diagnostic data collection! This might take some time.
Starting to validate cluster settings.
[Pass] [Failover Clustering - Cluster validation report contains no errors]
Validate that there are no critical errors in the cluster validation report
Details: Validation successfull
[Pass] [Failover Clustering - Cluster Networks have redundancy]
Validate that we have redundancy in clustered networks
Details: Validation successfull
[Pass] [Failover Clustering - Validation Summary]
Validate that there are no critical issues in our cluster validation report.
Details: Validation successfull
Collecting node data.
Finished collecting diagnostic information.
====[ Validating data from node: HCI-N-1 ]====
[Pass] [Windows Features - All windows features installed]
Verify that all features required for Azure Local are installed.
Details: Validation successfull
[Pass] [Validation summary]
Ensure that no other check has returned a failed state
Details: Validation successfull
Anschließend wird ein umfassender Überblick über die verschiedenen Komponenten erstellt, die für ordnungsgemäß verbundene Azure Local-Systeme erforderlich sind. Auf der Grundlage dieser Übersicht können Sie entweder den Anleitungen zur Problembehandlung folgen oder sich an den Microsoft-Support wenden, um Hilfe zu erhalten.
Um Daten zu sammeln, sehen Sie sich die folgenden zwei Beispielszenarien an:
Für die automatische Datenerfassung
New-AzsSupportDataBundle -Component OS
==== CUT ==================== CUT =======
Data collection done C:\temp\Azs.Support\XXXXXXX\SupportDataBundle-XX-XX_XX-XX-XXXX.zip . Please upload the file to the Microsoft Workspace
Für die manuelle Datenerfassung
$ClusterCommands = @()
$nodeCommands = @('Get-AzureStackHci','Get-AzureStackHCIArcIntegration','Get-ClusteredScheduledTask | fl *','systeminfo.exe')
$nodeEvents = @('system','application','Microsoft-AzureStack-HCI/Admin')
$nodeRegistry = @('HKLM:\Cluster\ArcForServers')
$nodeFolders = @('C:\Windows\Tasks\ArcforServers\','C:\ProgramData\AzureConnectedMachineAgent\Log\')
New-AzsSupportDataBundle -ClusterCommands $clusterCommands `
-NodeCommands $nodeCommands `
-NodeEvents $nodeEvents `
-NodeRegistry $nodeRegistry `
-NodeFolders $nodeFolders `
-ComputerName (Get-ClusterNode)
==== CUT ==================== CUT =======
Data collection done C:\temp\Azs.Support\XXXXXXX\SupportDataBundle-XX-XX_XX-XX-XXXX.zip . Please upload the file to the Microsoft Workspace.
Fragen oder Feedback?
Haben Sie ein Problem? Möchten Sie uns Ihr Feedback zum Azure Local Support Diagnostic Tool mitteilen? Wir hören zu! Wenn Sie uns Feedback geben möchten, wenden Sie sich an azlocaldiagfeedback@microsoft.com.
Nächste Schritte
Verwandte Informationen finden Sie außerdem unter: