L’hôte de session Azure Virtual Desktop affiche Indisponible : liste de contrôle pas à pas
Par Mirko Peters ·
Un hôte de session en cours d’exécution mais marqué Indisponible dans le pool d’hôtes ne peut accueillir aucun utilisateur. Commencez par lire le contrôle d’intégrité en échec, puis vérifiez l’intégration au domaine, les services, les URL, la mise à l’échelle automatique et l’inscription de l’agent.
Traduit automatiquement par IA à partir de l'article original. Lire l'original en anglais
Vous ouvrez le pool d’hôtes dans le portail Azure. Les machines virtuelles sont en cours d’exécution. Les hôtes de session affichent Indisponible. Les utilisateurs ne peuvent pas se connecter, ou se connectent à l’unique hôte encore opérationnel.
Points clés
- Une machine virtuelle à l’état En cours d’exécution ne dit rien de l’agent AVD. Le statut de l’hôte provient des contrôles d’intégrité de l’agent.
- Un échec de l’intégration au domaine ou un écouteur de la pile côte à côte défaillant constitue un contrôle critique. Un échec de l’agent de supervision, du service de métadonnées ou du contrôle des URL est classé comme non critique et conduit à Nécessite une attention.
- Une fois qu’un plan de mise à l’échelle automatique a démarré et arrêté des hôtes, vérifiez les rôles au niveau de l’abonnement, le mode de vidange et les services de l’agent avant de réinstaller quoi que ce soit.
- Réinstallez l’agent et le programme de démarrage avec une nouvelle clé d’inscription seulement lorsque les vérifications les moins coûteuses ont échoué.
Le Q&R de Microsoft comporte plusieurs fils de discussion de 2025 et 2026 sur ce sujet. Un demandeur disposant d’un nouvel environnement a résolu le problème en joignant manuellement la machine virtuelle au domaine. Un autre a vu les hôtes passer successivement à Indisponible après l’activation d’un plan de mise à l’échelle, et le fil ne s’est pas terminé par une solution confirmée. Cet article suit l’ordre recommandé par Microsoft Learn et y ajoute les points relevés dans ces fils. Il ne s’agit pas d’une procédure officielle de Microsoft. Vérifiez chaque étape sur les pages Learn actuelles, car l’article de dépannage de l’agent et l’article de configuration de l’hôte de session sont plus anciens que certaines autres pages.
Ce que vous observez
- Pool d’hôtes, puis Hôtes de session : statut Indisponible, parfois Nécessite une attention ou Mise à niveau.
- La machine virtuelle elle-même est à l’état En cours d’exécution.
- Après un redémarrage, la machine virtuelle redémarre, mais l’hôte reste Indisponible.
- Dans le cas d’un plan de mise à l’échelle, les hôtes passent progressivement à Indisponible, et non tous en même temps.
Étape 1 : lire le contrôle d’intégrité en échec
Dans le portail, ouvrez le pool d’hôtes, sélectionnez Hôtes de session, puis consultez les détails d’un hôte concerné. Learn décrit les statuts ainsi :
- Disponible : tous les contrôles ont réussi.
- Nécessite une attention : un contrôle non critique a échoué. Il s’agit de l’agent de supervision, du service de métadonnées d’instance Azure et du contrôle des URL. Les utilisateurs peuvent encore se connecter.
- Indisponible : l’hôte est arrêté ou a échoué à un contrôle critique.
- Mise à niveau ou Échec de la mise à niveau : la mise à jour de l’agent est en cours ou a échoué.
Les contrôles critiques de la page Learn sont le contrôle d’intégration au domaine, le contrôle de relation d’approbation du domaine et le contrôle de l’écouteur de la pile côte à côte. Le premier est celui sur lequel s’est terminé le fil de 2025.
Étape 2 : vérifier l’intégration au domaine
Le fil dont la solution a été confirmée a commencé par un utilisateur qui ne parvenait pas à se connecter à un environnement tout neuf. Un modérateur bénévole a suggéré le guide de déploiement standard et AVD Insights. Un conseiller indépendant a listé des vérifications génériques (journaux d’événements, jonction au domaine ou à Azure AD, ports ouverts, agent de l’image personnalisée, état du service). L’auteur de la question a indiqué par la suite que la machine virtuelle ne s’était pas jointe au domaine d’elle-même, et que la joindre manuellement puis la redémarrer avait résolu le problème.
Vérifiez ce point sur la machine virtuelle :
- Connectez-vous à la machine virtuelle avec un compte administrateur local et vérifiez si l’ordinateur est membre de votre domaine.
- Depuis une invite de commandes sur la machine virtuelle, exécutez un ping sur le nom de domaine pour vérifier qu’il se résout. Learn présente ce test comme le contrôle de base.
La page Microsoft Learn consacrée à la configuration des hôtes de session énumère les causes typiques d’échec de jonction : identifiants incorrects dans le modèle de déploiement, authentification multifacteur sur le compte de jonction, autorisations manquantes et problèmes DNS. Concernant le DNS, le réseau virtuel des machines virtuelles doit pouvoir atteindre le réseau du domaine (par exemple par appairage), le DNS du réseau doit pointer vers les contrôleurs de domaine, et la carte réseau doit hériter des mêmes serveurs DNS ou les utiliser.
Vérifiez également le point concernant la réutilisation d’un nom de compte d’ordinateur. Selon Learn, cette réutilisation peut être bloquée lorsque des mises à jour Windows publiées le 11 octobre 2022 ou après sont installées et que le compte de jonction ne dispose pas des droits nécessaires pour réutiliser des comptes d’ordinateur. Learn propose trois solutions : utiliser le compte qui a créé le compte d’ordinateur, utiliser un membre du groupe Admins du domaine, ou utiliser un compte couvert par le paramètre de stratégie de groupe qui autorise la réutilisation des comptes d’ordinateur lors de la jonction au domaine.
Étape 3 : vérifier les services de l’agent
Connectez-vous à la machine virtuelle. Si RDP ne fonctionne pas, Run Command du portail Azure est une option, comme l’a suggéré une réponse.
- Ouvrez
services.mscet vérifiez que Remote Desktop Agent Loader (le chargeur de démarrage, nom de serviceRDAgentBootLoader) est en cours d’exécution. Démarrez-le s’il est arrêté. Une réponse du fil consacré au plan de mise à l’échelle mentionnait aussi un serviceRDAgentà vérifier. La page de dépannage de l’agent sur Learn ne cite que le service Remote Desktop Agent Loader à cette étape. Considérez donc cette information comme rapportée dans un fil communautaire, et non confirmée par Microsoft Learn. - Ouvrez l’Observateur d’événements, puis accédez à Journaux Windows, puis à Application. Learn nomme les sources WVD-Agent, WVD-Agent-Updater, RDAgentBootLoader et MsiInstaller. La plupart des erreurs portent l’ID d’événement 3277 avec un mot-clé dans le message.
- Si le chargeur s’arrête à nouveau après l’avoir démarré, suspectez un problème d’inscription (étape 6).
Si la machine virtuelle démarre lentement, la page Learn décrit aussi un cas de dépassement du délai de démarrage : réglez le type de démarrage du chargeur sur Automatique (début différé) et, si nécessaire, augmentez la valeur ServicesPipeTimeout, en partant de 60 000 millisecondes.
Étape 4 : vérifier la connectivité au service
Les hôtes de session n’ont besoin que d’un accès sortant. La liste des points de terminaison requis sur Learn comprend .wvd.microsoft.com sur le port TCP 443, login.microsoftonline.com, les points de terminaison de supervision gcs.prod.monitoring.core.windows.net et .prod.warm.ingest.monitor.core.windows.net, ainsi que les adresses de l’infrastructure Azure 169.254.169.254 (métadonnées) et 168.63.129.16 (WireServer). Learn indique que le trafic vers ces deux dernières adresses ne doit être ni intercepté, ni proxifié, ni redirigé. Learn recommande d’utiliser des balises de service et des balises FQDN, car la documentation ne publie pas de liste de plages d’adresses IP à autoriser à la place des noms de domaine complets.
Testez dans cet ordre :
- Exécutez l’outil Azure Virtual Desktop Agent URL Tool sur l’hôte de session. Il vérifie chaque point de terminaison requis.
- En cas d’événement
INVALID_FORM, Learn indique de lire les valeursBrokerResourceIdURIetBrokerResourceIdURIGlobalsousHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\RDInfraAgent, d’ajouter/api/healthà chaque adresse et de l’ouvrir dans un navigateur. Un résultat sain indique que le broker est opérationnel. - Recherchez une inspection TLS, un proxy ou un DNS personnalisé sur le chemin.
Un fil consacré au plan de mise à l’échelle suggérait de tester une autre adresse de contrôle d’état sur rdweb.wvd.microsoft.com. Je n’ai pas trouvé cette adresse dans les pages Learn, et je ne la recommande donc pas. Utilisez plutôt les valeurs du broker issues du registre.
Ce fil affirmait aussi que des points de terminaison de supervision manquants provoquent des échecs de pulsation. Learn classe la vérification de l'agent de supervision parmi les contrôles non bloquants qui produisent l'état « Nécessite une assistance » et non « Indisponible » (son tableau des vérifications d'intégrité qualifie ce contrôle de semi-bloquant). Ouvrez tout de même ces points de terminaison, mais ne cessez pas de chercher si l'hôte reste « Indisponible ».
Étape 5 : si le problème est apparu après l'activation d'un plan de mise à l'échelle
Le fil consacré aux plans de mise à l'échelle a été publié en juin 2026. Les hôtes sont passés à l'état « Indisponible » les uns après les autres après l'activation du plan. L'ouverture des noms de pare-feu et le redémarrage des machines virtuelles n'ont pas résolu la plupart des cas. Deux réponses énuméraient des vérifications, et aucune réponse n'a été retenue.
La documentation Microsoft Learn explique le fonctionnement de la mise à l'échelle automatique, et il est utile de la comparer :
- Rôles au niveau de l'abonnement. Le principal de service ou l'identité managée du pool d'hôtes doit disposer du rôle Desktop Virtualization Power On Off Contributor, attribué au niveau de l'abonnement. Learn avertit qu'une portée plus restreinte peut empêcher la mise à l'échelle automatique de fonctionner correctement.
- Mode de vidage. Pendant la phase de réduction, la mise à l'échelle automatique place l'hôte ayant le moins de sessions en mode de vidage, déconnecte les utilisateurs une fois le délai d'attente écoulé, puis désalloue la machine virtuelle. Une réponse du fil consacré aux plans de mise à l'échelle suggérait de vérifier la colonne Autoriser les nouvelles sessions dans le portail après un redémarrage, car le mode de vidage peut persister. La page de Learn sur la mise à l'échelle automatique ne décrit pas ce comportement ; considérez donc cette information comme rapportée dans une discussion communautaire.
- Balise d'exclusion. La mise à l'échelle automatique ne touche pas aux hôtes portant la balise d'exclusion. Utilisez-la sur un hôte de test pour vérifier si le plan est à l'origine du problème.
- Pourcentage minimal d'hôtes. La mise à l'échelle automatique le respecte et n'arrête un hôte que si les hôtes restants peuvent prendre en charge les sessions. Je n'ai trouvé aucun texte de Learn décrivant un hôte démarré par la mise à l'échelle automatique qui ne parvient ensuite pas à signaler son état au service. Après une mise sous tension, répétez donc les étapes 2 à 4 sur cet hôte.
- Pas de mise à l'échelle mixte. Learn indique qu'il est impossible d'utiliser la mise à l'échelle automatique et les anciennes mises à l'échelle Azure Automation ou Logic Apps sur un même pool d'hôtes.
Pour le diagnostic, Learn propose une page sur la configuration des diagnostics de la mise à l'échelle automatique (Set up diagnostics for Autoscale), qui renvoie vers une FAQ sur la mise à l'échelle automatique.
Étape 6 : réinscrire ou réinstaller l'agent
Procédez ainsi lorsque les vérifications ci-dessus n'indiquent pas de cause, ou lorsque le journal affiche INVALID_REGISTRATION_TOKEN ou EXPIRED_MACHINE_TOKEN. Pour NAME_ALREADY_REGISTERED, Learn indique que le nom de la machine virtuelle est probablement en double : supprimez l'hôte de session du pool, créez une machine virtuelle portant un nom unique, puis ajoutez-la de nouveau. La procédure complète de réinstallation de Learn est la suivante :
- Désinstallez les composants suivants depuis Programmes et fonctionnalités, puis redémarrez : Remote Desktop Agent Boot Loader, Remote Desktop Services Infrastructure Agent, Remote Desktop Services Infrastructure Geneva Agent et Remote Desktop Services SxS Network Stack. Si vous vous connectez par RDP, choisissez de ne pas fermer les applications lors de la suppression de la pile SxS.
- Supprimez l'hôte de session du pool d'hôtes : Azure Virtual Desktop, Pools d'hôtes, votre pool, Hôtes de session, sélectionnez l'hôte, puis Supprimer.
- Générez une nouvelle clé d'inscription sur la page Clé d'inscription du pool d'hôtes. Elle doit être valide pendant au moins une heure et au plus 27 jours.
- Installez l'agent et le chargeur de démarrage actuels. Collez la clé dans le programme d'installation de l'agent, puis exécutez le programme d'installation du chargeur de démarrage et redémarrez.
- Attendez que l'hôte affiche Disponible.
Une réponse du fil suggérait une variante plus légère. Learn présente des valeurs de registre sous HKLM:\SOFTWARE\Microsoft\RDInfraAgent : définissez IsRegistered à 0, placez la nouvelle clé dans RegistrationToken, redémarrez le chargeur de démarrage, puis vérifiez que IsRegistered vaut 1 et que le champ du jeton est vide. Utilisez cette méthode uniquement pour les erreurs INVALID_REGISTRATION_TOKEN et EXPIRED_MACHINE_TOKEN.
N'associez pas une machine virtuelle issue d'une image de référence (golden image) à un pool d'hôtes en y déployant l'agent. La page de Learn sur les images de référence indique que les hôtes de session créés à partir d'une telle image ne parviennent ensuite pas à rejoindre le pool, car le jeton d'inscription a expiré, et que le processus de déploiement du pool d'hôtes associe les hôtes de session pendant le provisionnement.
Vérification
- L'hôte affiche Disponible en quelques minutes. Après la réinstallation complète, Learn recommande d'attendre de 5 à 10 minutes.
- Dans le portail, les détails n'indiquent aucune vérification en échec.
- Un utilisateur de test peut se connecter, et la session aboutit sur cet hôte de session.
- L'Observateur d'événements n'affiche aucun nouvel événement 3277.
Limites
- Un seul des fils de discussion a une cause confirmée : une jonction de domaine manquante.
- Le fil consacré au plan de mise à l'échelle s'est terminé sans correctif. Les étapes de l'étape 5 constituent donc une comparaison avec la documentation Learn, et non un remède éprouvé.
- Si l'hôte reste Unavailable après une réinstallation propre, collectez le nom de la vérification ayant échoué, les ID d'événements avec leurs heures UTC et le nom du pool d'hôtes, puis ouvrez un dossier de support.
Articles liés
Sources
- Microsoft Learn : Résoudre les problèmes liés à l'agent Azure Virtual Desktop
- Microsoft Learn : Résoudre les problèmes de configuration d'un hôte de session Azure Virtual Desktop
- Microsoft Learn : Statuts des hôtes de session et vérifications d'intégrité
- Microsoft Learn : FQDN et points de terminaison requis
- Microsoft Learn : Configurer une image de référence (golden image)
- Microsoft Learn : Créer et affecter un plan de mise à l'échelle automatique
- Microsoft Q&A : l'hôte de session Azure Virtual Desktop est indisponible (septembre 2025)
- Microsoft Q&A : les hôtes de session AVD deviennent indisponibles après l'activation d'un plan de mise à l'échelle (juin 2026)