Freigeben über

Behandeln häufiger Probleme mit dem Azure Virtual Desktop-Agent

  • Artikel

Der Azure Virtual Desktop-Agent kann aufgrund verschiedener Faktoren Verbindungsprobleme verursachen:

  • Ein Fehler im Broker, der dazu führt, dass der Agent den Dienst beendet.
  • Probleme bei Updates.
  • Probleme bei der Installation während der Agent-Installation, wodurch die Verbindung mit dem Sitzungshost unterbrochen wird.

In diesem Artikel werden Lösungen für diese gängigen Szenarien vorgestellt, und Sie erfahren, wie Sie Verbindungsprobleme beheben können.

Hinweis

Zum Beheben von Problemen mit der Sitzungskonnektivität und dem Azure Virtual Desktop-Agent empfiehlt es sich, die Ereignisprotokolle auf den Sitzungshost-VMs unter Ereignisanzeige>Windows-Protokolle>Anwendung zu untersuchen. Suchen Sie nach Ereignissen mit einer der folgenden Quellen, um Ihr Problem zu identifizieren:

  • WVD-Agent
  • WVD-Agent-Updater
  • RDAgentBootLoader
  • MsiInstaller

Error: Die Ausführung von RDAgentBootLoader und/oder Remote Desktop Agent Loader wurde beendet

Wenn eines der folgenden Probleme auftritt, bedeutet dies, dass das Startladeprogramm, das den Agent lädt, den Agent nicht ordnungsgemäß installieren konnte und der Agentdienst nicht auf Ihrer Sitzungshost-VM ausgeführt wird:

  • RDAgentBootLoader wurde beendet oder wird nicht ausgeführt.
  • Für Remote Desktop Agent Loader ist kein Status vorhanden.

Zum Beheben dieses Problems starten Sie den RDAgent-Bootloader:

  1. Klicken Sie im Fenster "Dienste" mit der rechten Maustaste auf das Remotedesktop-Agent-Ladeprogramm.
  2. Wählen Sie Starten aus. Wenn diese Option abgeblentet ist, verfügen Sie nicht über Administratorberechtigungen. Sie müssen diese Berechtigungen abrufen, um den Dienst zu starten.
  3. Warten Sie 10 Sekunden, und klicken Sie dann mit der rechten Maustaste auf das Remotedesktop-Agent-Ladeprogramm.
  4. Klicken Sie auf Aktualisieren.
  5. Wenn der Dienst nach dem Starten und Aktualisieren beendet wird, tritt möglicherweise ein Registrierungsfehler auf. Weitere Informationen finden Sie unter INVALID_REGISTRATION_TOKEN or EXPIRED_MACHINE_TOKEN.

Fehler: INVALID_REGISTRATION_TOKEN oder EXPIRED_MACHINE_TOKEN

Wechseln Sie auf der Sitzungshost-VM zu Ereignisanzeige>Windows-Protokolle>Anwendung. Wenn ein Ereignis mit der ID 3277 und der Beschreibung INVALID_REGISTRATION_TOKEN oder EXPIRED_MACHINE_TOKEN angezeigt wird, wird der verwendete Registrierungsschlüssel nicht als gültig erkannt.

So beheben Sie dieses Problem:

  1. Erstellen Sie einen neuen Registrierungsschlüssel, indem Sie die Schritte unter Generieren eines Registrierungsschlüssels ausführen.

  2. Öffnen Sie eine PowerShell-Eingabeaufforderung als Administrator, und führen Sie die folgenden Cmdlets aus, um der Registrierung den neuen Registrierungsschlüssel hinzuzufügen. Ersetzen Sie <RegistrationToken> durch das neue Registrierungstoken, das Sie generiert haben.

    $newKey = '<RegistrationToken>'

Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\RDInfraAgent" -Name "IsRegistered" -Value 0 -Force
Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\RDInfraAgent" -Name "RegistrationToken" -Value $newKey -Force

  3. Führen Sie das folgende Cmdlet aus, um den RDAgentBootLoader-Dienst neu zu starten:

    Restart-Service RDAgentBootLoader

  4. Führen Sie die folgenden Cmdlets aus, um zu überprüfen, ob IsRegistered sie auf 1 "Leer" festgelegt ist.RegistrationToken

    Get-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\RDInfraAgent" -Name IsRegistered | FL IsRegistered
Get-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\RDInfraAgent" -Name RegistrationToken | FL RegistrationToken

    Die Ausgabe sollte in etwa wie folgt aussehen:

    IsRegistered : 1

RegistrationToken :

  5. Überprüfen Sie, ob Ihr Sitzungshost im Hostpool verfügbar ist. Wenn er nicht verfügbar ist, zeigen Sie die Einträge in der Ereignisanzeige an, und überprüfen Sie, ob Fehler vorhanden sind, die das Starten des Agents verhindern.

Fehler: Agent kann keine Verbindung mit Broker herstellen: INVALID_FORM

Wechseln Sie auf der Sitzungshost-VM zu Ereignisanzeige>Windows-Protokolle>Anwendung. Wenn in der Beschreibung ein Ereignis mit der ID 3277 angezeigt INVALID_FORM wird, kann der Agent keine Verbindung mit dem Broker herstellen oder einen bestimmten Endpunkt erreichen. Dieses Problem kann durch bestimmte Firewall- oder DNS-Einstellungen verursacht werden.

Um dieses Problem zu beheben, überprüfen Sie, ob Sie die beiden Endpunkte erreichen können, die als BrokerResourceIdURI "und BrokerResourceIdURIGlobal" bezeichnet werden:

  1. Öffnen Sie den Registrierungs-Editor.

  2. Wechseln Sie zu HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\RDInfraAgent.

  3. Notieren Sie sich die Werte für BrokerResourceIdURI und BrokerResourceIdURIGlobal.

  4. Öffnen Sie einen Webbrowser, geben Sie Ihren Wert BrokerResourceIdURI in die Adressleiste ein, und fügen Sie "/api/health " am Ende hinzu, https://rdbroker-g-us-r0.wvd.microsoft.com/api/healthz. B. . .

  5. Öffnen Sie eine weitere Registerkarte im Browser, geben Sie Ihren Wert BrokerResourceIdURIGlobal in die Adressleiste ein, und fügen Sie am Ende "/api/health " hinzu, https://rdbroker.wvd.microsoft.com/api/healthz. B. .

  6. Wenn das Netzwerk die Verbindung zum Broker nicht blockiert, werden beide Seiten erfolgreich geladen. In der Meldung RD Broker is Healthy wird mitgeteilt, dass der RD-Broker fehlerfrei ist, wie in den folgenden Screenshots gezeigt:

    Screenshot des erfolgreich geladenen Broker-URI-Zugriffs.

    Screenshot des erfolgreich geladenen globalen Broker-URI-Zugriffs.

  7. Wenn das Netzwerk die Brokerverbindung blockiert, werden die Seiten nicht geladen, wie im folgenden Screenshot gezeigt.

    Screenshot des nicht erfolgreichen geladenen Brokerzugriffs.

    Screenshot des nicht erfolgreichen, geladenen Brokers für den globalen Zugriff.

    Sie müssen die Blockierung der erforderlichen Endpunkte aufheben und dann die Schritte 4 bis 7 wiederholen. Weitere Informationen finden Sie unter Liste der erforderlichen URLs.

  8. Wenn Das Problem durch Ausführen der vorherigen Schritte nicht behoben wird, stellen Sie sicher, dass Sie keine Gruppenrichtlinien mit Verschlüsselungen haben, die den Agent zur Brokerverbindung blockieren. Azure Virtual Desktop verwendet dasselbe TLS 1.2-Verschlüsselungsverfahren wie Azure Front Door. Weitere Informationen finden Sie unter Verbindungssicherheit.

Fehler: 3703

Wechseln Sie auf der Sitzungshost-VM zu Ereignisanzeige>Windows-Protokolle>Anwendung. Wenn in der Beschreibung ein Ereignis mit der ID 3703 RD Gateway Url: is not accessible angezeigt wird, kann der Agent die Gateway-URLs nicht erreichen. Um eine Verbindung mit Ihrem Sitzungshost herzustellen, müssen Sie Netzwerkdatenverkehr zu den URLs in der Liste der erforderlichen URLs zulassen. Stellen Sie auch sicher, dass Ihre Firewall- oder Proxyeinstellungen diese URLs nicht blockieren. Damit Azure Virtual Desktop verwendet werden kann, muss die Blockierung dieser URLs aufgehoben werden.

Überprüfen Sie zur Problemlösung, ob Sie auf die erforderlichen URLs zugreifen können, indem Sie das Tool zur Überprüfung einer erforderlichen URL ausführen. Wenn Sie Azure Firewall verwenden, lesen Sie "Verwenden der Azure Firewall" zum Schutz von Azure Virtual Desktop-Bereitstellungen und Azure Firewall-DNS-Einstellungen, um weitere Informationen zur Konfiguration für Azure Virtual Desktop zu finden.

Fehler: 3019

Wechseln Sie auf der Sitzungshost-VM zu Ereignisanzeige>Windows-Protokolle>Anwendung. Wenn ein Ereignis mit DER ID 3019 angezeigt wird, kann der Agent die Websocket-Transport-URLs nicht erreichen. Heben Sie die Blockierung der URLs in der Liste der erforderlichen URLs auf, um erfolgreich eine Verbindung mit Ihrem Sitzungshost herzustellen und zuzulassen, dass Netzwerkdatenverkehr Einschränkungen umgeht. Arbeiten Sie mit dem Netzwerkteam zusammen, um sicherzustellen, dass Firewall-, Proxy- und DNS-Einstellungen diese URLs nicht blockieren. Sie können auch Ihre Netzwerk-Ablaufverfolgungsprotokolle prüfen, um zu ermitteln, wo der Azure Virtual Desktop-Dienst blockiert wird. Wenn Sie einen Microsoft-Support-Fall zu diesem Problem eröffnen, fügen Sie die Netzwerk-Ablaufverfolgungsprotokolle unbedingt an die Anfrage an.

Fehler: InstallationHealthCheckFailedException

Wechseln Sie auf der Sitzungshost-VM zu Ereignisanzeige>Windows-Protokolle>Anwendung. Wenn in der Beschreibung ein Ereignis mit ID 3277 angezeigt InstallationHealthCheckFailedException wird, funktioniert der Stapellistener nicht, da der Terminalserver den Registrierungsschlüssel für den Stapellistener umgeschaltet hat.

So beheben Sie dieses Problem:

  1. Überprüfen Sie, ob der Stapellistener funktioniert.
  2. Wenn der Listener nicht funktioniert, deinstallieren Sie die Stapelkomponente manuell, und installieren Sie sie neu.

Fehler: ENDPOINT_NOT_FOUND

Wechseln Sie auf der Sitzungshost-VM zu Ereignisanzeige>Windows-Protokolle>Anwendung. Wenn in der Beschreibung ein Ereignis mit der ID 3277 angezeigt ENDPOINT_NOT_FOUND wird, konnte der Broker keinen Endpunkt finden, mit dem eine Verbindung hergestellt werden kann. Dieses Verbindungsproblem kann aus einem der folgenden Gründe auftreten:

  • In Ihrem Hostpool sind keine Sitzungshost-VMs vorhanden.
  • Die Sitzungshost-VMs in Ihrem Hostpool sind nicht aktiv.
  • Alle Sitzungshost-VMs in Ihrem Hostpool haben den maximalen Sitzungsgrenzwert überschritten.
  • Keiner der virtuellen Computer in Ihrem Hostpool verfügt über den Agentdienst, der auf ihnen ausgeführt wird.

So beheben Sie dieses Problem:

  1. Stellen Sie sicher, dass die VM eingeschaltet ist und nicht aus dem Hostpool entfernt wurde.
  2. Stellen Sie sicher, dass der virtuelle Computer das maximale Sitzungslimit nicht überschritten hat.
  3. Stellen Sie sicher, dass der Agent-Dienst ausgeführt wird und der Stapellistener funktioniert.
  4. Stellen Sie sicher, dass der Agent eine Verbindung mit dem Broker herstellen kann.
  5. Stellen Sie sicher, dass Ihre VM über ein gültiges Registrierungstoken verfügt.
  6. Stellen Sie sicher, dass das Registrierungstoken der VM nicht abgelaufen ist.

Error: InstallMsiException

Wechseln Sie auf der Sitzungshost-VM zu Ereignisanzeige>Windows-Protokolle>Anwendung. Wenn in der Beschreibung ein Ereignis mit der ID 3277 angezeigt InstallMsiException wird, wird das Installationsprogramm bereits für eine andere Anwendung ausgeführt, während Sie versuchen, den Agent zu installieren, oder die Gruppenrichtlinie blockiert , msiexec.exe nicht ausgeführt werden.

So überprüfen Sie, ob gruppenrichtlinien die Ausführung msiexec.exe blockieren:

  1. Öffnen Sie den Ergebnissatz der Richtlinie, indem Sie "rsop.msc" über eine Eingabeaufforderung mit erhöhten Rechten ausführen.

  2. Wechseln Sie im Popupfenster "Ergebnissatz" zu "Administrative Vorlagen>für die Computerkonfiguration>" windows-Komponenten>, die Windows Installer> deaktivieren. Wenn der Status aktiviert ist, arbeiten Sie mit Ihrem Active Directory-Team zusammen, um die Ausführung von msiexec.exe zuzulassen.

    Screenshot der Windows Installer-Richtlinie in Resultsant Set of Policy.

    Notiz

    Dies ist keine vollständige Liste aller Richtlinien, es werden nur diejenigen aufgeführt, die uns derzeit bekannt sind.

Error: Win32Exception

Wechseln Sie auf der Sitzungshost-VM zu Ereignisanzeige>Windows-Protokolle>Anwendung. Wenn in der Beschreibung ein Ereignis mit der ID 3277 angezeigt InstallMsiException wird, blockiert eine Richtlinie den Start cmd.exe . Wenn dieses Programm blockiert ist, können Sie das Konsolenfenster nicht ausführen, das Sie benötigen, um den Dienst nach einem Agent-Update neu zu starten.

  1. Öffnen Sie den Ergebnissatz der Richtlinie, indem Sie "rsop.msc" über eine Eingabeaufforderung mit erhöhten Rechten ausführen.
  2. Wechseln Sie im Popupfenster "Ergebnissatz" zu "Administrative Vorlagen>für Benutzerkonfigurationen>", um>den Zugriff auf die Eingabeaufforderung zu verhindern. Wenn der Status aktiviert ist, arbeiten Sie mit Ihrem Active Directory-Team zusammen, um die Ausführung von cmd.exe zuzulassen.

Fehler: Der Stapellistener funktioniert auf einem Windows 10-2004-Sitzungshost-VM nicht.

Führen Sie qwinsta.exe auf Ihrem Sitzungshost-VIRTUELLEN Computer über eine Eingabeaufforderung die Versionsnummer aus, die neben rdp-sxs der SESSIONNAME Spalte angezeigt wird. Wenn die STATE Spalte für rdp-tcp und rdp-sxs Einträge nicht Listenaufgeführt ist oder wenn rdp-tcp und rdp-sxs Einträge nicht aufgeführt werden, bedeutet dies, dass ein Stapelproblem besteht. Stapelupdates werden zusammen mit Agent-Updates installiert, aber wenn bei diesem Update ein Fehler auftritt, funktioniert der Azure Virtual Desktop-Listener nicht.

So lösen Sie das Problem:

  1. Öffnen Sie den Registrierungs-Editor.

  2. Wechseln Sie zu HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\WinStations.

  3. Unter WinStations" werden möglicherweise mehrere Ordner für verschiedene Stapelversionen angezeigt. Wählen Sie einen Ordner aus, der den Versionsinformationen entspricht, die Sie bei der Ausführung qwinsta.exe in einer Eingabeaufforderung gesehen haben.

    • Suchen und stellen Sie fReverseConnectMode sicher, dass der Datenwert angegeben ist 1. Stellen Sie außerdem sicher, dass sie fEnableWinStation auf 1.

      Screenshot von fReverseConnectMode.

    • Wenn fReverseConnectMode dieser Wert nicht festgelegt 1ist, wählen Sie das Feld "Wert" aus fReverseConnectMode , und geben Sie es 1 ein.

    • Wenn fEnableWinStation dieser Wert nicht festgelegt 1ist, wählen Sie das Feld "Wert" aus fEnableWinStation , und geben Sie es 1 ein.

  4. Wiederholen Sie die vorherigen Schritte für jeden Ordner, der den Versionsinformationen entspricht, die Sie beim Ausführen von qwinsta.exe in einer Eingabeaufforderung gesehen haben.

    Tipp

    Wenn Sie den fReverseConnectMode Modus fEnableWinStation für mehrere virtuelle Computer gleichzeitig ändern möchten, können Sie eine der folgenden beiden Aktionen ausführen:

    • Exportieren Sie den Registrierungsschlüssel von einem Computer, der bereits funktioniert, und importieren Sie den Schlüssel auf allen Computern, für die diese Änderung erforderlich ist.
    • Erstellen Sie ein Gruppenrichtlinienobjekt (Group Policy Object, GPO), das den Wert des Registrierungsschlüssels für die Computer festlegt, für die diese Änderung erforderlich ist.

  5. Starten Sie die Sitzungshost-VM neu.

  6. Öffnen Sie den Registrierungs-Editor.

  7. Wechseln Sie zu HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\ClusterSettings.

  8. Suchen ClusterSettingsSessionDirectoryListener Und stellen Sie sicher, dass ihr Datenwert ist rdp-sxs<version number, wobei <version number> die Versionsinformationen übereinstimmen, die Sie bei der Ausführung qwinsta.exe in einer Eingabeaufforderung gesehen haben.

  9. Wenn SessionDirectoryListener dieser Wert nicht festgelegt rdp-sxs<version numberist, müssen Sie die Schritte im Abschnitt "Ihr Problem" nicht aufgeführt oder nicht behoben haben.

Error: DownloadMsiException

Wechseln Sie auf der Sitzungshost-VM zu Ereignisanzeige>Windows-Protokolle>Anwendung. Wenn in der Beschreibung ein Ereignis mit id 3277 angezeigt DownloadMsiException wird, ist nicht genügend Speicherplatz auf dem Datenträger für den RDAgent vorhanden.

Um dieses Problem zu beheben, geben Sie durch eine der folgenden Aktionen Speicherplatz auf dem Datenträger frei:

  • Löschen von nicht mehr benötigten Dateien
  • Erhöhen der Speicherkapazität der Sitzungshost-VM

Fehler: Agent kann nicht aktualisiert werden: MissingMethodException

Wechseln Sie auf der Sitzungshost-VM zu Ereignisanzeige>Windows-Protokolle>Anwendung. Wenn in der Beschreibung ein Ereignis mit der ID 3389 MissingMethodException: Method not found angezeigt wird, wurde der Azure Virtual Desktop-Agent nicht erfolgreich aktualisiert und zu einer früheren Version zurückgesetzt. Dieses Problem kann auftreten, da die Versionsnummer des .NET Frameworks, das derzeit auf Ihren virtuellen Computern installiert ist, niedriger als 4.7.2 ist. Um dieses Problem zu lösen, müssen Sie ein Upgrade von .NET auf Version 4.7.2 oder höher durchführen. Befolgen Sie dazu die Installationsanweisungen in der .NET Framework-Dokumentation.

Fehler: VMs des Sitzungshosts hängen im Upgradestatus

Wenn der Status für die Sitzungshosts im Hostpool immer Nicht verfügbar oder Upgrade wird durchgeführt lautet, wurden Agent oder Stapel möglicherweise nicht erfolgreich installiert.

Um dieses Problem zu beheben, installieren Sie zuerst den parallelen Stapel neu:

  1. Melden Sie sich bei der Sitzungshost-VM als Administrator an.

  2. Führen Sie qwinsta.exe an einer PowerShell-Eingabeaufforderung mit erhöhten Rechten die Versionsnummer aus, die neben rdp-sxs der SESSIONNAME Spalte angezeigt wird. Wenn die STATE Spalte für rdp-tcp und rdp-sxs Einträge nicht Listenaufgeführt ist oder wenn rdp-tcp und rdp-sxs Einträge nicht aufgeführt werden, bedeutet dies, dass ein Stapelproblem besteht.

  3. Führen Sie den folgenden Befehl aus, um den RDAgentBootLoader-Dienst zu beenden:

    Stop-Service RDAgentBootLoader

  4. Wechseln Sie zu Systemsteuerung> Programs-Programme>und -Features oder unter Windows 11 zu den Einstellungs-App-Apps.>

  5. Deinstallieren Sie die neueste Version des SxS-Netzwerkstapels für Remotedesktopdienste oder die im Registrierungs-Editor HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\WinStations unter dem Wert für ReverseConnectionListener.

  6. Führen Sie an der PowerShell-Eingabeaufforderung die folgenden Cmdlets aus, um den Dateipfad des neuesten Installationsprogramms hinzuzufügen, das auf Ihrem Sitzungshostcomputer für den parallelen Stapel zu einer Variablen verfügbar ist, und geben Sie dessen Namen auf:

    $sxsMsi = (Get-ChildItem "$env:SystemDrive\Program Files\Microsoft RDInfra\" | ? Name -like SxSStack*.msi | Sort-Object CreationTime -Descending | Select-Object -First 1).FullName
$sxsMsi

  7. Installieren Sie das neueste Installationsprogramm, das auf Ihrer Sitzungshost-VM für den parallelen Stapel verfügbar ist, indem Sie das folgende Cmdlet ausführen:

    msiexec /i $sxsMsi

  8. Starten Sie die Sitzungshost-VM neu.

  9. Führen Sie an einer Eingabeaufforderung erneut aus qwinsta.exe , und stellen Sie sicher, dass die STATE Spalte für rdp-tcp und rdp-sxs Die Einträge lautet Listen. Andernfalls müssen Sie Ihre VM erneut registrieren und die Agent-Komponente neu installieren.

Fehler: Sitzungshosts bleiben im Zustand "Nicht verfügbar" hängen

Wenn Ihre Sitzungshost-VMs im Status „Nicht verfügbar“ verbleiben, hat Ihre VM eine der unter Integritätsprüfung aufgeführten Integritätsprüfungen nicht bestanden. Sie müssen das Problem beheben, das dazu führt, dass der virtuelle Computer die Integritätsprüfung fehlschlägt.

Fehler: Sitzungshosts verbleiben im Status „Benötigt Unterstützung“.

Mehrere Integritätsprüfungen können dazu führen, dass Ihre Sitzungshost-VMs im Status "Needs Assistance" hängen bleiben: UrlsAccessibleCheck, MetaDataServiceCheck und MonitoringAgentCheck.

UrlsAccessibleCheck

Wenn der Sitzungshost die Integritätsprüfung " UrlsAccessibleCheck " nicht übergibt, müssen Sie ermitteln, welche erforderliche URL Ihre Bereitstellung derzeit blockiert. Sobald Sie wissen, welche URL blockiert wird, sollten Sie ermitteln, welche Einstellung diese URL blockiert, und sie entfernen.

Es gibt zwei Gründe dafür, dass der Dienst eine erforderliche URL blockiert:

  • Sie verfügen über eine aktive Firewall, die den meisten ausgehenden Datenverkehr und den Zugriff auf die erforderlichen URLs blockiert.
  • Ihre lokale Hosts-Datei blockiert die erforderlichen Websites.

Wenn Sie ein firewallbezogenes Problem beheben möchten, müssen Sie eine Regel hinzufügen, die ausgehende Verbindungen zum TCP-Port 80/443 ermöglicht. Dieser ist mit den blockierten URLs verknüpft.

Wenn Ihre lokale Hosts-Datei die erforderlichen URLs blockiert, sollten Sie sicherstellen, dass keine der erforderlichen URLs auf Ihrem Gerät in der Hosts-Datei enthalten sind. Sie finden den Speicherort der Hosts-Datei im folgenden Registrierungsschlüssel und -wert:

Schlüssel: HKLM\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters

Typ: REG_EXPAND_SZ

Name: DataBasePath

MetaDataServiceCheck

Wenn der Sitzungshost die MetaDataServiceCheck-Integritätsprüfung nicht übergibt, kann der Dienst nicht auf den IMDS-Endpunkt zugreifen. Um dieses Problem zu beheben, müssen Sie die folgenden Schritte ausführen:

  • Konfigurieren Sie Ihre Netzwerk-, Firewall- oder Proxyeinstellungen neu, um die Blockierung der IP-Adresse 169.254.169.254 aufzuheben.
  • Stellen Sie sicher, dass Ihre HTTP-Clients bei Abfragen von IMDS Webproxys innerhalb des virtuellen Computers umgehen. Es wird empfohlen, die erforderliche IP-Adresse in allen Firewallrichtlinien innerhalb des VM zuzulassen, die mit der ausgehenden Richtung des Netzwerkdatenverkehrs zusammenhängen.

Fügen Sie in der Konfiguration des Webproxys eine Ausnahme für 169.254.169.254 hinzu, wenn Ihr Problem durch einen Webproxy verursacht wird. Öffnen Sie eine Eingabeaufforderung oder PowerShell-Sitzung mit erhöhten Rechten, und führen Sie den folgenden Befehl aus, um diese Ausnahme hinzuzufügen:

netsh winhttp set proxy proxy-server="http=<customerwebproxyhere>" bypass-list="169.254.169.254"

MonitoringAgentCheck

Wenn der Sitzungshost die MonitoringAgentCheck-Integritätsprüfung nicht übergibt, müssen Sie den Remotedesktopdienste-Infrastruktur-Genfer Agent überprüfen und überprüfen, ob er auf dem Sitzungshost ordnungsgemäß funktioniert:

  1. Überprüfen Sie, ob der Remote Desktop Services Infrastructure Geneva Agent auf dem Sitzungshost installiert ist. Dies können Sie in der Liste der installierten Programme auf dem Sitzungshost erledigen. Wenn mehrere Versionen dieses Agents installiert sind, deinstallieren Sie ältere Versionen, und behalten Sie nur die neueste Version bei.
  2. Wenn Sie den Remotedesktopdienste-Infrastruktur-Agent nicht auf dem Sitzungshost installiert finden, überprüfen Sie die Protokolle unter "C:\Programme\Microsoft RDInfra\GenevaInstall.txt ", und überprüfen Sie, ob die Installation aufgrund eines Fehlers fehlschlägt.
  3. Überprüfen Sie, ob die geplante Aufgabe GenevaTask_<Version> erstellt wird. Diese geplante Aufgabe muss aktiviert sein und ausgeführt werden. Falls nicht, installieren Sie den Agent mit der .msi Datei "Microsoft.RDInfra.Geneva.Installer-x64-version><.msi neu, die unter C:\Program Files\Microsoft RDInfra verfügbar ist.

Error: Verbindung nicht gefunden: Der RDAgent verfügt nicht über eine aktive Verbindung mit dem Broker

Ihre Sitzungshost-VMs befinden sich möglicherweise in ihrem Verbindungslimit und können keine neuen Verbindungen annehmen.

Führen Sie zum Beheben dieses Problems eine der folgenden Aktionen aus:

  • Verringern sie den maximalen Sitzungsgrenzwert. Diese Änderung stellt sicher, dass Ressourcen gleichmäßiger auf Sitzungshosts verteilt werden und eine Ressourcenabbauung verhindert.
  • Erhöhen Sie die Ressourcenkapazität der Sitzungshost-VMs.

Error: Betreiben einer Pro VM oder eines nicht unterstützten Betriebssystems

Der parallele Stapel wird nur von Windows Enterprise- oder Windows Server-SKUs unterstützt, unter Betriebssystemen wie Pro VM nicht. Wenn Sie nicht über eine Enterprise- oder Server-SKU verfügen, wird der Stapel auf Ihrem virtuellen Computer installiert, aber nicht aktiviert, sodass er nicht angezeigt wird, wenn Sie in der Befehlszeile ausgeführt werden qwinsta.exe .

Um dieses Problem zu beheben, erstellen Sie Sitzungshost-VMs mithilfe eines unterstützten Betriebssystems.

Error: NAME_ALREADY_REGISTERED

Der Name Ihrer Sitzungshost-VM wurde bereits registriert und ist wahrscheinlich ein Duplikat.

So beheben Sie dieses Problem:

  1. Führen Sie die Schritte aus, um den Sitzungshost aus dem Hostpool zu entfernen.

  2. Erstellen Sie eine andere VM. Stellen Sie sicher, dass Sie einen eindeutigen Namen für diese VM auswählen.

  3. Wechseln Sie zum Azure-Portal, und öffnen Sie die Seite Übersicht für den Hostpool, in dem sich Ihre VM befand.

  4. Öffnen Sie die Registerkarte Sitzungshosts, und überprüfen Sie, ob sich alle Sitzungshosts in diesem Hostpool befinden.

  5. Warten Sie 5 bis 10 Minuten, bis der Sitzungshoststatus verfügbar ist.

    Screenshot des verfügbaren Sitzungshosts.

Ihr Problem wird hier nicht aufgeführt oder konnte nicht gelöst werden

Wenn Ihr Problem in diesem Artikel nicht erläutert wurde oder die Anweisungen Ihr Problem nicht lösen konnten, empfiehlt es sich, den Azure Virtual Desktop-Agent zu deinstallieren, erneut zu installieren und erneut zu registrieren. Die Anweisungen in diesem Abschnitt zeigen, wie Sie Ihre Sitzungshost-VM für den Azure Virtual Desktop-Dienst neu registrieren können:

  1. Deinstallieren Sie alle Agent-, Startlade- und Stapelkomponenten.
  2. Entfernen Sie den Sitzungshost aus dem Hostpool.
  3. Generieren Sie einen neuen Registrierungsschlüssel für den virtuellen Computer.
  4. Installieren Sie den Azure Virtual Desktop Agent neu, und starten Sie das Ladeprogramm.

Führen Sie diese Anweisungen in diesem Abschnitt aus, wenn mindestens eines der folgenden Szenarien auf Sie zutrifft:

  • Der Status Ihrer Sitzungshost-VM ist als Upgrade oder Nicht verfügbar eingefroren.
  • Ihr Stapellistener funktioniert nicht, und Sie werden unter Windows 10, Version 1809, 1903 oder 1909 ausgeführt.
  • Sie erhalten den Fehler EXPIRED_REGISTRATION_TOKEN.
  • Ihre Sitzungshost-VMs werden in der Liste der Sitzungshosts nicht angezeigt.
  • Sie sehen den Dienst Remote Desktop Agent Loader nicht in der Konsole „Dienste“.
  • Die Komponente RdAgentBootLoader wird in Task Manager nicht als laufender Prozess angezeigt.
  • Sie erhalten einen Fehler "Verbindungsbroker konnte die Einstellungen nicht überprüfen" auf benutzerdefinierten Image-VMs.
  • Die vorherigen Abschnitte in diesem Artikel haben Ihr Problem nicht gelöst.

Schritt 1: Deinstallieren sämtlicher Komponentenprogramme für Agent, Bootloader und Stapel

Bevor Sie den Agent, den Bootloader und den Stapel neu installieren, müssen Sie alle vorhandenen Komponenten auf Ihrer VM deinstallieren. So deinstallieren Sie sämtliche Komponentenprogramme für Agent, Bootloader und Stapel:

  1. Melden Sie sich bei der Sitzungshost-VM als Administrator an.

  2. Wechseln Sie zu Systemsteuerung> Programs-Programme>und -Features oder unter Windows 11 zu den Einstellungs-App-Apps.>

  3. Deinstallieren Sie die folgenden Programme, und starten Sie dann die VM des Sitzungshosts neu:

    Achtung

    Beim Deinstallieren des SxS-Netzwerkstapels für Remotedesktopdienste werden Sie aufgefordert, den UserMode-Portumleitungsor für Remotedesktopdienste und Remotedesktopdienste zu schließen. Wenn Sie mit der VM des Sitzungshosts mit RDP verbunden sind, wählen Sie "Anwendungen nicht schließen" und dann "OK" aus. Andernfalls funktioniert Ihre RDP-Verbindung nicht.

    Screenshot der Eingabeaufforderung, dass remotedesktopdienste und Remotedesktopdienste UserMode Port Redirector geschlossen werden sollen.

    • Remote Desktop Agent Boot Loader
    • Remote Desktop Services Infrastructure Agent
    • Remote Desktop Services Infrastructure Geneva Agent
    • Remote Desktop Services SxS Network Stack

    Notiz

    Möglicherweise werden mehrere Instanzen dieser Programme angezeigt. Stellen Sie sicher, dass alle Instanzen entfernt werden.

    Screenshot der Deinstallation von Programmen.

Schritt 2: Entfernen des Sitzungshosts aus dem Hostpool

Wenn Sie den Sitzungshost aus dem Hostpool entfernen, ist dieser Host nicht mehr für diesen Pool registriert. Diese Vorgehensweise fungiert als Zurücksetzung der Sitzungshostregistrierung. So entfernen Sie den Sitzungshost aus dem Hostpool:

  1. Melden Sie sich beim Azure-Portal an.

  2. Geben Sie in der Suchleiste Azure Virtual Desktop ein, und wählen Sie den entsprechenden Diensteintrag aus.

  3. Wählen Sie Hostpools aus, und wählen Sie den Namen des Hostpools aus, in dem sich Ihre Sitzungshost-VM befindet.

  4. Wählen Sie Sitzungshosts aus, um eine Liste aller Sitzungshosts in diesem Hostpool anzuzeigen.

  5. Sehen Sie sich die Liste der Sitzungshosts an, und markieren Sie das Kontrollkästchen neben dem Sitzungshost, den Sie entfernen möchten.

  6. Wählen Sie Entfernen.

    Screenshot des Entfernens des virtuellen Computers aus dem Hostpool.

Schritt 3: Generieren eines neuen Registrierungsschlüssels für die VM

Sie müssen einen neuen Registrierungsschlüssel generieren, der zum erneuten Registrieren Ihrer Sitzungs-VM für den Hostpool und den Dienst verwendet wird. So generieren Sie einen neuen Registrierungsschlüssel für die VM:

  1. Melden Sie sich beim Azure-Portal an.

  2. Geben Sie in der Suchleiste Azure Virtual Desktop ein, und wählen Sie den entsprechenden Diensteintrag aus.

  3. Wählen Sie Hostpools aus, und wählen Sie den Namen des Hostpools aus, in dem sich Ihre Sitzungshost-VM befindet.

  4. Wählen Sie auf dem Blatt Übersicht den Registrierungsschlüssel aus.

    Screenshot des Registrierungsschlüssels im Portal.

  5. Öffnen Sie die Registerkarte Registrierungsschlüssel, und wählen Sie Neuen Schlüssel generieren aus.

  6. Geben Sie das Ablaufdatum ein, und wählen Sie dann "OK" aus.

    Notiz

    Das Ablaufdatum darf nicht weniger als eine Stunde und nicht mehr als 27 Tage nach dem Datum und der Uhrzeit der Generierung liegen. Generieren Sie einen Registrierungsschlüssel nur so lange wie nötig.

  7. Kopieren Sie den neu generierten Schlüssel in die Zwischenablage, oder laden Sie die Datei herunter. Sie benötigen diesen Schlüssel später.

Schritt 4: Neuinstallieren von Agent und Bootloader

Durch die erneute Installation der aktuellen Version von Agent und Bootloader werden auch der parallele Stapel und der Geneva-Überwachungs-Agent automatisch installiert. Führen Sie diese Schritte aus, um den Agenten und das Startladeprogramm neu zu installieren. Dies ist die neueste herunterladbare Version von Azure Virtual Desktop-Agent in Nichtvalidierungsumgebungen. Weitere Informationen zum Rollout neuer Versionen des Agents finden Sie unter Neuerungen im Azure Virtual Desktop-Agent.

  1. Melden Sie sich bei Ihrer Sitzungshost-VM als Administrator an und führen Sie den Agent-Installer und Bootloader für Ihre Sitzungshost-VM aus:

    Tipp

    Für jeden von Ihnen heruntergeladenen Agent- und Startladeprogramm müssen Sie die Blockierung möglicherweise aufheben. Klicken Sie mit der rechten Maustaste auf jede Datei, und wählen Sie "Eigenschaften>aufheben der Blockierung>OK" aus.

  2. Wenn das Installationsprogramm Sie zur Eingabe des Registrierungstokens auffordert, fügen Sie den Registrierungsschlüssel aus der Zwischenablage ein.

    Screenshot des eingefügten Registrierungstokens.

  3. Führen Sie das Installationsprogramm für den Bootloader aus.

  4. Starten Sie Ihre Sitzungs-VM neu.

  5. Melden Sie sich beim Azure-Portal an.

  6. Geben Sie in der Suchleiste Azure Virtual Desktop ein, und wählen Sie den entsprechenden Diensteintrag aus.

  7. Wählen Sie Hostpools aus, und wählen Sie den Namen des Hostpools aus, in dem sich Ihre Sitzungshost-VM befindet.

  8. Wählen Sie Sitzungshosts aus, um eine Liste aller Sitzungshosts in diesem Hostpool anzuzeigen.

  9. Der im Hostpool registrierte Sitzungshost sollte jetzt mit dem Status Verfügbar angezeigt werden.

    Screenshot des verfügbaren Sitzungshosts.

Entfernen des Registrierungsschlüssels DisableRegistryTools

Wenn Sie alle vier Schritte ausgeführt haben, der Agent aber immer noch nicht funktioniert, liegt es möglicherweise daran, dass der DisableRegistryTools Registrierungsschlüssel an einem der folgenden Speicherorte aktiviert ist:

  • HKU: \DEFAULT\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System\DisableRegistryTools = 1
  • HKU: \S-1-5-18\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System\DisableRegistryTools = 1
  • HKCU: \SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System\DisableRegistryTools = 1

Dieser Registrierungsschlüssel verhindert, dass der Agent den parallelen Stapel installiert. Dies führt zu einem Fehler vom Typ „InstallMSIException“. Dieser Fehler führt dazu, dass die Sitzungshosts nicht verfügbar sind.

Um dieses Problem zu beheben, müssen Sie den Schlüssel entfernen:

  1. Entfernen Sie den DisableRegistryTools Schlüssel aus den drei zuvor aufgeführten Speicherorten.
  2. Deinstallieren Sie den betroffenen parallelen Stapel, und entfernen Sie ihn aus dem Ordner Apps & Features.
  3. Entfernen Sie die Registrierungsschlüssel des betroffenen parallelen Stapels.
  4. Starten Sie den virtuellen Computer neu.
  5. Starten Sie den Agent, und lassen Sie ihn den parallelen Stapel automatisch installieren.

Nächste Schritte

Falls Ihr Problem weiterhin besteht, erstellen Sie eine Supportanfrage, und geben Sie detaillierte Informationen zum Problem sowie zu den Aktionen an, die Sie ausgeführt haben, um das Problem zu lösen. Die folgende Liste enthält weitere Ressourcen, die Sie zur Behandlung von Problemen in Ihrer Azure Virtual Desktop-Bereitstellung verwenden können.