Partager via

Résoudre des problèmes courants liés à l’Agent Azure Virtual Desktop

  • Article

L’Agent Azure Virtual Desktop peut occasionner des problèmes de connexion en raison de plusieurs facteurs :

  • erreur sur le répartiteur conduisant l’agent à arrêter le service ;
  • problèmes liés aux mises à jour ;
  • Problèmes d’installation pendant l’installation de l’agent, ce qui interrompt la connexion à l’hôte de session.

Cet article vous accompagne dans les solutions de ces scénarios courants et explique comment résoudre les problèmes de connexion.

Notes

Pour résoudre les problèmes liés à la connectivité de session et à l’agent Azure Virtual Desktop, nous vous recommandons de consulter les journaux des événements dans les machines virtuelles de votre hôte de session en vous rendant sur l’Application>Journaux Windows>Observateur d’événements. Recherchez les événements qui ont l’une des sources suivantes pour identifier votre problème :

  • Agent WVD
  • Programme de mise à jour de l’agent WVD
  • RDAgentBootLoader
  • MsiInstaller

Erreur : RDAgentBootLoader et/ou le chargeur de l’agent Bureau à distance ont cessé de fonctionner

Si vous voyez l’un des problèmes suivants, cela signifie que le chargeur de démarrage, qui charge l’agent, n’a pas pu installer l’agent correctement et que le service de l’agent n’est pas en cours d’exécution sur votre machine virtuelle hôte de session :

  • RDAgentBootLoader est arrêté ou n’est pas en cours d’exécution.
  • Il n’existe aucun état pour le Chargeur de l’agent Bureau à distance.

Pour résoudre ce problème, démarrez le chargeur de démarrage RDAgent :

  1. Dans la fenêtre Services, cliquez avec le bouton droit sur Le chargeur de l’agent Bureau à distance.
  2. Sélectionnez Démarrer. Si cette option est grisée, vous n’avez pas d’autorisations d’administrateur. Vous devez obtenir ces autorisations pour démarrer le service.
  3. Attendez 10 secondes, puis cliquez avec le bouton droit sur Le chargeur de l’agent Bureau à distance.
  4. Sélectionnez Actualiser.
  5. Si le service s’arrête après le démarrage et l’actualisez, vous risquez d’avoir un échec d’inscription. Pour plus d’informations, consultez INVALID_REGISTRATION_TOKEN ou EXPIRED_MACHINE_TOKEN.

Erreur : INVALID_REGISTRATION_TOKEN ou EXPIRED_MACHINE_TOKEN

Sur la machine virtuelle de votre hôte de session, accédez à l’Application>Journaux Windows>Observateur d'événements. Si vous voyez un événement avec l’ID 3277 et la description INVALID_REGISTRATION_TOKEN ou EXPIRED_MACHINE_TOKEN, la clé d’inscription utilisée n’est pas reconnue comme valide.

Pour résoudre ce problème :

  1. Créez une clé d’inscription en suivant les étapes décrites dans Générer une clé d’inscription.

  2. Ouvrez une invite PowerShell en tant qu’administrateur et exécutez les applets de commande suivantes pour ajouter la nouvelle clé d’inscription au Registre. Remplacez <RegistrationToken> par le nouveau jeton d’inscription que vous avez généré.

    $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. Exécutez l’applet de commande suivante pour redémarrer le service RDAgentBootLoader :

    Restart-Service RDAgentBootLoader

  4. Exécutez les applets de commande suivantes pour vérifier qu’elle IsRegistered est définie 1 et RegistrationToken vide.

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

    La sortie doit ressembler à la suivante :

    IsRegistered : 1

RegistrationToken :

  5. Vérifiez si votre hôte de session est disponible dans le pool d’hôtes. Si ce n’est pas le cas, affichez les entrées de l’Observateur d’événements et vérifiez s’il existe des erreurs qui empêchent le démarrage de l’agent.

Erreur : l’agent ne peut pas se connecter au répartiteur avec INVALID_FORM

Sur la machine virtuelle de votre hôte de session, accédez à l’Application>Journaux Windows>Observateur d'événements. Si vous voyez un événement avec l’ID 3277 avec INVALID_FORM dans la description, l’agent ne peut pas se connecter au répartiteur ou atteindre un point de terminaison particulier. Ce problème peut être dû à certains paramètres dns ou par pare-feu.

Pour résoudre ce problème, vérifiez que vous pouvez atteindre les deux points de terminaison appelés BrokerResourceIdURI :BrokerResourceIdURIGlobal

  1. Ouvrez l'Éditeur du Registre.

  2. Accédez à HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\RDInfraAgent.

  3. Notez les valeurs pour BrokerResourceIdURI et BrokerResourceIdURIGlobal.

  4. Ouvrez un navigateur web, entrez votre valeur dans BrokerResourceIdURI la barre d’adresses, puis ajoutez /api/health à la fin, par exemple https://rdbroker-g-us-r0.wvd.microsoft.com/api/health.

  5. Ouvrez un autre onglet dans le navigateur, entrez votre valeur dans BrokerResourceIdURIGlobal la barre d’adresses, puis ajoutez /api/health à la fin, par exemple https://rdbroker.wvd.microsoft.com/api/health.

  6. Si le réseau ne bloque pas la connexion du répartiteur, les deux pages se chargent correctement et affichent le message Répartiteur RD intègre comme dans les captures d’écran suivantes :

    Capture d’écran de l’accès à l’URI broker chargé avec succès.

    Capture d’écran de l’accès à l’URI global du répartiteur correctement chargé.

  7. Si le réseau bloque la connexion broker, les pages ne se chargent pas, comme illustré dans la capture d’écran suivante.

    Capture d’écran de l’accès broker chargé qui a échoué.

    Capture d’écran de l’accès global du répartiteur chargé ayant échoué.

    Vous devez débloquer les points de terminaison requis, puis répéter les étapes 4 à 7. Pour plus d’informations, consultez Liste des URL requises.

  8. Si vous suivez les étapes précédentes ne résout pas votre problème, assurez-vous que vous n’avez pas de stratégies de groupe avec des chiffrements qui bloquent l’agent sur la connexion broker. Azure Virtual Desktop utilise les mêmes chiffrements TLS 1.2 qu’Azure Front Door. Pour plus d’informations, consultez Sécurité de la connexion.

Erreur : 3703

Sur la machine virtuelle de votre hôte de session, accédez à l’Application>Journaux Windows>Observateur d'événements. Si vous voyez un événement avec l’ID 3703 avec RD Gateway Url: is not accessible dans la description, l’agent n’est pas en mesure d’atteindre les URL de passerelle. Pour vous connecter correctement à votre hôte de session, vous devez autoriser le trafic réseau vers les URL de la Liste des URL requises. Assurez-vous également que vos paramètres de pare-feu ou de proxy ne bloquent pas ces URL. Le déblocage de ces URL est nécessaire pour utiliser Azure Virtual Desktop.

Pour résoudre ce problème, vérifiez que vous avez accès aux URL requises en exécutant l’outil de vérification de l’URL requise. Si vous utilisez Pare-feu Azure, consultez Utiliser Pare-feu Azure pour protéger les déploiements Azure Virtual Desktop et Pare-feu Azure paramètres DNS pour plus d’informations sur la façon de la configurer pour Azure Virtual Desktop.

Erreur: 3019

Sur la machine virtuelle de votre hôte de session, accédez à l’Application>Journaux Windows>Observateur d'événements. Si vous voyez un événement avec l’ID 3019, l’agent ne peut pas atteindre les URL de transport de socket web. Pour vous connecter correctement à votre hôte de session et autoriser le trafic réseau à ignorer les restrictions, vous devez débloquer les URL répertoriées dans la Liste des URL requises. Collaborez avec votre équipe de mise en réseau pour vous assurer que vos paramètres de pare-feu, de proxy et DNS ne bloquent pas ces URL. Vous pouvez également consulter les journaux de suivi du réseau pour identifier l’emplacement où le service Azure Virtual Desktop est bloqué. Si vous ouvrez un cas de support Microsoft pour ce problème particulier, veillez à joindre vos journaux de suivi réseau.

Erreur : InstallationHealthCheckFailedException

Sur la machine virtuelle de votre hôte de session, accédez à l’Application>Journaux Windows>Observateur d'événements. Si vous voyez un événement avec l’ID 3277 avec InstallationHealthCheckFailedException dans la description, l’écouteur de pile ne fonctionne pas, car le serveur terminal a activé la clé de Registre pour l’écouteur de pile.

Pour résoudre ce problème :

  1. Vérifiez si l’écouteur de pile fonctionne.
  2. Si l’écouteur de pile ne fonctionne pas, désinstallez et réinstallez manuellement le composant de la pile.

Erreur : ENDPOINT_NOT_FOUND

Sur la machine virtuelle de votre hôte de session, accédez à l’Application>Journaux Windows>Observateur d'événements. Si vous voyez un événement avec l’ID 3277 avec ENDPOINT_NOT_FOUND dans la description, le répartiteur n’a pas trouvé de point de terminaison pour établir une connexion avec. Ce problème de connexion peut se produire pour les raisons suivantes :

  • Il n’y a pas de machines virtuelles d’hôte de session dans votre pool d’hôtes.
  • Les machines virtuelles de l’hôte de session de votre pool d’hôtes ne sont pas actives
  • Toutes les machines virtuelles hôtes de session de votre pool d’hôtes ont dépassé la limite de session maximale.
  • Aucune des machines virtuelles de votre pool d’hôtes n’a le service d’agent en cours d’exécution.

Pour résoudre ce problème :

  1. Assurez-vous que la machine virtuelle est sous tension et qu’elle n’a pas été supprimée du pool d’hôtes.
  2. Vérifiez que la machine virtuelle n’a pas dépassé la limite de session maximale.
  3. Assurez-vous que le service d’agent est en cours d’exécution et que l’écouteur de pile fonctionne.
  4. Assurez-vous que l’agent peut se connecter au répartiteur.
  5. Assurez-vous que votre machine virtuelle dispose d’un jeton d’inscription valide.
  6. Assurez-vous que le jeton d’inscription de la machine virtuelle n’a pas expiré.

Erreur : InstallMsiException

Sur la machine virtuelle de votre hôte de session, accédez à l’Application>Journaux Windows>Observateur d'événements. Si vous voyez un événement avec l’ID 3277 avec InstallMsiException dans la description, le programme d’installation est déjà en cours d’exécution pour une autre application pendant que vous essayez d’installer l’agent, ou la stratégie de groupe bloque msiexec.exe de s’exécuter.

Pour vérifier si la stratégie de groupe bloque msiexec.exe de l’exécution :

  1. Ouvrez le jeu de stratégie résultant en exécutant rsop.msc à partir d’une invite de commandes avec élévation de privilèges.

  2. Dans la fenêtre Jeu de stratégie résultant qui s’affiche, accédez à Modèles>d’administration de configuration>ordinateur Windows Components>Windows Installer désactiver Windows Installer.> Si l’état est activé, collaborez avec votre équipe Active Directory pour autoriser msiexec.exe à s’exécuter.

    Capture d’écran de la stratégie Windows Installer dans l’ensemble de stratégies résultant.

    Note

    Cette liste ne répertorie pas la totalité des stratégies, mais uniquement celles que nous connaissons actuellement.

Erreur : Win32Exception

Sur la machine virtuelle de votre hôte de session, accédez à l’Application>Journaux Windows>Observateur d'événements. Si vous voyez un événement avec l’ID 3277 avec InstallMsiException dans la description, une stratégie bloque cmd.exe de lancement. Le blocage de ce programme vous empêche d’exécuter la fenêtre de console que vous devez utiliser pour redémarrer le service à chaque mise à jour de l’agent.

  1. Ouvrez le jeu de stratégie résultant en exécutant rsop.msc à partir d’une invite de commandes avec élévation de privilèges.
  2. Dans la fenêtre Jeu de stratégie résultant qui s’affiche, accédez au système>Modèles>d’administration de configuration>utilisateur Empêcher l’accès à l’invite de commandes. Si l’état est activé, collaborez avec votre équipe Active Directory pour autoriser cmd.exe à s’exécuter.

Erreur : L’écouteur de pile ne fonctionne pas sur une machine virtuelle d’hôte de session Windows 10 2004

Sur votre machine virtuelle hôte de session, à partir d’une invite de commandes, exécutez qwinsta.exe et notez le numéro de version qui apparaît en rdp-sxs regard de la SESSIONNAME colonne. Si la STATE colonne pour rdp-tcp et rdp-sxs les entrées n’est pas Listen, ou si et rdp-sxs les rdp-tcp entrées ne sont pas répertoriées, cela signifie qu’il existe un problème de pile. Les mises à jour de pile sont installées en même temps que les mises à jour d’agent, mais si la mise à jour a échoué, l’écouteur d’Azure Virtual Desktop ne fonctionnera pas.

Pour résoudre ce problème :

  1. Ouvrez l’Éditeur du Registre.

  2. Accédez à HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\WinStations.

  3. Sous WinStations, vous pouvez voir plusieurs dossiers pour différentes versions de pile. Sélectionnez un dossier qui correspond aux informations de version que vous avez vues lors de l’exécution qwinsta.exe dans une invite de commandes.

    • Recherchez fReverseConnectMode et vérifiez que sa valeur de données est 1. Vérifiez également que la fEnableWinStation valeur est définie 1sur .

      Capture d’écran de fReverseConnectMode.

    • S’il fReverseConnectMode n’est pas défini sur 1, sélectionnez fReverseConnectMode et entrez 1 dans son champ valeur.

    • S’il fEnableWinStation n’est pas défini sur 1, sélectionnez fEnableWinStation et entrez 1 son champ valeur.

  4. Répétez les étapes précédentes pour chaque dossier qui correspond aux informations de version que vous avez vues lors de l’exécution deqwinsta.exe dans une invite de commandes.

    Conseil

    Pour modifier le ou fEnableWinStation le fReverseConnectMode mode de plusieurs machines virtuelles à la fois, vous pouvez effectuer l’une des deux opérations suivantes :

    • exporter la clé de Registre de la machine qui fonctionne déjà, et l’importer sur toutes les autres machines nécessitant cette modification ;
    • créer un objet de stratégie de groupe (GPO) qui définit la valeur de clé de Registre pour les machines nécessitant la modification.

  5. Redémarrez votre la machine virtuelle de votre hôte de session.

  6. Ouvrez l’Éditeur du Registre.

  7. Accédez à HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\ClusterSettings.

  8. Sous ClusterSettings, recherchez SessionDirectoryListener et vérifiez que sa valeur de données est rdp-sxs<version number, où <version number> correspond aux informations de version que vous avez vues lors de l’exécution qwinsta.exe dans une invite de commandes.

  9. Si SessionDirectoryListener ce n’est pas le rdp-sxs<version numbercas, vous devez suivre les étapes décrites dans la section Votre problème n’est pas répertoriée ici ou n’a pas été résolue .

Erreur : DownloadMsiException

Sur la machine virtuelle de votre hôte de session, accédez à l’Application>Journaux Windows>Observateur d'événements. Si vous voyez un événement avec l’ID 3277 avec DownloadMsiException dans la description, il n’y a pas suffisamment d’espace sur le disque pour rdAgent.

Pour résoudre ce problème, libérez de l’espace sur votre disque en procédant comme suit :

  • Supprimez les fichiers qui ne sont plus utilisés.
  • Augmentez la capacité de stockage de votre machine virtuelle.

Erreur : échec de la mise à jour de l’agent avec MissingMethodException

Sur la machine virtuelle de votre hôte de session, accédez à l’Application>Journaux Windows>Observateur d'événements. Si vous voyez un événement avec l’ID 3389 avec MissingMethodException: Method not found dans la description, l’agent Azure Virtual Desktop ne s’est pas mis à jour correctement et a rétabli une version antérieure. Ce problème peut se produire car le numéro de version du .NET Framework actuellement installé sur vos machines virtuelles est inférieur à 4.7.2. Pour résoudre ce problème, vous devez mettre à niveau .NET vers la version 4.7.2 ou ultérieure en suivant les instructions d’installation de la documentation .NET Framework.

Erreur : Les machines virtuelles hôtes de session sont bloquées dans l’état de mise à niveau

Si l’état indiqué pour l’hôte ou les hôtes de session dans votre pool d’hôtes indique toujours Indisponible ouMise à niveau, l’agent ou la pile n’a pas été installé correctement.

Pour résoudre ce problème, réinstallez la pile côte à côte :

  1. Connectez-vous à la machine virtuelle de votre hôte de session en tant qu’administrateur.

  2. À partir d’une invite PowerShell avec élévation de privilèges, exécutez qwinsta.exe et notez le numéro de version qui apparaît en rdp-sxs regard de la SESSIONNAME colonne. Si la STATE colonne pour rdp-tcp et rdp-sxs les entrées n’est pas Listen, ou si et rdp-sxs les rdp-tcp entrées ne sont pas répertoriées, cela signifie qu’il existe un problème de pile.

  3. Exécutez la commande suivante pour arrêter le service RDAgentBootLoader :

    Stop-Service RDAgentBootLoader

  4. Accédez à Panneau de configuration> Programs>Programmes et fonctionnalités, ou sur Windows 11, accédez aux applications d’application>Paramètres.

  5. Désinstallez la dernière version de la pile réseau SxS des services Bureau à distance ou la version répertoriée dans l’Éditeur du Registre sous HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\WinStations la valeur pour ReverseConnectionListener.

  6. À l’invite PowerShell, exécutez les applets de commande suivantes pour ajouter le chemin d’accès au fichier du dernier programme d’installation disponible sur votre machine virtuelle hôte de session pour la pile côte à côte à une variable et répertorier son nom :

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

  7. Installez le dernier programme d’installation disponible sur votre machine virtuelle hôte de session pour la pile côte à côte en exécutant l’applet de commande suivante :

    msiexec /i $sxsMsi

  8. Redémarrez votre la machine virtuelle de votre hôte de session.

  9. À partir d’une invite de commandes, réexécutez qwinsta.exe et vérifiez que la STATE colonne pour rdp-tcp et rdp-sxs les entrées est Listen. Si ce n’est pas le cas, vous devez réinscrire votre machine virtuelle et réinstaller le composant agent.

Erreur : les hôtes de session sont bloqués dans l’état Non disponible

Si vos machines virtuelles hôtes de session sont bloquées à l’état Indisponible, votre machine virtuelle n’a pas réussi l’un des contrôles d’intégrité répertoriés dans Contrôle d’intégrité. Vous devez résoudre le problème qui provoque l’échec de la vérification d’intégrité de la machine virtuelle.

Erreur : Les hôtes de la session sont bloqués dans l’état « A besoin d’assistance »

Plusieurs vérifications d’intégrité peuvent entraîner le blocage de vos machines virtuelles hôtes de session dans l’état d’assistance nécessaire : UrlsAccessibleCheck, MetaDataServiceCheck et MonitoringAgentCheck.

UrlsAccessibleCheck

Si l’hôte de session ne passe pas le contrôle d’intégrité UrlsAccessibleCheck, vous devez identifier l’URL requise que votre déploiement bloque actuellement. Une fois que vous savez quelle URL est bloquée, identifiez le paramètre qui bloque cette URL et supprimez-le.

Il y a deux raisons pour lesquelles le service bloque une URL requise :

  • Vous avez un pare-feu actif qui bloque la plupart du trafic sortant et l’accès aux URL requises.
  • Votre fichier hosts local bloque les sites web requis.

Pour résoudre un problème lié au pare-feu, ajoutez une règle qui autorise les connexions sortantes au port TCP 80/443 associé aux URL bloquées.

Si votre fichier hosts local bloque les URL requises, vérifiez qu’aucune des URL requises ne se trouve dans le fichier Hosts sur votre appareil. Vous trouverez l’emplacement du fichier Hosts dans la clé et la valeur de Registre suivantes :

Clé :HKLM\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters

Entrez : REG_EXPAND_SZ

Nom : DataBasePath

MetaDataServiceCheck

Si l’hôte de session ne passe pas le contrôle d’intégrité MetaDataServiceCheck , le service ne peut pas accéder au point de terminaison IMDS. Pour résoudre ce problème, vous devez effectuer les opérations suivantes :

  • Reconfigurez vos paramètres réseau, de pare-feu ou de proxy pour débloquer l’adresse IP 169.254.169.254.
  • Vérifiez que vos clients HTTP contournent les proxys web au sein de la machine virtuelle lors de l’interrogation d’IMDS. Nous vous recommandons d’autoriser l’adresse IP requise dans toutes les stratégies de pare-feu au sein de la machine virtuelle qui concernent la direction du trafic réseau sortant.

Si votre problème est dû à un proxy web, ajoutez une exception pour 169.254.169.254 dans la configuration du proxy web. Pour ajouter cette exception, ouvrez une invite de commandes avec élévation de privilèges ou une session PowerShell, et exécutez la commande suivante :

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

MonitoringAgentCheck

Si l’hôte de session ne passe pas le contrôle d’intégrité MonitoringAgentCheck , vous devez vérifier l’agent Genève des services Bureau à distance et vérifier s’il fonctionne correctement sur l’hôte de session :

  1. Assurez-vous que l’agent Geneva d’infrastructure des services Bureau à distance est installé sur l’hôte de la session. Vous pouvez le vérifier dans la liste des programmes installés sur l’hôte de la session. Si vous voyez plusieurs versions de cet agent installées, désinstallez les versions antérieures et conservez uniquement la dernière version installée.
  2. Si vous ne trouvez pas l’agent Genève des services Bureau à distance installé sur l’hôte de session, passez en revue les journaux situés sous C :\Program Files\Microsoft RDInfra \GenevaInstall.txt et vérifiez si l’installation échoue en raison d’une erreur.
  3. Vérifiez si la tâche planifiée GenevaTask_<version> est créée. Cette tâche planifiée doit être activée et en cours d’exécution. Si ce n’est pas le cas, réinstallez l’agent à l’aide du fichier nommé Microsoft.RDInfra.Geneva.Installer-x64-version<>.msi disponible sur C :\Program Files\Microsoft RDInfra..msi

Erreur : Connexion introuvable : RDAgent n’a pas de connexion active au répartiteur

Vos machines virtuelles hôtes de session peuvent être à leur limite de connexion et ne peuvent pas accepter de nouvelles connexions.

Pour résoudre ce problème, deux solutions sont proposées :

  • Réduisez la limite maximale de session. Cette modification garantit que les ressources sont plus réparties uniformément entre les hôtes de session et empêchent l’épuisement des ressources.
  • Augmentez la capacité des ressources des machines virtuelles d’hôte de session.

Erreur : Utilisation du système d’exploitation Pro VM ou d’un autre système d’exploitation non pris en charge

La pile côte à côte n’étant prise en charge que par les références (SKU) Windows Enterprise ou Windows Server, cela qui signifie que des systèmes d’exploitation tels que Pro VM ne le sont pas. Si vous n’avez pas de référence SKU Enterprise ou Server, la pile s’installe sur votre machine virtuelle, mais n’est pas activée. Elle n’apparaît donc pas lorsque vous exécutez qwinsta.exe votre ligne de commande.

Pour résoudre ce problème, créez des machines virtuelles d’hôte de session à l’aide d’un système d’exploitation pris en charge.

Erreur : NAME_ALREADY_REGISTERED

Le nom de la machine virtuelle de votre hôte de session a déjà été inscrit et est probablement un doublon.

Pour résoudre ce problème :

  1. Suivez les étapes pour supprimer l’hôte de session du pool d’hôtes.

  2. Créez une autre machine virtuelle. Veillez à choisir un nom unique pour cette machine virtuelle.

  3. Accédez au portail Azure et ouvrez la page Vue d’ensemble du pool d’hôtes dans lequel se trouvait votre machine virtuelle.

  4. Ouvrez l’onglet Hôtes de la session et assurez-vous que tous les hôtes de la session se trouvent dans ce pool d’hôtes.

  5. Attendez 5 à 10 minutes pour que l’état de l’hôte de session indique Disponible.

    Capture d’écran de l’hôte de session disponible.

Votre problème n’est pas répertorié ici ou n’a pas été résolu

Si vous ne trouvez pas votre problème dans cet article ou si les instructions ne vous ont pas été utiles, nous vous recommandons de désinstaller, réinstaller et réinscrire l’agent Azure Virtual Desktop. Les instructions de cette section vous montrent comment réinscrire la machine virtuelle de votre hôte de session auprès du service Azure Virtual Desktop :

  1. Désinstallez tous les composants de l’agent, du chargeur de démarrage et de la pile.
  2. Supprimez l’hôte de session du pool d’hôtes.
  3. Générez une nouvelle clé d’inscription pour la machine virtuelle.
  4. Réinstallez l’agent Azure Virtual Desktop et le chargeur de démarrage.

Suivez ces instructions si un ou plusieurs des scénarios suivants vous concernent :

  • L’état de la machine virtuelle de votre hôte de session est bloqué en sur Mise à niveau ou Indisponible.
  • Votre écouteur de pile ne fonctionne pas et vous exécutez sur Windows 10 version 1809, 1903 ou 1909.
  • Vous recevez une erreur EXPIRED_REGISTRATION_TOKEN.
  • Vous ne voyez pas les machines virtuelles de votre hôte apparaître dans la liste des hôtes de la session.
  • Vous ne voyez pas le service Chargeur de l’agent Bureau à distance dans la console Services.
  • Vous ne voyez pas le composant RdAgentBootLoader comme un processus en cours d’exécution dans le Gestionnaire des tâches.
  • Vous recevez une erreur « Le répartiteur de connexions n’a pas pu valider les paramètres » sur les machines virtuelles d’image personnalisées.
  • Les instructions précédentes de cet article n’ont pas résolu votre problème.

Étape 1 : Désinstaller tout agent, chargeur de démarrage et programme de composant de pile

Avant de réinstaller l’agent, le chargeur de démarrage et la pile, vous devez désinstaller tout programme de composant existant de votre machine virtuelle. Pour désinstaller tout agent, chargeur de démarrage et programme de composant de pile :

  1. Connectez-vous à la machine virtuelle de votre hôte de session en tant qu’administrateur.

  2. Accédez à Panneau de configuration> Programs>Programmes et fonctionnalités, ou sur Windows 11, accédez aux applications d’application>Paramètres.

  3. Désinstallez les programmes suivants, puis redémarrez votre machine virtuelle hôte de session :

    Attention

    Lors de la désinstallation de la pile réseau SxS des services Bureau à distance, vous êtes invité à fermer le redirecteur de port UserMode des services Bureau à distance et services Bureau à distance. Si vous êtes connecté à la machine virtuelle hôte de session à l’aide du protocole RDP, sélectionnez Ne pas fermer les applications, puis sélectionnez OK. Sinon, votre connexion RDP ne fonctionnera pas.

    Capture d’écran montrant l’invite à fermer les services Bureau à distance et le redirecteur de port UserMode des services Bureau à distance.

    • Chargeur de démarrage de l’agent Bureau à distance
    • Agent d’infrastructure des services Bureau à distance
    • Agent Geneva d’infrastructure des services Bureau à distance
    • Ple réseau SxS des services Bureau à distance

    Note

    Vous pouvez voir plusieurs instances de ces programmes. Veillez à les supprimer toutes.

    Capture d’écran de la désinstallation des programmes.

Étape 2 : Supprimer l’hôte de la session du pool d’hôtes

Lorsque vous supprimez l’hôte de la session du pool d’hôtes, l’hôte de la session n’est plus inscrit auprès de ce pool d’hôtes. Cette modification a pour effet de réinitialiser l’inscription de l’hôte de la session. Pour supprimer l’hôte de la session du pool d’hôtes :

  1. Connectez-vous au portail Azure.

  2. Dans la barre de recherche, tapez Azure Virtual Desktop et sélectionnez l’entrée de service correspondante.

  3. Sélectionnez Pools d’hôtes et sélectionnez le nom du pool d’hôtes dans lequel se trouve la machine virtuelle de votre hôte de session.

  4. Sélectionnez l’onglet Hôtes de session pour afficher la liste de tous les hôtes de la session dans ce pool d’hôtes.

  5. Examinez la liste des hôtes de session et cochez la case en regard de l’hôte de session que vous souhaitez supprimer.

  6. Sélectionnez Supprimer.

    Capture d’écran de la suppression de la machine virtuelle du pool d’hôtes.

Étape 3 : Générer une nouvelle clé d’inscription pour la machine virtuelle

Vous devez générer une nouvelle clé d’inscription utilisée pour réinscrire votre machine virtuelle de session dans le pool d’hôtes et le service. Pour générer une nouvelle clé d’inscription pour la machine virtuelle :

  1. Connectez-vous au portail Azure.

  2. Dans la barre de recherche, tapez Azure Virtual Desktop et sélectionnez l’entrée de service correspondante.

  3. Sélectionnez Pools d’hôtes et sélectionnez le nom du pool d’hôtes dans lequel se trouve la machine virtuelle de votre hôte de session.

  4. Dans le panneau Vue d’ensemble, sélectionnez Clé d’inscription.

    Capture d’écran de la clé d’inscription dans le portail.

  5. Ouvrez l’onglet Clé d’inscription et sélectionnez Générer une nouvelle clé.

  6. Entrez la date d’expiration, puis sélectionnez Ok.

    Note

    La date d’expiration doit être postérieure d’au moins une heure et d’au plus 27 jours à la date et l’heure de sa génération. Générez une clé d’inscription uniquement tant que vous en avez besoin.

  7. Copiez la clé nouvellement générée dans le Presse-papiers ou téléchargez le fichier. Vous avez besoin de cette clé ultérieurement.

Étape 4 : Réinstaller l’agent et le chargeur de démarrage

La réinstallation de la dernière version de l’agent et du chargeur de démarrage installe également automatiquement la pile côte à côte et l’agent de surveillance Geneva. Pour réinstaller l’agent et le chargeur de démarrage, procédez comme suit. Il s’agit de la plus récente version téléchargeable de l’agent Azure Virtual Desktop dans les environnements de non-validation. Pour plus d’informations sur le lancement de nouvelles versions de l’agent, consultez Nouveautés de l’agent Azure Virtual Desktop.

  1. Connectez-vous à votre machine virtuelle hôte de session en tant qu’administrateur et exécutez le programme d’installation et le chargeur de démarrage de l’agent pour votre machine virtuelle hôte de session :

    Conseil

    Pour chacun des programmes d’installation de l’agent et du chargeur de démarrage que vous avez téléchargés, vous devrez peut-être les débloquer. Cliquez avec le bouton droit sur chaque fichier, puis sélectionnez Propriétés>débloquer>OK.

  2. Quand le programme d’installation vous demande le jeton d’inscription, collez la clé d’inscription que vous avez copiée dans votre Presse-papiers.

    Capture d’écran du jeton d’inscription collé.

  3. Exécutez le programme d’installation du chargeur de démarrage.

  4. Redémarrer votre machine virtuelle de session.

  5. Connectez-vous au portail Azure.

  6. Dans la barre de recherche, tapez Azure Virtual Desktop, puis sélectionnez l’entrée du service correspondant.

  7. Sélectionnez Pools d’hôtes et sélectionnez le nom du pool d’hôtes dans lequel se trouve la machine virtuelle de votre hôte de session.

  8. Sélectionnez l’onglet Hôtes de session pour afficher la liste de tous les hôtes de la session dans ce pool d’hôtes.

  9. Vous devez maintenant voir l’hôte de la session inscrit dans le pool d’hôtes avec l’état Disponible.

    Capture d’écran de l’hôte de session disponible.

Supprimer la clé de Registre DisableRegistryTools

Si vous avez effectué les quatre étapes, mais que l’agent ne fonctionne toujours pas, cela peut être dû au fait que la DisableRegistryTools clé de Registre est activée dans l’un des emplacements suivants :

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

Cette clé de Registre empêche l’agent d’installer la pile côte à côte, ce qui entraîne une erreur installMSIException. Cette erreur entraîne le blocage des hôtes de session dans un état indisponible.

Pour résoudre ce problème, vous devez supprimer la clé :

  1. Supprimez la DisableRegistryTools clé des trois emplacements répertoriés précédemment.
  2. Désinstallez et supprimez l’installation de la pile côte à côte concernée du dossier Applications et fonctionnalités.
  3. Supprimez les clés de Registre de la pile côte à côte concernée.
  4. Redémarrez votre machine virtuelle.
  5. Démarrez l’agent et laissez-le installer automatiquement la pile côte à côte.

Étapes suivantes

Si le problème persiste, créez un cas de support en incluant des informations détaillées sur le problème rencontré et les actions que vous avez tentées pour le résoudre. La liste suivante comprend d’autres ressources que vous pouvez utiliser pour résoudre des problèmes liés à votre déploiement de Azure Virtual Desktop.