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 in einem anderen Browserfenster bei Ihrem Azure-Konto an, und registrieren Sie dann das Windows Admin Center-Gateway bei Azure.

Beim Bereitstellen von Azure Kubernetes Service auf Azure Local über 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.

Es treten Bereitstellungsprobleme auf, oder Sie möchten Ihre Bereitstellung zurücksetzen.

Schließen Sie alle Windows Admin Center-Instanzen, die mit Azure Kubernetes Service auf Azure Local verbunden sind, bevor Sie "Uninstall-AksHci" aus einem PowerShell-Verwaltungsfenster ausführen.

Möglicherweise wird in beiden Assistenten eine Fehlermeldung zu einer falschen Konfiguration angezeigt.

Durchführen von Clusterbereinigungsvorgängen. Bei diesen Vorgängen kann es sich um das Entfernen der Datei "C:\Programme\AksHci\mocctl.exe " handeln.

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

N/V

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.

Popups aktivieren.

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 Local machine> 

Wenn eine der Computer in der Umgebung die Nachricht No Such SPN Foundzurückgibt, melden Sie sich dann bei diesem Computer an, und führen Sie die folgenden Befehle aus:

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

Führen Sie schließlich im Windows Admin Center-Gateway Folgendes aus, um sicherzustellen, dass neue Computerinformationen vom Domänencontroller abgerufen werden:

Klist purge 

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

Sie können diese Nachricht sicher ignorieren.

In Phase 2.1: Grundlegende Schrittkomponente kann dieser Fehler auftreten: "Verbindung mit Remoteserver *** fehlgeschlagen mit der folgenden Fehlermeldung: Access wird 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 ist. 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 dieses Handbuch zur Problembehandlung.

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

Um Arc-Agents auf einem zerstörten Cluster zu löschen, navigieren Sie zur Ressourcengruppe des Clusters im Azure-Portal, 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 für einen längeren Zeitraum hängen bleibt, besteht möglicherweise ein Credential Security Support Provider (CredSSP) oder Konnektivitätsprobleme.

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 ist aufgrund von Netzwerkproblemen windows Admin Center während einer Arc-Verbindung nicht mehr verfügbar.

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: Systemüberprüfung wird möglicherweise eine Fehlermeldung angezeigt: "Das Element 'Install-Module' wurde nicht als Name eines Cmdlets, einer Funktion, einer Skriptdatei oder eines runnablen 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 erneut, wenn Sie es installieren. Schließen Sie die PowerShell-Befehle auf den Knoten ab, für die Sie bereitstellen möchten. Führen Sie den folgenden Befehl aus, um das Problem zu beheben (stellen Sie sicher, dass Ihre PowerShell-Version mindestens 5.1 beträgt):

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

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

Erstellen Sie eine Azure-App-ID, und weisen Sie sie den 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, aus der Sie Protokolle sammeln möchten.
• -Destination: Der Computer, auf dem die Protokolle aggregiert werden sollen.
• -HoursAgo: Die Startzeit für das Sammeln von Protokollen, ausgedrückt in Stunden vor der Ausführung des Skripts.
• -NoCredentialPrompt: Eine Option zum Deaktivieren der Anmeldeinformationenaufforderung und Verwenden der Standardanmeldeinformationen in Ihrer aktuellen Umgebung.

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 auf Azure Local in einer Umgebung bereitgestellt wird, die einen Proxy konfiguriert hat. 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 auf Azure Local mithilfe des Proxy-PowerShell-Befehls 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 AKS in den Versionshinweisen zu Azure Local.

Dieser Fehler tritt bei der Bereitstellung über Windows Admin Center auf. Der Paketanbieter erfordert die Tags PackageManagement und Provider. Überprüfen Sie, ob das angegebene Paket einen Tagfehler aufweist, wenn Sie eine Bereitstellung über Windows Admin Center versuchen.

Dieser Fehler stammt aus PowerShell und gibt an, dass Es Probleme mit der Internetverbindung gibt. 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: Systemüberprüfung tritt möglicherweise ein Fehler auf, wenn Sie auf die Installation klicken: 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, für die Sie bereitstellen möchten. Sie müssen nuGet manuell mit dem folgenden PowerShell-Befehl installieren:

Install-PackageProvider -Name NuGet -Scope CurrentUser -Force

Schließen Sie nach dem Ausführen dieses Befehls alle geöffneten PowerShell-Fenster, und versuchen Sie es erneut in Windows Admin Center.

In Phase 2.1: Systemüberprüfung kann dieser Fehler auftreten: 'Repository 'PSGallery' konnte nicht gefunden werden.

Verwenden Sie Get-PSRepository, um alle verfügbaren Repositorys anzuzeigen.", wenn Sie auf "Installieren" klicken. Schließen Sie die PowerShell-Befehle auf den Knoten ab, für die Sie bereitstellen möchten. Heben Sie die Registrierung auf, und registrieren Sie die PSRepository in einem administrativen PowerShell-Fenster. Schließen Sie danach alle PowerShell-Fenster.

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

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

Uninstall-Module PowerShellGet
Install-Module PowerShellGet -Force

Wechseln Sie danach zurück zum 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. Sie ist Teil des Überprüfungsschritts, und der Cluster wurde bereits erstellt.

Das Neustarten der lokalen Azure-Clusterknoten, die den Verwaltungscluster und Workloadcluster hosten, 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 weiterhin Probleme auftreten, wenn Sie AKS Arc verwenden, können Sie Fehler über GitHub ablegen.