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 de l’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 parvient pas à créer correctement des hôtes de session avec les paramètres fournis. À mesure que 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 session peut toujours échouer lors de l’utilisation de la configuration de l’hôte de session, même après la fin de cette vérification de validation.
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. Certaines des erreurs sont provoquées, notamment
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. Certaines des erreurs sont provoquées, notamment
ComputeSkuIncompatibleWithImageHyperVGeneration,ImageDiskTypeIncompatible.VnetLocationIncompatiblePassez 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 session ne parvient pas à être mis à jour, la mise à jour de l’hôte de session termine la mise à jour du lot actuel des hôtes de session, puis marque la mise à jour comme ayant échoué. Dans ce scénario, la seule option consiste à réessayer la mise à jour ou à l’annuler. Si vous réessayez la mise à jour, la mise à jour de l’hôte de session tente à nouveau de mettre à jour les hôtes de session qui ont échoué et les hôtes de session restants qui n’ont pas été tentés précédemment. 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 session n’est pas identique à l’autre hôte de session dans le pool d’hôtes et correspond à la configuration de l’hôte de 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 session tente de mettre à jour les hôtes de session qui ont échoué afin qu’ils correspondent tous et tous les hôtes de 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 session est lancée, le service vérifie s’il est en mesure de terminer la mise à jour. Lorsqu’une mise à jour de l’hôte de session échoue avant de commencer, la mise à jour se termine et les modifications peuvent être apportées à la configuration de l’hôte de session. À mesure que 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 session peut toujours échouer à utiliser la configuration de l’hôte de session même après la fin de cette vérification de validation.
Voici quelques exemples d’échecs qui empêchent le démarrage d’une mise à jour :
Aucun hôte de session à mettre à jour
L’erreur
HostpoolHasNoSessionHostsest retournée lorsqu’il n’existe aucun hôte de session à mettre à jour dans le cadre de la mise à jour de l’hôte de session. Si vous n’avez pas apporté de modifications à la configuration de l’hôte de session avant de lancer une mise à jour, cette erreur est retourné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 session actuels
La mise à jour de l’hôte de 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 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 d’une 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 machine virtuelle
La création d’une machine virtuelle peut échouer pour différentes raisons qui ne sont pas spécifiques à Azure Virtual Desktop. Par exemple, l’épuisement de la capacité de l’abonnement ou les problèmes liés à 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.
Installation de l’agent, jonction de domaine et erreurs d’intégrité de l’hôte de session ou expiration du délai d’attente
Les erreurs d’intégrité de l’agent, de la jonction de domaine et d’autres hôtes de session qui se produisent dans le premier lot de validation peuvent souvent être résolues en examinant les instructions relatives au déploiement et aux échecs de jointure de domaine pour Azure Virtual Desktop, et en garantissant que l’extension PowerShell DSC n’est pas installée. Si l’extension est installée sur l’image, supprimez le dossier C :\packages\plugin de l’image. Si l’échec est intermittent, certains hôtes de session ayant réussi à mettre à jour et d’autres rencontrent une erreur telle que
AgentRegistrationFailureGeneric, 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 affectées dans la mise à jour peut entraîner des erreurs lors d’une mise à jour. Certaines erreurs sont provoquées, notamment la suppression de ressources et de groupes de ressources, les modifications apportées aux autorisations, les modifications apportées à l’état d’alimentation et les modifications apportées au mode de drainage. En outre, si vos ressources Azure sont verrouillées ou que la stratégie Azure limite le service Azure Virtual Desktop à la modification de vos hôtes de 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 en tant que 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 retourner d’erreur.