Résoudre les problèmes de configuration et de mise à jour de l’hôte de la session dans Azure Virtual Desktop
Important
La mise à jour d’hôte de session pour Azure Virtual Desktop est actuellement en PRÉVERSION. Pour connaître les conditions juridiques qui s’appliquent aux fonctionnalités Azure en version bêta, en préversion ou plus généralement non encore en disponibilité générale, consultez l’Avenant aux conditions d’utilisation des préversions de Microsoft Azure.
La mise à jour de l’hôte de la session dans Azure Virtual Desktop vous permet de mettre à jour facilement les machines virtuelles hôtes de la session dans un pool d’hôtes avec une configuration d’hôte de la session. Cet article vous aide à résoudre certains problèmes que vous pourriez rencontrer.
La configuration de l’hôte de la session n’a pas pu être créée lors de la création d’un pool d’hôtes
Lorsqu’une configuration d’hôte de la session est créée, les paramètres fournis pour la configuration sont vérifiés lors de la validation étendue. La validation peut échouer si le service conclut qu’il ne sera pas en mesure de garantir la création d’hôtes de la session avec les paramètres fournis. Dans la mesure où les ressources Azure sont stockées dans votre abonnement, elles peuvent être modifiées par d’autres processus. La création de l’hôte de la session peut toujours échouer quand vous utilisez la configuration de l’hôte de la session, même une fois ce contrôle de validation effectué.
Voici quelques exemples d’échecs :
Disponibilité de la machine virtuelle : la combinaison du nom de la référence SKU de machine virtuelle, de la région, de la zone de disponibilité et de l’abonnement n’est pas disponible. Les erreurs suivantes peuvent se produire :
VmSkuNotAvailableInRegion,VmSkuNotAvailableInRegionDueToRestrictionetAvailabilityZoneNotAvailable. Vous devez passer en revue la disponibilité des tailles de machine virtuelle et des zones de disponibilité pour votre quota de région et d’abonnement choisi et fournir une combinaison prise en charge. Utilisez la cmdlet PowerShellGet-AzComputeResourceSkupour identifier les restrictions pour une combinaison donnée d’une référence SKU et d’une région de machine virtuelle.Compatibilité des paramètres : la combinaison de la référence SKU de machine virtuelle, du disque, de l’image et du réseau virtuel n’est pas compatible. Les erreurs suivantes peuvent se produire :
ComputeSkuIncompatibleWithImageHyperVGeneration,ImageDiskTypeIncompatible,VnetLocationIncompatible. Passez en revue les conditions préalables pour Azure Virtual Desktop pour vous assurer que les paramètres fournis répondent aux exigences de la création d’un hôte de la session.
Si la configuration de l’hôte de la session ne se crée pas lors de la création d’un pool d’hôtes, vous ne pouvez pas en créer une pour ce pool d’hôtes à l’aide du portail Azure. Vous pouvez utiliser PowerShell pour créer la configuration de l’hôte de la session à l’aide de la cmdlet New-AzWvdSessionHostConfiguration. Vous pouvez également supprimer le pool d’hôtes et le recréer.
Erreur : SessionHostConfiguration n’existe pas
Si vous obtenez l’erreur : SessionHostConfiguration n’existe pas lors de l’utilisation de la cmdlet PowerShell Get-AzWvdSessionHostConfiguration, créez la configuration de l’hôte de la session à l’aide de la cmdlet New-AzWvdSessionHostConfiguration.
Erreurs durant l’ajout d’hôtes de session à un pool d’hôtes
Nous prenons uniquement en charge l’ajout d’hôtes de session à un pool d’hôtes avec une configuration d’hôte de la session via le portail Azure. La principale différence entre les pools d’hôtes utilisant une configuration d’hôte de session et les pools d’hôtes standard est que l’extension de jonction de domaine n’est pas utilisée avec la configuration d’hôte de la session. À la place, l’agent Azure Virtual Desktop effectue le processus de jonction de domaine. Cette méthode signifie que :
- Le déploiement de modèle ARM peut réussir même en cas d’échec de la jonction de domaine, ce qui rend les hôtes de session non sains.
- Les diagnostics d’échec de jonction de domaine sont disponibles dans le portail Azure parmi les détails de l’hôte de la session quand vous affichez la représentation JSON de l’intégrité de l’hôte de la session.
Si vous êtes confronté à des échecs de jonction de domaine et d’autres problèmes au moment de l’ajout d’hôtes de session au pool d’hôtes, vous pouvez suivre les conseils d’aide pour la résolution des problèmes liés aux hôtes de session.
Mises à jour ayant échoué
Lorsque vous mettez à jour les hôtes de la session à l’aide de la mise à jour de l’hôte de la session, il est possible qu’un hôte de la session individuel ne soit pas mis à jour. Dans ce cas, la mise à jour de l’hôte de la session tente de restaurer la mise à jour sur cet hôte de la session. L’intention de la restauration consiste à maintenir la capacité de l’ensemble du pool d’hôtes, même si cet hôte de la session est restauré vers une version précédente de la configuration de l’hôte de la session, plutôt que de forcer l’hôte de la session à être indisponible et à réduire la capacité du pool d’hôtes. Les autres hôtes de la session du pool d’hôtes qui ont été mis à jour ne sont pas restaurés. Les hôtes de la session qui n’ont pas démarré la mise à jour ne sont pas mis à jour.
Une fois qu’un hôte de la session ne parvient pas à être mis à jour, cet échec termine la mise jour du lot actuel des hôtes de la session, puis marque la mise à jour comme ayant échoué. Dans ce scénario, les seules options sont de réessayer la mise à jour ou de l’annuler. Si vous réessayez la mise à jour, la mise à jour de l’hôte de la session tente à nouveau de mettre à jour la session de l’hôte qui a échoué, ainsi que les hôtes de session restants qui n’ont pas déjà tenté. La taille de lot existante est utilisée.
Si un hôte de la session ne parvient pas à se restaurer, il n’est pas disponible pour accueillir la session et sa capacité est réduite. L’hôte de la session n’est pas le même que les autres hôtes de session du pool d’hôtes et il correspond à la configuration de l’hôte de la session. Vous devez rechercher la raison pour laquelle la mise à jour de l’hôte de la session a échoué et résoudre le problème avant de planifier une nouvelle mise à jour. Une fois que vous planifiez une nouvelle mise à jour, la mise à jour de l’hôte de la session tente de mettre à jour les hôtes de la session qui a échoué afin qu’ils correspondent tous, ainsi que tous les hôtes de la session qui n’ont pas été démarrés lors de la tentative de mise à jour précédente.
Une mise à jour peut échouer avec l’état suivant :
| Statut | Description |
|---|---|
| la mise à jour n’a pas pu être lancée ; | le flux de mise à jour est incorrect. Par exemple, une image incompatible avec la référence SKU de la machine virtuelle. Vous ne pouvez pas réessayer la mise à jour ; vous devez l’annuler et planifier une nouvelle mise à jour. |
| Échec de la mise à jour | La mise à jour a échoué lorsqu’elle était en cours. Si vous relancez la mise à jour, elle se poursuit avec l’hôte de session sur lequel elle s’est arrêtée précédemment. |
| Échec de la restauration de l’hôte de session | Si un hôte de la session ne parvient pas à être mis à jour, la mise à jour de cette hôte tente de restaurer la mise à jour sur cet hôte de la session. Si la restauration échoue et que vous essayez de relancez la mise à jour, elle se poursuit avec l’hôte de session sur lequel elle s’est arrêtée précédemment. |
Vous pouvez obtenir toutes les erreurs d’une mise à jour en suivant les étapes consistant à Surveiller la progression d’une mise à jour. Lorsque vous utilisez Azure PowerShell, la variable $updateProgress contient les détails de l’erreur dans les propriétés suivantes :
$updateProgress.PropertiesUpdateStatus$updateProgress.UpdateProgressError$updateProgress.UpdateProgressError.FaultText
une fois le problème identifié, vous pouvez soit réessayer la mise à jour, soit l’annuler et planifier une nouvelle mise à jour.
Une mise à jour n’a pas pu être lancée
Lorsqu’une mise à jour de l’hôte de la session est lancée, le service vérifie s’il sera en mesure de terminer la mise à jour. Lorsqu’une mise à jour de l’hôte de la session échoue avant le démarrage, la mise à jour se termine et les modifications peuvent être apportées à la configuration de l’hôte de la session. À mesure que les ressources Azure sont stockées dans votre abonnement, elles peuvent être modifiées par d’autres processus. La création d’un hôte de la session peut toujours échouer en utilisant sa configuration, même après que la vérification de la validation a été effectuée.
Voici quelques exemples d’échecs qui empêchent le démarrage d’une mise à jour :
Aucun hôte de la session à mettre à jour : l’erreur
HostpoolHasNoSessionHostsest renvoyée lorsqu'il n’y a pas d’hôte de la session à mettre à jour dans le cadre de la mise à jour de l’hôte de la session. Si vous n’avez pas apporté de modifications à la configuration de l’hôte de la session avant de lancer une mise à jour, cette erreur est renvoyée.Problèmes de capacité : la validation vérifie la capacité suffisante dans votre sous-réseau de réseau virtuel et le quota de cœurs de machine virtuelle. Cette vérification ne garantit pas la capacité durant une mise à jour. La création d’autres ressources en dehors de la mise à jour de l’hôte de la session peut entraîner des erreurs en cours de mise à jour, qui sont associées aux limites de capacité. Définissez la taille de votre lot dans le quota restant pour votre abonnement.
Cohérence des paramètres avec les hôtes de la session actuels : la mise à jour de l’hôte de la session ne prend pas en charge la modification de la région, de l’abonnement, du groupe de ressources ou du type de jonction de domaine pour un hôte de la session. Si la configuration de l’hôte de la session contient des propriétés dans ces champs qui diffèrent des hôtes de la session dans le pool d’hôtes, la mise à jour ne démarre pas. Vous devez supprimer les hôtes de la session incompatibles avec la configuration.
Échecs pendant une mise à jour
La mise à jour de l’hôte de session commence par une taille de lot initiale de 1 pour vérifier que la configuration de l’hôte de session fournie entraîne des hôtes de session sains. Les échecs qui se produisent durant le premier lot de validation sont le plus souvent dus à des paramètres au sein de la configuration de l’hôte de la session, et ne sont généralement pas résolus par une nouvelle tentative de mise à jour. Les défaillances qui se produisent après le lot de validation sont souvent intermittentes et peuvent être résolues en réessayant la mise à jour.
Voici quelques exemples d’échecs qui peuvent se produire pendant une mise à jour :
Échecs de création de machines virtuelles : la création de machines virtuelles peut échouer pour diverses raisons non spécifiques à Azure Virtual Desktop, par exemple l’épuisement de la capacité d’abonnement ou les problèmes liées à l’image fournie. Vous devez passer en revue le message d’erreur fourni pour déterminer la correction appropriée. Créez un ticket de support avec le support Azure si vous avez besoin d’aide supplémentaire.
L’installation de l’agent, la jonction de domaine et les erreurs d’intégrité de l’hôte de session ou du délai d’expiration : agent, jonction de domaine et autres erreurs d’intégrité de l’hôte de session qui se produisent dans le premier lot de validation peuvent souvent être résolues en examinant les conseils d’adressage des échecs de jonction de domaine et de déploiement pour Azure Virtual Desktop, et en vous assurant que l’extension PowerShell DSC n’est pas installée. Si l’extension est installée sur l’image, supprimez le dossier
C:\packages\pluginde l’image. Si l’échec est intermittent, certains hôtes de session ayant réussi à mettre à jour et d’autres rencontrent une erreur telle queAgentRegistrationFailureGeneric, une nouvelle tentative de mise à jour peut souvent résoudre le problème.Erreurs de modification et d’accès aux ressources : la modification des ressources qui sont affectées dans la mise à jour peut entraîner des erreurs lors d’une mise à jour. Certaines des erreurs pouvant entraîner la suppression des ressources et des groupes de ressources, les modifications apportées aux autorisations, les modifications apportées à l’état d’alimentation et les modifications apportées au mode maintenance peuvent être effectuées. En outre, si vos ressources Azure sont verrouillées et/ou si la stratégie Azure limite le service Azure Virtual Desktop à la modification de vos hôtes de la session, la mise à jour échoue. Passez en revue les journaux d’activité Azure si vous rencontrez des erreurs associées. Créez un ticket de support avec le support Azure si vous avez besoin d’aide supplémentaire.
Paramètres incompatibles passés à New-AzWvdSessionHostConfiguration
Vous pouvez transmettre des paramètres incompatibles à la cmdlet PowerShell New-AzWvdSessionHostConfiguration. Par exemple, si vous spécifiez le paramètre DomainInfoJoinType comme AzureActiveDirectory, mais que vous spécifiez également le paramètre ActiveDirectoryInfoDomainName avec un nom de domaine Active Directory, le nom de domaine est ignoré sans renvoyer d’erreur.