Mettre à jour les hôtes de session à l’aide de la mise à jour de l’hôte de session dans Azure Virtual Desktop (préversion)

Voici comment planifier une nouvelle mise à jour pour vos hôtes de session à l’aide de la Portail Azure.

1. Connectez-vous au Portail Azure.

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

3. Sélectionnez Pools d’hôtes, puis sélectionnez le pool d’hôtes avec une configuration d’hôte de session que vous souhaitez mettre à jour.

4. Sélectionnez Hôtes de session.

5. Si vous souhaitez passer en revue la configuration de l’hôte de session avant de planifier une mise à jour, sélectionnez Gérer la configuration de l’hôte de session, puis Afficher. Une fois que vous avez examiné la configuration de l’hôte de session, sélectionnez Annuler.

6. Pour planifier une nouvelle mise à jour, sélectionnez Gérer la mise à jour de l’hôte de session, puis sélectionnez Nouvelle mise à jour. Vous pouvez également sélectionner Gérer la configuration de l’hôte de session, puis Modifier.

7. Sous l’onglet Informations de base , renseignez les informations suivantes :

   Paramètre	Valeur/Description
   Taille actuelle du pool d’hôtes (en lecture seule)	Nombre d’hôtes de session dans votre pool d’hôtes.
   Taille de lot de machine virtuelle autorisée à être supprimée du pool d’hôtes pendant la mise à jour	Nombre maximal d’hôtes de session qui sont mis à jour à la fois. Lorsque la mise à jour démarre, un seul hôte de session, appelé initial, est d’abord mis à jour pour vérifier le processus de mise à jour avant de mettre à jour les hôtes de session restants par lots. Si la mise à jour de l’initial échoue, la mise à jour s’arrête.
   Hôtes de session disponibles pendant la mise à jour (en lecture seule)	Nombre minimal d’hôtes de session disponibles pour les sessions utilisateur pendant la mise à jour.

   Une fois que vous avez terminé cet onglet, sélectionnez Suivant : Hôtes de session.

8. Sous l’onglet Hôtes de session, vous pouvez éventuellement mettre à jour les paramètres suivants dans la configuration de votre hôte de session :

   Paramètre	Valeur/Description
   Type de sécurité	Sélectionnez parmi Standard, Machines virtuelles de lancement approuvées ou Machines virtuelles confidentielles. - Si vous sélectionnez Lancer des machines virtuelles approuvées, les options de démarrage sécurisé et vTPM sont automatiquement sélectionnées. - Si vous sélectionnez Machines virtuelles confidentielles, les options de démarrage sécurisé, de vTPM et de surveillance de l’intégrité sont automatiquement sélectionnées. Vous ne pouvez pas désactiver vTPM lors de l’utilisation d’une machine virtuelle confidentielle.
   Image	Sélectionnez l’image de système d’exploitation que vous souhaitez utiliser dans la liste, ou sélectionnez Afficher toutes les images pour en voir plus, y compris les images personnalisées que vous avez créées et stockées en tant qu’image partagée azure Compute Gallery ou image managée.
   Taille de la machine virtuelle	Sélectionnez une référence SKU recommandée dans la liste. Si vous souhaitez utiliser une autre référence SKU, sélectionnez Afficher toutes les tailles, puis sélectionnez dans la liste.
   Type de disque du système d’exploitation	Sélectionnez le type de disque à utiliser pour vos hôtes de session. Nous vous recommandons d’utiliser ssd Premium pour les charges de travail de production. Le type de disque doit être pris en charge sur la famille de machines virtuelles et la taille sélectionnées. Veillez à sélectionner une combinaison prise en charge par Le calcul Azure. Le nom du disque du système d’exploitation des hôtes de session mis à jour a un nouveau nom au format SessionHostName-DateTime_Hash.
   Domaine pour la jonction
   Sélectionnez le répertoire que vous souhaitez rejoindre	Sélectionnez Microsoft Entra ou Active Directory. Si vous utilisez Active Directory, sélectionnez le coffre de clés qui contient les secrets du nom d’utilisateur et du mot de passe du compte de jonction de domaine. Vous pouvez éventuellement spécifier un nom de domaine et un chemin d’unité d’organisation.
   Compte administrateur de machine virtuelle	Complétez les paramètres appropriés en sélectionnant le coffre de clés et le secret pour le nom d’utilisateur et le mot de passe du compte d’administrateur local des machines virtuelles hôtes de session mises à jour. Le nom d’utilisateur et le mot de passe doivent répondre aux exigences pour les machines virtuelles Windows dans Azure.
   Configuration personnalisée
   URL du script de configuration personnalisée	Si vous souhaitez exécuter un script PowerShell pendant le déploiement, vous pouvez entrer l’URL ici.

   Une fois que vous avez examiné ou terminé d’apporter des modifications à la configuration de l’hôte de session, sélectionnez Suivant : Planification.

9. Sous l’onglet Planification, case activée la zone Planifier la mise à jour maintenant, ou sélectionnez une date, une heure et un fuseau horaire que vous souhaitez que la mise à jour démarre, jusqu’à un maximum de deux semaines à partir de l’heure actuelle.

   Une fois que vous avez défini votre planification, sélectionnez Suivant : Notifications.

10. Sous l’onglet Notifications , renseignez les informations suivantes :

    Paramètre	Valeur/Description
    Minutes avant que les utilisateurs ne soient déconnectés	Délai d’attente après l’heure de début de la mise à jour pour que les utilisateurs soient avertis de se déconnecter. Cette valeur est configurable entre 0 et 60 minutes. Les utilisateurs seront automatiquement déconnectés après ce temps écoulé.
    Message de déconnexion	Un message que vous pouvez spécifier pour informer les utilisateurs que l’hôte de session qu’ils utilisent est sur le point de commencer la mise à jour.

    Une fois cet onglet terminé, sélectionnez Suivant : Révision.

11. Sous l’onglet Révision , vérifiez que la validation réussit et passez en revue les informations utilisées pendant la mise à jour.

12. Sélectionnez Mettre à jour pour planifier la mise à jour. Lorsque vous affichez la liste des hôtes de session, la colonne Version actuelle affiche l’horodatage de la version de la configuration de l’hôte de session que l’hôte de session utilise. Si la colonne Version actuelle comporte une icône d’avertissement, cela signifie que l’horodatage de la version dans la colonne Version cible est ultérieur et que l’hôte de session doit être mis à jour.

Voici comment planifier une nouvelle mise à jour pour vos hôtes de session à l’aide du module PowerShell Az.DesktopVirtualization . Lorsque vous planifiez une mise à jour, la configuration de l’hôte de session pour le pool d’hôtes est utilisée. Vous devez apporter des modifications à la configuration de l’hôte de session avant de planifier une mise à jour.

Vous pouvez mettre à jour la stratégie de gestion de l’hôte de session avant de planifier une mise à jour, où les modifications sont conservées pour une utilisation ultérieure. Vous pouvez également remplacer les valeurs de la stratégie de gestion de l’hôte de session lors de la planification d’une mise à jour, mais elles s’appliquent uniquement à cette mise à jour.

1. Ouvrez Azure Cloud Shell dans le Portail Azure avec le type de terminal PowerShell ou exécutez PowerShell sur votre appareil local.

   • Si vous utilisez Cloud Shell, vérifiez que votre contexte Azure est défini sur l’abonnement que vous souhaitez utiliser.

   • Si vous utilisez PowerShell localement, commencez par vous connecter avec Azure PowerShell, puis vérifiez que votre contexte Azure est défini sur l’abonnement que vous souhaitez utiliser.

2. Utilisez l’applet Update-AzWvdSessionHostConfiguration de commande pour mettre à jour la configuration de l’hôte de session, où vous devez uniquement spécifier les paramètres que vous souhaitez modifier. Voici quelques exemples de commandes :

   • Pour spécifier une autre image personnalisée que vos hôtes de session doivent utiliser, exécutez la commande suivante. Pour plus d’informations sur la recherche des valeurs de l’image de la Place de marché, consultez Rechercher et utiliser des images de machine virtuelle de la Place de marché Azure avec Azure PowerShell.

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          ImageInfoType = 'Custom'
          CustomInfoResourceID  = '/subscriptions/<SubscriptionID>/resourceGroups/<ResourceGroupName>/providers/Microsoft.Compute/galleries/<GalleryName>/images/<ImageName>/versions/<ImageVersion>'
     }
     
     Update-AzWvdSessionHostConfiguration @parameters
     

   • Pour modifier le coffre de clés et le secret qui stocke le mot de passe du compte d’administrateur local, exécutez la commande suivante :

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          VMAdminCredentialsUsernameKeyVaultSecretUri = 'https://<VaultName>.vault.azure.net/secrets/<SecretName>/<Version>'
          VMAdminCredentialsPasswordKeyVaultSecretUri = 'https://<VaultName>.vault.azure.net/secrets/<SecretName>/<Version>'
     }
     
     Update-AzWvdSessionHostConfiguration @parameters
     

   • Pour modifier la taille de la machine virtuelle en D8s_v5 et le type de disque de système d’exploitation en SSD Premium, exécutez la commande suivante. Le nom du disque du système d’exploitation des hôtes de session mis à jour a un nouveau nom au format SessionHostName-DateTime_Hash.

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          VMSizeId = 'Standard_D8s_v5'
          DiskInfoType = 'Premium_LRS'
     }
     
     Update-AzWvdSessionHostConfiguration @parameters
     

   Affichez la configuration de l’hôte de session pour vérifier les modifications en exécutant la commande suivante :

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdSessionHostConfiguration @parameters | FL *
   

3. Facultatif : si vous souhaitez mettre à jour la stratégie de gestion de l’hôte de session avant de planifier une mise à jour, exécutez la commande suivante à l’aide de l’applet de Update-AzWvdSessionHostManagement commande . Vous pouvez également remplacer des valeurs spécifiques lors de la planification d’une mise à jour, qui sont utilisées uniquement pour cette mise à jour. Pour connaître les valeurs de fuseau horaire valides, consultez Référence PowerShell Get-TimeZone et utilisez la valeur de la StandardName propriété . Nous vous recommandons de définir UpdateDeleteOriginalVM = $true afin que vous n’ayez pas besoin d’propre ressources de l’hôte de session après une mise à jour.

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       ScheduledDateTimeZone = '<TimeZoneID>'
       UpdateDeleteOriginalVM = <$true or $false>
       UpdateMaxVmsRemoved = '<Quantity>'
       UpdateLogOffDelayMinute = '<Minutes>'
       UpdateLogOffMessage = '<Message>'
   }
   
   Update-AzWvdSessionHostManagement @parameters
   

   Vous pouvez afficher les propriétés de la stratégie de gestion de l’hôte de session mise à jour en exécutant la commande suivante :

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdSessionHostManagement @parameters
   

4. Pour planifier une mise à jour, utilisez l’applet de Invoke-AzWvdInitiateSessionHostUpdate commande avec les exemples suivants. Vous pouvez planifier le démarrage immédiat d’une mise à jour ou spécifier l’heure à laquelle vous souhaitez que la mise à jour démarre, jusqu’à un maximum de deux semaines. Voici quelques exemples de commandes :

   • Pour planifier un démarrage immédiat d’une mise à jour et utiliser les valeurs de la stratégie de gestion de l’hôte de session, exécutez la commande suivante :

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
     }
     
     $update = Invoke-AzWvdInitiateSessionHostUpdate @parameters
     

   • Pour planifier une mise à jour à une heure et une date spécifiées (au format AAAA-MM-JJ HH :mm) et utiliser les valeurs de la stratégie de gestion de l’hôte de session, exécutez la commande suivante.

     $dateTime = Get-Date -Date "2024-03-15 01:30"
     
     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          ScheduledDateTime = $dateTime
     }
     
     $update = Invoke-AzWvdInitiateSessionHostUpdate @parameters
     

   • Pour démarrer une mise à jour planifiée, exécutez la commande suivante :

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          Action = Start
     }
     
     $update = Invoke-AzWvdInitiateSessionHostUpdate @parameters
     

5. Vous pouvez afficher les propriétés de la mise à jour planifiée en exécutant la commande suivante :

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdSessionHostManagementsUpdateStatus @parameters | FL *
   

Voici comment surveiller la progression d’une mise à jour à l’aide de la Portail Azure.

1. Dans la vue d’ensemble d’Azure Virtual Desktop, sélectionnez Pools d’hôtes, puis sélectionnez le pool d’hôtes pour lequel vous avez planifié une mise à jour.

2. Sélectionnez Hôtes de session.

3. Une bannière bleue fournit les status de la mise à jour. Il n’affiche qu’un point dans le temps. Vous devez donc sélectionner Actualiser pour case activée la dernière progression.

Si vous avez choisi de démarrer la mise à jour immédiatement, le message indique que la mise à jour est planifiée pendant qu’elle commence, mais ce message est mis à jour une fois que vous l’actualisez. Pendant une mise à jour, vous voyez le nombre de tailles de lot des hôtes de session qui sont supprimés du pool d’hôtes pendant la mise à jour.

Voici comment surveiller la progression d’une mise à jour à l’aide du module PowerShell Az.DesktopVirtualization .

À partir de votre session PowerShell existante, utilisez l’applet Get-AzWvdSessionHostManagementsUpdateStatus de commande avec les exemples suivants pour obtenir les détails de la mise à jour actuelle.

• Pour voir la progression de la dernière mise à jour, exécutez les commandes suivantes :

  $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
  }
  
  $updateProgress = Get-AzWvdSessionHostManagementsUpdateStatus @parameters |
       FL PercentComplete,
       ProgressExecutionStartTime,
       ProgressSessionHostsCompleted,
       ProgressSessionHostsInProgress,
       ProgressSessionHostsRollbackFailed,
       ProgressTotalSessionHost,
       EndTime
  
  $updateProgress
  

• Pour afficher tous les paramètres de la dernière mise à jour, exécutez la commande suivante :

  $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
  }
  $updateProgress = Get-AzWvdSessionHostManagementsUpdateStatus @parameters | FL *
  
  $updateProgress
  

Voici comment suspendre, reprendre, annuler ou réessayer une mise à jour à l’aide de la Portail Azure.

1. Dans la vue d’ensemble d’Azure Virtual Desktop, sélectionnez Pools d’hôtes, puis sélectionnez le pool d’hôtes pour lequel vous avez planifié une mise à jour.

2. Sélectionnez Hôtes de session, puis Gérer la mise à jour de l’hôte de session.

3. Sélectionnez Suspendre, Reprendre, Annuler ou Réessayer en fonction de l’état actuel de la mise à jour.

4. Sélectionnez Actualiser pour mettre à jour le message status dans la bannière bleue. L’affichage de la bonne status peut prendre environ 20 secondes.

Voici comment suspendre, reprendre, annuler ou réessayer une mise à jour à l’aide du module PowerShell Az.DesktopVirtualization .

À partir de votre session PowerShell existante, utilisez l’applet Invoke-AzWvdControlSessionHostUpdate de commande avec les exemples suivants pour suspendre ou reprendre la mise à jour actuelle.

1. Tout d’abord, case activée le status de mise à jour en exécutant la commande suivante :

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdSessionHostManagementsUpdateStatus @parameters | FL Status
   

2. Selon l’action que vous souhaitez effectuer, utilisez l’un des exemples suivants.

   • Pour suspendre une mise à jour, exécutez la commande suivante :

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          Action = 'Pause'
     }
     
     Invoke-AzWvdControlSessionHostUpdate @parameters
     

   • Pour reprendre la mise à jour, exécutez la commande suivante :

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          Action = 'Resume'
     }
     
     Invoke-AzWvdControlSessionHostUpdate @parameters
     

   • Pour annuler une mise à jour et inclure un message, exécutez la commande suivante :

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          Action = 'Cancel'
          CancelMessage = '<Message>'
     }
     
     Invoke-AzWvdControlSessionHostUpdate @parameters
     

   • Pour réessayer une mise à jour, exécutez la commande suivante :

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          Action = 'Retry'
     }
     
     Invoke-AzWvdControlSessionHostUpdate @parameters
     

3. Vérifiez l’action de mise à jour et status après avoir effectué une action en exécutant la commande suivante :

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdSessionHostManagementsUpdateStatus @parameters | FL Action, Status