Ajouter et gérer des applications App Attach dans Azure Virtual Desktop

Voici comment ajouter une image MSIX, une image Appx ou un package App-V en tant que package App Attach à l’aide de la Portail Azure :

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 pour accéder à la vue d’ensemble d’Azure Virtual Desktop.

3. Sélectionnez Attachement d’application, puis + Créer.

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

   Paramètre	Description
   Abonnement	Sélectionnez l’abonnement auquel vous souhaitez ajouter une image MSIX, une image Appx ou un package App-V dans la liste déroulante.
   Groupe de ressources	Sélectionnez un groupe de ressources existant ou sélectionnez Créer et entrez un nom.
   Pool d’hôtes	Sélectionnez un pool d’hôtes existant dans la liste déroulante.
   Lieu	Sélectionnez la région Azure pour votre package App Attach.

   Une fois que vous avez terminé cet onglet, sélectionnez Suivant.

5. Sous l’onglet Chemin d’accès à l’image , renseignez les informations suivantes :

   Paramètre	Description
   Chemin d’accès à l’image	Sélectionnez Sélectionner à partir du compte de stockage si votre image est stockée dans Azure Files ou Entrer UNC pour spécifier un chemin d’accès UNC. Les champs suivants dépendent de l’option que vous sélectionnez.
   Sélectionner dans un compte de stockage
   Compte de stockage	Sélectionnez le compte de stockage dans lequel se trouve votre image.
   Partage de fichiers	Sélectionnez Sélectionner un fichier, puis accédez au partage de fichiers et au répertoire dans lequel se trouve votre image. Cochez la case en regard de l’image que vous souhaitez ajouter, par exemple MyApp.cim, puis sélectionnez Sélectionner.
   Package MSIX	Sélectionnez le package MSIX ou Appx dans l’image.
   Unc d’entrée
   UNC	Entrez le chemin UNC de votre fichier image.
   Package MSIX	Sélectionnez le package MSIX ou Appx dans l’image.
   L’une ou l’autre option
   Nom d’affichage	Entrez un nom convivial pour votre application.
   Version	Vérifiez que le numéro de version attendu est affiché.
   Type d’inscription	Sélectionnez le type d’inscription que vous souhaitez utiliser.
   État	Sélectionnez l’état initial du package.
   Case activée status d’intégrité en cas de défaillance	Sélectionnez le status pour le package s’il ne parvient pas à effectuer la phase sur un hôte de session. Cette status est signalée pour AppAttachHealthCheck pour le case activée status d’intégrité de l’hôte de session.

   Une fois que vous avez terminé cet onglet, sélectionnez Suivant.

   Conseil

   Une fois que vous avez terminé cet onglet, vous pouvez éventuellement continuer à affecter l’application à des pools hôtes, des utilisateurs et des groupes. Si vous souhaitez configurer des affectations séparément, sélectionnez Vérifier + créer, puis accédez à Attribuer un package d’attachement d’application.

6. Facultatif : sous l’onglet Affectations , renseignez les informations suivantes :

   1. Pour Pool d’hôtes, sélectionnez les pools d’hôtes auxquels vous souhaitez affecter l’application.

   2. Sélectionnez Ajouter des utilisateurs ou des groupes d’utilisateurs, puis recherchez et sélectionnez les utilisateurs ou groupes auxquels vous souhaitez affecter l’application. Une fois que vous avez terminé, sélectionnez Sélectionner.

   3. Passez en revue les affectations que vous avez ajoutées, puis sélectionnez Suivant.

7. Facultatif : sous l’onglet Étiquettes , vous pouvez entrer les paires nom/valeur dont vous avez besoin, puis sélectionner Vérifier + créer.

8. Sous l’onglet Vérifier + créer , vérifiez que la validation réussit et passez en revue les informations utilisées pendant le déploiement, puis sélectionnez Créer pour ajouter l’application.

Voici comment ajouter une image MSIX, une image Appx ou un package App-V en tant que package App Attach à l’aide du module PowerShell Az.DesktopVirtualization . Veillez à modifier les <placeholder> valeurs des vôtres.

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. Pendant la préversion, case activée que les applets de commande PowerShell sont disponibles en exécutant les commandes suivantes :

   Import-Module Az.DesktopVirtualization
   Get-Command -Module Az.DesktopVirtualization -Noun "*AppAttach*"
   

   Votre sortie doit ressembler à la sortie suivante :

   CommandType     Name                                               Version    Source
   -----------     ----                                               -------    ------
   Function        Get-AzWvdAppAttachPackage                          4.2.1      Az.DesktopVirtualization
   Function        Import-AzWvdAppAttachPackageInfo                   4.2.1      Az.DesktopVirtualization
   Function        New-AzWvdAppAttachPackage                          4.2.1      Az.DesktopVirtualization
   Function        Remove-AzWvdAppAttachPackage                       4.2.1      Az.DesktopVirtualization
   Function        Update-AzWvdAppAttachPackage                       4.2.1      Az.DesktopVirtualization
   

3. Obtenez les propriétés de l’image MSIX, de l’image Appx ou du package App-V que vous souhaitez ajouter et stockez-les dans une variable en exécutant la commande suivante. Vous devez spécifier un pool d’hôtes, mais il peut s’agir de n’importe quel pool d’hôtes dans lequel les hôtes de session ont accès au partage de fichiers.

   # Get the properties of the MSIX image, Appx image, or App-V package
   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       Path = '<UNCPathToFile>'
   }
   
   $app = Import-AzWvdAppAttachPackageInfo @parameters
   

4. Vérifiez que vous n’avez qu’un seul objet dans les propriétés de l’application en exécutant les commandes suivantes :

   $app | FL *
   

   Facultatif : si vous avez plusieurs objets dans la sortie, par exemple une version x64 et une version x86 de la même application, vous pouvez utiliser le paramètre PackageFullName pour spécifier l’application que vous souhaitez ajouter en exécutant les commandes suivantes :

   # Specify the package full name
   $packageFullName = '<PackageFullName>'
   
   # Get the properties of the application
   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       Path = '<UNCPathToFile>'
   }
   
   $app = Import-AzWvdAppAttachPackageInfo @parameters | ? ImagePackageFullName -like *$packageFullName*
   

5. Ajoutez l’image ou le package en tant que package App Attach en exécutant la commande suivante. Dans cet exemple, l’état de l’application est marqué comme actif, l’inscription de l’application est définie sur à la demande et l’intégrité de l’hôte de session case activée status en cas d’échec est définie sur NeedsAssistance :

   $parameters = @{
       Name = '<AppName>'
       ResourceGroupName = '<ResourceGroupName>'
       Location = '<AzureRegion>'
       FailHealthCheckOnStagingFailure = 'NeedsAssistance'
       ImageIsRegularRegistration = $false
       ImageDisplayName = '<AppDisplayName>'
       ImageIsActive = $true
   }
   
   New-AzWvdAppAttachPackage -AppAttachPackage $app @parameters
   

   Il n’y a pas de sortie lorsque le package est correctement ajouté.

6. Vous pouvez vérifier que le package est ajouté en exécutant les commandes suivantes :

   $parameters = @{
       Name = '<AppName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdAppAttachPackage @parameters | FL Name, ImagePackageApplication, ImagePackageFamilyName, ImagePath, ImageVersion, ImageIsActive, ImageIsRegularRegistration, SystemDataCreatedAt
   

   La sortie doit ressembler à l’exemple suivant :

   Name                       : My App
   ImagePackageApplication    : {MyApp}
   ImagePackageFamilyName     : MyApp_abcdef123ghij
   ImagePath                  : \\fileshare\Apps\MyApp\MyApp.cim
   ImageVersion               : 1.0.0.0
   ImageIsActive              : True
   ImageIsRegularRegistration : True
   SystemDataCreatedAt        : 7/31/2023 3:03:43 PM
   

Voici comment affecter un package d’application à des pools hôtes, des utilisateurs et des groupes à l’aide de la Portail Azure :

Pools d’hôtes

1. Dans la vue d’ensemble d’Azure Virtual Desktop, sélectionnez App Attach, puis sélectionnez le nom du package App Attach que vous souhaitez attribuer.

2. Dans la section Gérer, sélectionnez Pools d’hôtes :

3. Sélectionnez + Affecter, puis sélectionnez un ou plusieurs pools d’hôtes dans la liste déroulante. Assurez-vous que tous les hôtes de session du pool d’hôtes doivent disposer d’un accès en lecture avec leur compte d’ordinateur, comme indiqué dans les conditions préalables.

4. Sélectionnez Ajouter.

Groupes et utilisateurs

1. Dans la vue d’ensemble d’Azure Virtual Desktop, sélectionnez App Attach, puis sélectionnez le nom du package App Attach que vous souhaitez attribuer.

2. Dans la section Gérer, sélectionnez Utilisateurs :

3. Sélectionnez + Ajouter, puis sélectionnez un ou plusieurs groupes et/ou utilisateurs dans la liste.

4. Sélectionnez Sélectionner.

Voici comment affecter un package d’application à des pools hôtes ainsi qu’à des groupes et des utilisateurs à l’aide du module PowerShell Az.DesktopVirtualization .

Pools d’hôtes

1. Dans la même session PowerShell, obtenez les ID de ressource du ou des pools d’hôtes auquel vous souhaitez affecter l’application et ajoutez-les à un tableau en exécutant les commandes suivantes :

   # Add a comma-separated list of host pools names
   $hostPoolNames = "<HostPoolName1>","<HostPoolName2>"
   
   # Create an array and add the resource ID for each host pool
   $hostPoolIds = @()
   foreach ($hostPoolName in $HostPoolNames) {
       $hostPoolIds += (Get-AzWvdHostPool | ? Name -eq $hostPoolName).Id
   }
   

2. Une fois que vous avez les ID de ressource du ou des pools d’hôtes, vous pouvez leur attribuer le package d’application en exécutant les commandes suivantes :

   $parameters = @{
       Name = '<AppName>'
       ResourceGroupName = '<ResourceGroupName>'
       Location = '<AzureRegion>'
       HostPoolReference = $hostPoolIds
   }
   
   Update-AzWvdAppAttachPackage @parameters
   

3. Pour annuler l’affectation du package d’application de tous les pools d’hôtes, vous pouvez passer un tableau vide de pools d’hôtes en exécutant les commandes suivantes :

   $parameters = @{
       Name = '<AppName>'
       ResourceGroupName = '<ResourceGroupName>'
       Location = '<AzureRegion>'
       HostPoolReference = @()
   }
   
   Update-AzWvdAppAttachPackage @parameters
   

Groupes et utilisateurs

Voici comment affecter une application à des groupes et des utilisateurs à l’aide du module PowerShell Az.DesktopVirtualization .

1. Obtenez l’ID d’objet des groupes ou utilisateurs que vous souhaitez ajouter ou supprimer de l’application, puis ajoutez-les à un tableau à l’aide de l’un des exemples suivants. Nous vous recommandons d’affecter des applications à des groupes.

   1. Obtenez l’ID d’objet du ou des groupes et ajoutez-les à un tableau à en exécutant les commandes suivantes. Cet exemple utilise le nom complet du groupe :

      # Add a comma-separated list of group names
      $groups = "Group1","Group2"
      
      # Connect to Microsoft Graph
      Connect-MgGraph -Scopes 'Group.Read.All'
      
      # Create an array and add the ID for each group
      $Ids = @()
      
      foreach ($group in $groups) {
         $Ids += (Get-MgGroup | ? DisplayName -eq $group).Id
      }
      

   2. Obtenez l’ID d’objet du ou des utilisateurs et ajoutez-les à un tableau à en exécutant les commandes suivantes. Cet exemple utilise le nom d’utilisateur principal (UPN) :

      # Add a comma-separated list of user principal names
      $users = "user1@contoso.com","user2@contoso.com"
      
      # Connect to Azure AD
      Connect-MgGraph -Scopes 'User.Read.All'
      
      # Create an array and add the ID for each user
      $userIds = @()
      
      foreach ($user in $users) {
          $userIds += (Get-MgUser | ? UserPrincipalName -eq $user).Id
      }
      

2. Une fois que vous disposez des ID d’objet des utilisateurs ou groupes, vous pouvez les ajouter ou les supprimer de l’application à l’aide de l’un des exemples suivants, qui attribue le rôle RBAC utilisateur de virtualisation de bureau .

   1. Pour ajouter les groupes ou les utilisateurs à l’application, exécutez les commandes suivantes :

      $parameters = @{
         Name = '<AppName>'
         ResourceGroupName = '<ResourceGroupName>'
      }
      
      $appAttachPackage = Get-AzWvdAppAttachPackage @parameters
      
      foreach ($userId in $userIds) {
         New-AzRoleAssignment -ObjectId $userId -RoleDefinitionName "Desktop Virtualization User" -Scope $appAttachPackage.Id
      }
      

   2. Pour supprimer les groupes ou les utilisateurs de l’application, exécutez les commandes suivantes :

      $parameters = @{
         Name = '<AppName>'
         ResourceGroupName = '<ResourceGroupName>'
      }
      
      $appAttachPackage = Get-AzWvdAppAttachPackage @parameters
      
      foreach ($userId in $userIds) {
         Remove-AzRoleAssignment -ObjectId $userId -RoleDefinitionName "Desktop Virtualization User" -Scope $appAttachPackage.Id
      }
      

Voici comment modifier le type d’inscription et l’état d’un package à l’aide de la Portail Azure :

1. Dans la vue d’ensemble d’Azure Virtual Desktop, sélectionnez Attachement d’application. Vous devez voir une liste de tous les packages existants dans le pool d’hôtes.

2. Sélectionnez le nom du package que vous souhaitez modifier.

   1. Pour modifier le type d’inscription, sélectionnez À la demande ou S’inscrire lors de la connexion, puis sélectionnez Enregistrer.

   2. Pour modifier l’état, sélectionnez Inactif ou Actif, puis enregistrer.

Voici comment modifier le type d’inscription et l’état d’un package à l’aide du module PowerShell Az.DesktopVirtualization .

1. Dans la même session PowerShell, vous pouvez modifier le type d’inscription et l’état en exécutant les commandes suivantes :

   1. Modifiez le type d’inscription en exécutant la commande suivante. Définissez IsRegularRegistration la valeur $true pour s’inscrire lors de la connexion ou $false à la demande.

      $parameters = @{
          Name = '<Name>'
          ResourceGroupName = '<ResourceGroupName>'
          Location = '<AzureRegion>'
          IsRegularRegistration = $true
      }
      
      Update-AzWvdAppAttachPackage @parameters
      

   2. Modifiez l’état en exécutant la commande suivante. Définissez IsActive sur $true pour Actif ou $falsePour Inactif.

      $parameters = @{
          Name = '<Name>'
          ResourceGroupName = '<ResourceGroupName>'
          Location = '<AzureRegion>'
          IsActive = $true
      }
      
      Update-AzWvdAppAttachPackage @parameters
      

Voici comment ajouter une application à partir du package que vous avez ajouté dans cet article à un groupe d’applications RemoteApp à l’aide de la Portail Azure :

1. Dans la vue d’ensemble d’Azure Virtual Desktop, sélectionnez Groupes d’applications, puis sélectionnez le groupe d’applications RemoteApp auquel vous souhaitez ajouter une application.

2. Sélectionnez Applications, + Ajouter. Vérifiez qu’au moins un hôte de session est sous tension dans le pool d’hôtes auquel le groupe d’applications est affecté.

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

   Paramètre	Valeur/Description
   Source de l’application	Sélectionnez App Attach dans la liste déroulante. Si vous souhaitez ajouter des applications à partir du menu Démarrer ou en spécifiant un chemin d’accès de fichier, consultez Publier des applications avec RemoteApp.
   Colis	Sélectionnez un package disponible pour le pool d’hôtes dans la liste déroulante. Les packages régionaux proviennent de App Attach.
   Application	Sélectionnez une application dans la liste déroulante.
   Identificateur d’application	Entrez un identificateur unique pour l’application.
   Nom d’affichage	Entrez un nom convivial pour l’application destinée aux utilisateurs.
   Description	Entrez une description pour l’application.

   Une fois que vous avez terminé cet onglet, sélectionnez Suivant.

4. Sous l’onglet Icône , sélectionnez Par défaut pour utiliser l’icône par défaut de l’application, ou sélectionnez Chemin d’accès au fichier pour utiliser une icône personnalisée. Pour Chemin d’accès au fichier, sélectionnez l’une des options suivantes :

   • Parcourez Azure Files pour utiliser une icône à partir d’un partage de fichiers Azure. Sélectionnez Sélectionner un compte de stockage , sélectionnez le compte de stockage contenant votre fichier d’icônes, puis sélectionnez Sélectionner le fichier d’icône. Accédez au partage de fichiers et au répertoire dans lequel se trouve votre icône, case activée la zone en regard de l’icône que vous souhaitez ajouter, par exemple MyApp.ico, puis sélectionnez Sélectionner. Vous pouvez également utiliser un .png fichier. Pour Index d’icône, spécifiez le numéro d’index de l’icône que vous souhaitez utiliser. Ce nombre est généralement 0.

   • Chemin d’accès au fichier UNC pour utiliser une icône à partir d’un partage de fichiers. Pour Chemin d’accès à l’icône, entrez le chemin UNC de votre fichier d’icône, par exemple \\MyFileShare\MyApp.ico. Vous pouvez également utiliser un .png fichier. Pour Index d’icône, spécifiez le numéro d’index de l’icône que vous souhaitez utiliser. Ce nombre est généralement 0.

   Une fois que vous avez terminé cet onglet, sélectionnez Vérifier + ajouter.

5. Sous l’onglet Vérifier + ajouter , vérifiez que la validation réussit et passez en revue les informations utilisées pour ajouter l’application, puis sélectionnez Ajouter pour ajouter l’application au groupe d’applications RemoteApp.

Voici comment ajouter une application à partir du package que vous avez ajouté dans cet article à un groupe d’applications RemoteApp à l’aide du module PowerShell Az.DesktopVirtualization .

1. Dans la même session PowerShell, s’il existe plusieurs applications dans le package, vous devez obtenir l’ID d’application de l’application que vous souhaitez ajouter à partir du package en exécutant les commandes suivantes :

   Write-Host "These are the application IDs available in the package. Many packages only contain one application." -ForegroundColor Yellow
   $app.ImagePackageApplication.AppId
   

2. Notez l’ID d’application que vous souhaitez publier (par exemple App), puis exécutez les commandes suivantes pour ajouter l’application au groupe d’applications RemoteApp :

   $parameters = @{
       Name = '<ApplicationName>'
       ApplicationType = 'MsixApplication'
       MsixPackageFamilyName = $app.ImagePackageFamilyName
       MsixPackageApplicationId = '<ApplicationID>'
       GroupName = '<ApplicationGroupName>'
       ResourceGroupName = '<ResourceGroupName>'
       CommandLineSetting = 'DoNotAllow'
   }
   
   New-AzWvdApplication @parameters
   

3. Vérifiez la liste des applications dans le groupe d’applications en exécutant les commandes suivantes :

   $parameters = @{
       GroupName = '<ApplicationGroupName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdApplication @parameters
   

Voici comment mettre à jour un package existant à l’aide de la Portail Azure :

1. Dans la vue d’ensemble d’Azure Virtual Desktop, sélectionnez Attachement d’application. Vous devez voir une liste de tous les packages existants.

2. Sélectionnez le package que vous souhaitez mettre à jour, puis, dans la vue d’ensemble, sélectionnez Mettre à jour.

3. Entrez les informations pour le package mis à jour :

   1. L’abonnement et le groupe de ressources sont préremplis avec les valeurs du package actuel.

   2. Sélectionnez le pool d’hôtes pour lequel vous souhaitez mettre à jour le package.

   3. Sélectionnez le chemin d’accès de l’image à partir du compte de stockage ou Entrée UNC. Les champs suivants dépendent de l’option que vous sélectionnez.

      1. Pour Sélectionner à partir du compte de stockage, sélectionnez le compte de stockage contenant l’image mise à jour. Sélectionnez Sélectionner un fichier, puis accédez au partage de fichiers et au répertoire dans lequel se trouve votre image. Cochez la case en regard de l’image que vous souhaitez ajouter, par exemple MyApp.cim, puis sélectionnez Sélectionner.
      2. Pour Entrée UNC, entrez le chemin UNC de votre fichier image.

   4. Pour package MSIX, sélectionnez le package MSIX ou Appx dans l’image.

4. Une fois que vous avez terminé les champs, sélectionnez Mettre à jour.

Voici comment mettre à jour un package existant à l’aide du module PowerShell Az.DesktopVirtualization .

1. Dans la même session PowerShell, obtenez les propriétés de l’application mise à jour et stockez-les dans une variable en exécutant les commandes suivantes :

   # Get the properties of the application
   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       Path = '<UNCPathToFile>'
   }
   
   $app = Import-AzWvdAppAttachPackageInfo @parameters
   

2. Vérifiez que vous n’avez qu’un seul objet dans les propriétés de l’application en exécutant les commandes suivantes :

   $app | FL *
   

   Si vous avez plusieurs objets dans la sortie, par exemple une version x64 et une version x86 de la même application, vous pouvez utiliser le paramètre PackageFullName pour spécifier celui que vous souhaitez ajouter en exécutant les commandes suivantes :

   # Specify the package full name
   $packageFullName = '<PackageFullName>'
   
   # Get the properties of the application
   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       Path = '<UNCPathToFile>'
   }
   
   $app = Import-AzWvdAppAttachPackageInfo @parameters | ? ImagePackageFullName -like *$packageFullName*
   

3. Mettez à jour un package existant en exécutant la commande suivante. La nouvelle image disque remplace l’image existante, mais les affectations existantes sont conservées. Ne supprimez pas l’image existante tant que les utilisateurs n’ont pas cessé de l’utiliser.

   $parameters = @{
       Name = '<PackageName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Update-AzWvdAppAttachPackage -AppAttachPackage $app @parameters
   

Voici comment supprimer un package App Attach à l’aide de la Portail Azure :

1. Dans la vue d’ensemble d’Azure Virtual Desktop, sélectionnez Attachement d’application. Vous devez voir une liste de tous les packages existants.

2. Cochez la case en regard du nom du package que vous souhaitez supprimer, puis sélectionnez Supprimer. Le package est également supprimé de tous les pools d’hôtes auxquels il est affecté.

Voici comment supprimer un package App Attach à l’aide du module PowerShell Az.DesktopVirtualization .

1. Dans la même session PowerShell, exécutez la commande suivante pour supprimer le package contenant une application :

   $parameters = @{
       Name = '<PackageName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Remove-AzWvdAppAttachPackage @parameters