Beheben von Problemen in Windows Admin Center

Wenn Sie gerade erst ein neues Azure-Konto erstellt und sich auf Ihrem Gatewaycomputer nicht bei dem Konto angemeldet haben, können Probleme bei der Registrierung Ihres Windows Admin Center-Gateways bei Azure auftreten.

Um dieses Problem zu beheben, melden Sie sich auf einer anderen Browserregisterkarte oder einem anderen Browserfenster bei Ihrem Azure-Konto an, und registrieren Sie dann das Windows Admin Center-Gateway bei Azure.

Bei der Bereitstellung von Azure Kubernetes Service auf Azure Stack HCI über das Windows Admin Center kann nur der Benutzer, der den AKS-Host eingerichtet hat, Kubernetes-Cluster erstellen.

Um dieses Problem zu umgehen, kopieren Sie den Ordner wssd aus dem Profil des Benutzers, der den AKS-Host eingerichtet hat, in das Profil des Benutzers, der die neuen Kubernetes-Cluster erstellen wird.

Sie haben Probleme mit der Bereitstellung oder möchten Ihre Bereitstellung zurücksetzen.

Schließen Sie alle Windows Admin Center Instanzen, die mit Azure Kubernetes Service in Azure Stack HCI verbunden sind, bevor Sie Uninstall-AksHci über ein PowerShell-Verwaltungsfenster ausführen.

Möglicherweise erhalten Sie in beiden Assistenten einen Fehler bei einer falschen Konfiguration.

Führen Sie Clusterbereinigungsvorgänge aus. Diese Vorgänge können das Entfernen der Datei C:\Program Files\AksHci\mocctl.exe umfassen.

Es gibt Inkonsistenzen bei Netzwerkfeldnamen, die im Bereitstellungsflow des Hostclusters und des Workloadclusters angezeigt werden.

–

Sie erhalten diesen Fehler, wenn Sie Popupelemente deaktiviert haben. In Google Chrome werden Popupelemente standardmäßig blockiert, darunter auch das Popupfenster für die Azure-Anmeldung. Auf diese Weise wird der Fehler bei der Erstellung des Dienstprinzipals verursacht.

Aktivieren Sie Popups.

Beim Wechsel von DHCP zur statischen IP-Adresse hat das Windows Admin Center eine Fehlermeldung angezeigt, laut der der WinRM-Client die Anforderung nicht verarbeiten kann. Dieser Fehler trat auch außerhalb des Windows Admin Center auf. WinRM fiel aus, als statische IP-Adressen verwendet wurden und die Server haben bei der Umstellung auf statische IP-Adressen keinen Dienstprinzipalnamen (Service Principal Name, SPN) registriert.

Um dieses Problem zu behandeln, erstellen Sie mit dem Befehl SetSPN den SPN. Führen Sie den folgenden Befehl über eine Eingabeaufforderung des Windows Admin Center-Gateways aus:

Setspn /Q WSMAN/<FQDN on the Azure Stack HCI Server> 

Wenn nun einer der Server in der Umgebung die Nachricht No Such SPN Found zurückgibt, melden Sie sich bei diesem Server an und führen die folgenden Befehle aus:

Setspn /S WSMAN/<server name> <server name> 
Setspn /S WSMAN/<FQDN of server> <server name> 

Führen Sie schließlich über das Windows Admin Center-Gateway den folgenden Befehl aus, um sicherzustellen, dass es neue Serverinformationen vom Domänencontroller erhält:

Klist purge 

Wenn Sie die Benachrichtigung "AksHci PowerShell-Modulversion null erfolgreich installiert" erhalten, ist der Upgradevorgang erfolgreich, auch wenn die Benachrichtigung irreführend ist.

Sie können diese Meldung problemlos ignorieren.

In Phase 2.1: Basic Step Component tritt möglicherweise der folgende Fehler auf: "Fehler beim Herstellen einer Verbindung mit dem Remoteserver *** mit folgender Fehlermeldung: Der Zugriff wurde verweigert. Weitere Informationen finden Sie im about_Remote_Troubleshooting Hilfethema", wenn Sie versuchen, Ihre Anmeldeinformationen für Ihre Serverknoten zu verwenden.

Stellen Sie sicher, dass das hinzugefügte Konto/die hinzugefügten Anmeldeinformationen ein Administratorkonto auf dem Computer sind. Vergewissern Sie sich als Nächstes, dass „PSRemoting“ aktiviert ist und Remotehosts vertrauenswürdig sind. Verwenden Sie hierzu die folgenden PowerShell-Befehle:

Enable-PSRemoting -Force 
winrm quickconfig 

Wenn weiterhin Probleme auftreten, lesen Sie diesen Leitfaden zur Problembehandlung.

Windows Admin Center verfügt derzeit nicht über einen Prozess zum Offboarden eines Clusters aus Azure Arc.

Um Arc-Agents in einem zerstörten Cluster zu löschen, navigieren Sie im Azure-Portal zur Ressourcengruppe des Clusters, und löschen Sie den Arc-Inhalt manuell. Zum Löschen von Arc-Agents in einem Cluster, der weiterhin ausgeführt wird, sollten Sie den folgenden Befehl ausführen:

az connectedk8s delete --name AzureArcTest1 --resource-group AzureArcTest

Nach einem erfolgreichem Upgrade zeigt das Windows Admin Center-Updatedashboard weiterhin die vorherige Version an.

Aktualisieren Sie den Browser, um dieses Problem zu beheben.

Wenn Sie AKS Arc mithilfe von Windows Admin Center bereitstellen und die Bereitstellung über einen längeren Zeitraum unterbrochen wird, treten möglicherweise Credential Security Support Provider (CredSSP) oder Konnektivitätsprobleme auf.

Versuchen Sie die folgenden Schritte zur Problembehandlung für Ihre Bereitstellung:

1. Führen Sie auf dem Computer, auf dem Windows Admin Center ausgeführt wird, den folgenden Befehl in einem PowerShell-Fenster aus:

      Enter-PSSession <servername>
   

2. Wenn dieser Befehl erfolgreich ausgeführt wird, können Sie eine Verbindung mit dem Server herstellen, und es liegt kein Konnektivitätsproblem vor.

3. Wenn CredSSP-Probleme vorliegen, führen Sie den folgenden Befehl aus, um die Vertrauensstellung zwischen dem Gateway- und dem Zielcomputer zu testen:

      Enter-PSSession -ComputerName <server> -Credential company\administrator -Authentication CredSSP
   

   Sie können auch den folgenden Befehl ausführen, um die Vertrauensstellung beim Zugriff auf das lokale Gateway zu testen:

      Enter-PSSession -computer localhost -credential (Get-Credential)
   

Weitere Tipps zur CredSSP-Problembehandlung finden Sie unter Problembehandlung für CredSSP.

Manchmal treten aufgrund von Netzwerkproblemen Windows Admin Center während einer Arc-Verbindung ein Timeout auf.

Verwenden Sie den Enable-AksHciArcConnection-PowerShell-Befehl, um den AKS-Workloadcluster mit Azure Arc zu verbinden. Wir bemühen uns um eine dauerhafte Lösung dieses Problems.

In Phase 2.1: Systemvalidierung erhalten Sie möglicherweise eine Fehlermeldung: "Das Element 'Install-Module' wurde nicht als Name eines Cmdlets, einer Funktion, einer Skriptdatei oder eines ausgeführten Programms erkannt".

Überprüfen Sie die Schreibweise des Namens. Wenn der Pfad enthalten ist, stellen Sie sicher, dass der Pfad korrekt ist. Versuchen Sie es dann bei der Installation erneut. Führen Sie die PowerShell-Befehle auf den Knoten aus, auf denen Sie die Bereitstellung durchführen möchten. Führen Sie den folgenden Befehl aus, um das Problem zu beheben (stellen Sie sicher, dass Ihre PowerShell-Version mindestens 5.1 ist):

Install-Module -Name PowershellGet -Repository PSGallery -Force -Confirm:$false -SkipPublisherCheck

Sollten beim ersten Befehl Fehler aufgetreten sein, führen Sie die folgenden Befehle aus:

Get-PSRepository
Register-PSRepository -Default

Es kann keine Verbindung Windows Admin Center mit Azure hergestellt werden, da Sie nicht automatisch eine Azure-App-ID auf dem Gateway erstellen und verwenden können.

Erstellen Sie eine Azure-App-ID, und weisen Sie ihr die richtigen Berechtigungen für das Portal zu. Wählen Sie dann Vorhandene im Gateway verwenden aus. Weitere Informationen finden Sie unter Verbinden Ihres Gateways mit Azure.

Wenn Sie Workloadcluster mit Kubernetes-Version 1.19.9 installiert haben und sie dann mithilfe von Windows Admin Center auf Kubernetes Version 1.19.11 aktualisieren, wird auf der Kubernetes-Updateseite weiterhin angezeigt, dass das Update noch nicht abgeschlossen ist. Wenn Sie jedoch Get-AksHciCluster ausführen, wird in der Ausgabe angezeigt, dass das Update abgeschlossen ist, und wenn Sie Windows Admin Center auf einer neuen Registerkarte öffnen, ist der Cluster in der Liste der Kubernetes-Cluster auf 1.19.11 aktualisiert.

Sie können dieses Problem ignorieren, da der Updatevorgang tatsächlich abgeschlossen ist.

Wenn Sie Probleme mit dem Windows Admin Center melden, sollten Sie Protokolle anzufügen, damit das Entwicklungsteam Ihr Problem diagnostizieren kann. Fehler im Windows Admin Center treten in der Regel in einer dieser beiden Formen auf:

• Ereignisse, die in der Ereignisanzeige auf dem Computer angezeigt werden, auf dem Windows Admin Center ausgeführt wird
• JavaScript-Probleme, die in der Browserkonsole auftreten

Zum Sammeln von Protokollen für Windows Admin Center verwenden Sie das im Paket der öffentlichen Vorschau enthaltene Skript Get-SMEUILogs.ps1.

Um das Skript zu verwenden, führen Sie den folgenden Befehl in dem Ordner aus, in dem Ihr Skript gespeichert ist:

./Get-SMEUILogs.ps1 -ComputerNames [comp1, comp2, etc.] -Destination [comp3] -HoursAgo [48] -NoCredentialPrompt

Der Befehl hat die folgenden Parameter:

• -ComputerNames: Eine Liste der Computer, von denen Sie Protokolle erfassen möchten.
• -Destination: Der Computer, auf dem Sie die Protokolle aggregieren möchten.
• -HoursAgo: Die Startzeit für das Sammeln von Protokollen in Stunden vor dem Ausführen des Skripts.
• -NoCredentialPrompt: Ein Switch, mit dem Sie die Anmeldeinformationen deaktivieren und die Standardanmeldeinformationen in Ihrer aktuellen Umgebung verwenden können.

Wenn Sie Schwierigkeiten haben, dieses Skript auszuführen, können Sie den folgenden Befehl ausführen, um den Hilfetext anzuzeigen:

GetHelp .\Get-SMEUILogs.ps1 -Examples

Beim Ausführen eines Upgrades in Windows Admin Center ist der folgende Fehler aufgetreten:

Error occurred while fetching platform upgrade information. RemoteException: No match was found for the specified search criteria and module name 'AksHci'. Try Get-PSRepository to see all available registered module repositories.

Diese Fehlermeldung tritt in der Regel auf, wenn AKS in Azure Stack HCI in einer Umgebung bereitgestellt wird, in der ein Proxy konfiguriert ist. Derzeit bietet Windows Admin Center keine Unterstützung für die Installation von Modulen in einer Proxyumgebung.

Um diesen Fehler zu beheben, richten Sie AKS in Azure Stack HCI mithilfe des PowerShell-Proxybefehls ein.

Die Bereitstellung des AKS-Hostclusters schlägt bei Systemprüfungen mit einem Fehler des WinRM-Diensts fehl.

Versuchen Sie die unter Manuelle Problembehandlung vorgeschlagenen Lösungen anzuwenden.

Wenn Sie mehrere Versionen der PowerShell-Module installiert haben (z. B. 0.2.26, 0.2.27 und 0.2.28), verwendet das Windows Admin Center möglicherweise nicht die neueste Version (oder die Version, die es benötigt).

Stellen Sie sicher, dass Sie nur ein PowerShell-Modul installiert haben. Sie müssen alle nicht verwendeten PowerShell-Versionen der PowerShell-Module deinstallieren und nur eines installiert lassen. Weitere Informationen dazu, welche Windows Admin Center-Version mit welcher PowerShell-Version kompatibel ist, finden Sie in den Versionshinweisen zu AKS in Azure Stack HCI.

Dieser Fehler tritt bei der Bereitstellung über Windows Admin Center auf. Der Paketanbieter erfordert die Tags PackageManagement und Provider. Sie sollten überprüfen, ob beim Versuch einer Bereitstellung über Windows Admin Center ein Tagfehler für das angegebene Paket vorliegt.

Dieser Fehler stammt von PowerShell und gibt an, dass Probleme mit der Internetverbindung vorliegen. PowerShell versucht, das Erforderliche Paket zu installieren, und kann es nicht installieren.

Überprüfen Sie, ob der Server oder Failovercluster über Eine Internetverbindung verfügt, und starten Sie dann eine Neuinstallation.

In Phase 2.1: Systemvalidierung tritt möglicherweise ein Fehler auf, wenn Sie installieren: No match was found for the specified search criteria for the provider 'NuGet'. The package provider requires 'PackageManagement' and 'Provider' tags. Please check if the specified package has the tags. Schließen Sie die PowerShell-Befehle auf den Knoten ab, auf denen Sie die Bereitstellung durchführen möchten. Sie müssen nuGet mithilfe des folgenden PowerShell-Befehls manuell installieren:

Install-PackageProvider -Name NuGet -Scope CurrentUser -Force

Nachdem Sie diesen Befehl ausgeführt haben, schließen Sie alle geöffneten PowerShell-Fenster, und versuchen Sie es erneut in Windows Admin Center.

In Phase 2.1: Systemvalidierung tritt möglicherweise der folgende Fehler auf: "Repository 'PSGallery' konnte nicht gefunden werden.

Verwenden Sie Get-PSRepository, um alle verfügbaren Repositorys anzuzeigen.", wenn Sie auf Installieren klicken. Führen Sie die PowerShell-Befehle auf den Knoten aus, auf denen Sie die Bereitstellung durchführen möchten. Heben Sie die Registrierung von PSRepository auf, und registrieren Sie es erneut in einem PowerShell-Verwaltungsfenster. Schließen Sie danach alle PowerShell-Fenster.

Unregister-PSRepository -Name 'PSGallery'
Register-PSRepository -Default

Deinstallieren Sie dann PowerShellGet, und installieren Sie es in einem PowerShell-Verwaltungsfenster neu. Schließen Sie danach alle PowerShell-Fenster.

Uninstall-Module PowerShellGet
Install-Module PowerShellGet -Force

Wechseln Sie danach zurück zu Windows Admin Center, und wiederholen Sie den Vorgang.

Wenn Sie Windows Admin Center mit einem Konto installieren und versuchen, es mit einem anderen Konto zu verwenden, treten Fehler auf.

Damit CredSSP innerhalb des Assistenten zum Erstellen von Clustern erfolgreich funktioniert, muss Windows Admin Center installiert sein und von demselben Konto verwendet werden.

Dieser Fehler wird angezeigt, wenn Sie von PowerShell zu Windows Admin Center wechseln, um einen Arc-fähigen Workloadcluster zu erstellen.

Sie können diesen Fehler gefahrlos ignorieren. Er ist Teil des Validierungsschritts, und der Cluster wurde bereits erstellt.

Ein Neustart der Azure Stack HCI-Clusterknoten, auf denen der Verwaltungscluster und die Workloadcluster gehostet werden, kann dazu führen, dass die Workloadcluster aus dem Windows Admin Center Dashboard verschwinden.

Um dieses Problem zu umgehen, halten Sie die Knoten an, und entladen Sie sie, bevor Sie sie neu starten. Mitunter dauert es einfach länger, bis die Workloadcluster im Dashboard angezeigt werden.

Windows Admin Center stellt Azure Kubernetes Service nicht in einer Umgebung mit separaten Speicher- und Computeclustern bereit, da es erwartet, dass die Compute- und Speicherressourcen vom selben Cluster bereitgestellt werden. In den meisten Fällen findet es keine CSV-Dateien, die vom Computecluster verfügbar gemacht werden, und weigert sich, die Bereitstellung fortzusetzen.

Nächste Schritte

• Problembehandlung: Übersicht, Feedback und Support
• Installationsprobleme und -fehler
• Bekannte Aktualisierungsprobleme

Wenn bei der Verwendung von AKS Arc weiterhin Probleme auftreten, können Sie Fehler über GitHub erstellen.