Agregar y administrar aplicaciones de App Attach en Azure Virtual Desktop

Este es el modo de agregar una imagen MSIX, una imagen Appx o un paquete de App-V como un paquete de conexión de aplicaciones mediante Azure Portal:

1. Inicie sesión en el portal de Azure.

2. En la barra de búsqueda, escriba Azure Virtual Desktop y seleccione la entrada de servicio correspondiente para ir a la información general de Azure Virtual Desktop.

3. Seleccione Asociación de aplicaciones y, a continuación, seleccione + Crear.

4. En la pestaña Aspectos básicos , complete la siguiente información:

   Parámetro	Description
   Suscripción	Seleccione la suscripción a la que desea agregar una imagen MSIX, una imagen Appx o un paquete de App-V en la lista desplegable.
   Grupo de recursos	Seleccione un grupo de recursos existente o seleccione Crear nuevo y escriba un nombre.
   Grupo de hosts	Seleccione un grupo de hosts existente en la lista desplegable.
   Ubicación	Seleccione la región de Azure para el paquete de conexión de aplicaciones. El ámbito de implementación del paquete se hereda del grupo de hosts que selecciones y, para un grupo de hosts con un ámbito de implementación de Regional, la ubicación debe coincidir con la región de Azure del grupo de hosts.

   Una vez que hayas completado esta pestaña, selecciona Siguiente.

5. En la pestaña Ruta de la imagen, complete la siguiente información:

   Parámetro	Description
   Ruta de la imagen	Seleccione entre Seleccione de la cuenta de almacenamiento si la imagen está almacenada en Azure Files o en la UNC de entrada para especificar una ruta de acceso UNC. Los campos posteriores dependen de la opción que seleccione.
   Seleccionar desde la cuenta de almacenamiento
   Cuenta de almacenamiento	Selecciona la cuenta de almacenamiento en la que se encuentra la imagen.
   Compartir archivos	Seleccione Seleccione un archivo y, a continuación, busque el recurso compartido de archivos y el directorio en el que se encuentra la imagen. Active la casilla situada junto a la imagen que desea agregar, por ejemplo MyApp.cim, y, a continuación, seleccione Seleccionar.
   Paquete MSIX	Seleccione el paquete MSIX o Appx de la imagen.
   UNC de entrada
   UNC	Escriba la ruta de acceso UNC al archivo de imagen.
   Paquete MSIX	Seleccione el paquete MSIX o Appx de la imagen.
   Cualquiera de las opciones
   Nombre para mostrar	Escriba un nombre descriptivo para la aplicación.
   Versión	Compruebe que se muestra el número de versión esperado.
   Tipo de registro	Seleccione el tipo de registro que quiera usar.
   Estado	Seleccione el estado inicial del paquete.
   Estado de comprobación de estado en caso de error	Seleccione el estado del paquete si no se puede almacenar provisionalmente en un host de sesión. Este estado se notifica para AppAttachHealthCheck para el estado de comprobación de estado del host de sesión.

   Una vez que hayas completado esta pestaña, selecciona Siguiente.

   Sugerencia

   Una vez que haya completado esta pestaña, puede continuar asignando opcionalmente la aplicación a grupos de hosts, usuarios y adscritos. Como alternativa, si quieres configurar tareas por separado, selecciona Revisar + crear y, a continuación, ve a Asignar un paquete de App Att.

6. Opcional: En la pestaña Tareas , complete la siguiente información:

   1. En Grupo de hosts, seleccione los grupos de hosts a los que desea asignar la aplicación.

   2. Seleccione Agregar usuarios o grupos de usuarios y, a continuación, busque y seleccione los usuarios o grupos a los que desea asignar la aplicación. Cuando haya terminado, seleccione Seleccionar.

   3. Revisa las tareas que has agregado y selecciona Siguiente.

7. Opcional: en la pestaña Etiquetas , puede escribir los pares de nombre y valor que necesite y, a continuación, seleccionar Revisar + crear.

8. En la pestaña Revisar + crear , asegúrese de que se supera la validación y revise la información que se usa durante la implementación y, a continuación, seleccione Crear para agregar la aplicación.

Aquí se explica cómo agregar una imagen MSIX, una imagen Appx o un paquete de App-V como un paquete de conexión de aplicaciones mediante el módulo Az.DesktopVirtualization de PowerShell. Asegúrese de cambiar los <placeholder> valores por su cuenta.

1. Abra Azure Cloud Shell en el Azure Portal con el tipo de terminal PowerShell o ejecute PowerShell en el dispositivo local.

   • Si usa Cloud Shell, asegúrese de que el contexto de Azure esté establecido en la suscripción que desea usar.

   • Si usa PowerShell localmente, primero inicie sesión con Azure PowerShell y, después, asegúrese de que el contexto de Azure está establecido en la suscripción que desea usar.

2. Durante la versión preliminar, compruebe que tiene disponibles los cmdlets de PowerShell ejecutando los comandos siguientes:

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

   La salida debe ser similar a la siguiente:

   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. Obtenga las propiedades de la imagen MSIX, la imagen Appx o el paquete de App-V que desea agregar y almacénelas en una variable ejecutando el comando siguiente. Debe especificar un grupo de hosts, pero puede ser cualquier grupo de hosts en el que los hosts de la sesión tengan acceso al recurso compartido de archivos.

   # 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. Compruebe que solo tiene un objeto en las propiedades de la aplicación ejecutando los siguientes comandos:

   $app | FL *
   

   Opcional: Si tiene más de un objeto en la salida, por ejemplo, una versión x64 y x86 de la misma aplicación, puede utilizar el parámetro PackageFullName para especificar qué aplicación desea agregar ejecutando los siguientes comandos:

   # 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. Agregue la imagen o el paquete como un paquete de conexión de aplicaciones ejecutando el siguiente comando. En este ejemplo, el estado de la aplicación se marca como activo, el registro de la aplicación se establece en A petición y el estado de la comprobación de estado del host de la sesión en caso de error se establece en NeedsAssistance:

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

   No hay salida cuando el paquete se agrega correctamente.

6. Puedes comprobar que el paquete se agrega ejecutando los siguientes comandos:

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

   El resultado debería ser similar al del ejemplo siguiente:

   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
   

Este es el procedimiento para asignar un paquete de aplicación a grupos de hosts, usuarios y grupos mediante Azure Portal:

Grupo de hosts

1. En la Información general de Azure Virtual Desktop, seleccione App Attach y, después, seleccione el nombre del paquete de App Attach que desea asignar.

2. En la sección Administrar, seleccione Grupos de hosts:

3. Seleccione + Asignar y, a continuación, seleccione uno o varios grupos de hosts en la lista desplegable. Asegúrese de que todos los hosts de sesión del grupo de hosts deben tener acceso de lectura con su cuenta de equipo, como se indica en los requisitos previos.
   Solo puede asignar un paquete a grupos de hosts con el mismo ámbito de implementación, y los grupos de hosts con un ámbito de despliegue diferente aparecen atenuados en la lista.

4. Seleccione Agregar.

Grupos y usuarios

1. En la Información general de Azure Virtual Desktop, seleccione App Attach y, después, seleccione el nombre del paquete de App Attach que desea asignar.

2. En la sección Administrar, seleccione Usuarios:

3. Seleccione + Agregar y, a continuación, seleccione uno o varios grupos o usuarios de la lista.

4. Seleccione Seleccionar.

A continuación se explica cómo asignar un paquete de aplicación para hospedar grupos, grupos y usuarios mediante el módulo Az.DesktopVirtualization de PowerShell.

Grupo de hosts

1. En la misma sesión de PowerShell, obtenga los identificadores de recursos de los grupos de hosts a los que desea asignar la aplicación y agréguelos a una matriz mediante la ejecución de los siguientes comandos:

   # 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. Una vez que tenga los identificadores de recursos de los grupos de hosts, puede asignarles el paquete de aplicación ejecutando los comandos siguientes:

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

3. Para anular la asignación del paquete de aplicación de todos los grupos de hosts, puede pasar una matriz vacía de grupos de hosts mediante la ejecución de los siguientes comandos:

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

Grupos y usuarios

A continuación se explica cómo asignar una aplicación a grupos y usuarios mediante el módulo Az.DesktopVirtualization de PowerShell.

1. Obtenga el identificador de objeto de los grupos o usuarios que desea agregar o quitar de la aplicación y agréguelos a una matriz mediante uno de los ejemplos siguientes. Le recomendamos que asigne aplicaciones a grupos.

   1. Obtenga el identificador de objeto del grupo o grupos y agréguelos a una matriz al ejecutar los siguientes comandos. En este ejemplo se usa el nombre para mostrar del grupo:

      # 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. Obtenga el identificador de objeto de los usuarios y agréguelos a una matriz mediante la ejecución de los siguientes comandos. En este ejemplo se usa el nombre principal de usuario (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. Una vez que tenga los identificadores de objeto de los usuarios o grupos, puede agregarlos o quitarlos de la aplicación mediante uno de los ejemplos siguientes, que asigna el rol RBAC de usuario de virtualización de escritorio .

   1. Para agregar los grupos o usuarios a la aplicación, ejecute los siguientes comandos:

      $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. Para quitar los grupos o usuarios de la aplicación, ejecute los siguientes comandos:

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

Aquí te mostramos cómo cambiar el tipo de registro y el estado de un paquete mediante Azure Portal:

1. En la información general de Azure Virtual Desktop, seleccione Asociación de aplicaciones. Debería ver una lista de todos los paquetes existentes en el grupo de hosts.

2. Seleccione el nombre del paquete que desea cambiar.

   1. Para cambiar el tipo de registro, seleccione A petición o Registrar al iniciar sesión y, a continuación, seleccione Guardar.

   2. Para cambiar el estado, seleccione Inactivo o Activo y, a continuación, seleccione Guardar.

Aquí te mostramos cómo cambiar el tipo de registro y el estado de un paquete mediante el módulo Az.DesktopVirtualization de PowerShell.

1. En la misma sesión de PowerShell, puede cambiar el tipo y el estado del registro ejecutando los siguientes comandos:

   1. Cambie el tipo de registro ejecutando el comando siguiente. Establézcala IsRegularRegistration en $truepara Registrar al iniciar sesión o $false para A petición.

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

   2. Cambie el estado ejecutando el siguiente comando. Establecer IsActive en $trueActivo o $falseInactivo.

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

A continuación se explica cómo agregar una aplicación del paquete agregado en este artículo a un grupo de aplicaciones RemoteApp mediante Azure Portal:

1. En la Información general de Azure Virtual Desktop, seleccione Grupos de aplicaciones y, a continuación, seleccione el grupo de aplicaciones RemoteApp al que desea agregar una aplicación.

2. Seleccione Aplicacionesy seleccione + Agregar. Asegúrese de que tiene al menos un host de sesión activado en el grupo de hosts al que está asignado el grupo de aplicaciones.

3. En la pestaña Aspectos básicos , complete la siguiente información:

   Parámetro	Valor/Descripción
   Origen de la aplicación	Seleccione Asociación de aplicaciones en la lista desplegable. Si desea agregar aplicaciones desde el menú Inicio o especificando una ruta de acceso de archivo, consulte Publicar aplicaciones con RemoteApp.
   Package	Seleccione un paquete disponible para el grupo de hosts en la lista desplegable. Los paquetes regionales son de App Attach.
   Aplicación	Seleccione una aplicación de la lista desplegable.
   Identificador de aplicación	Escriba un identificador único para la aplicación.
   Nombre para mostrar	Escriba un nombre descriptivo para la aplicación que va dirigido a los usuarios.
   Description	Escriba una descripción para la aplicación.

   Una vez que hayas completado esta pestaña, selecciona Siguiente.

4. En la pestaña Icono , seleccione Predeterminado para usar el icono predeterminado para la aplicación o seleccione Ruta de acceso del archivo para usar un icono personalizado. En Ruta de acceso del archivo, seleccione una de las siguientes opciones:

   • Examine Azure Files para usar un icono de un recurso compartido de archivos de Azure. Seleccione Seleccione una cuenta de almacenamiento, seleccione la cuenta de almacenamiento que contiene el archivo de icono y, a continuación, seleccione Seleccionar archivo de icono. Vaya al recurso compartido de archivos y al directorio en el que se encuentra el icono, marque la casilla situada junto al icono que desea agregar, por ejemplo MyApp.ico, y, a continuación, seleccione Seleccionar. También puede usar un .png archivo. En Índice de iconos, especifique el número de índice del icono que desea usar. Este número suele ser 0.

   • Ruta de acceso de archivo UNC para usar un icono de un recurso compartido de archivos. En Ruta de acceso del icono, escriba la ruta de acceso UNC al archivo de icono, por ejemplo \\MyFileShare\MyApp.ico. También puede usar un .png archivo. En Índice de iconos, especifique el número de índice del icono que desea usar. Este número suele ser 0.

   Una vez que haya completado esta pestaña, seleccione Revisar + agregar.

5. En la pestaña Revisar + agregar , asegúrese de que se supera la validación y revise la información que se usa para agregar la aplicación y, a continuación, seleccione Agregar para agregar la aplicación al grupo de aplicaciones RemoteApp.

A continuación se explica cómo agregar una aplicación del paquete que agregó en este artículo a un grupo de aplicaciones RemoteApp mediante el módulo Az.DesktopVirtualization de PowerShell.

1. En la misma sesión de PowerShell, si hay varias aplicaciones en el paquete, debe obtener el identificador de aplicación de la aplicación que desea agregar desde el paquete ejecutando los siguientes comandos:

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

2. Anote el identificador de aplicación que desea publicar (por ejemplo App) y, a continuación, ejecute los siguientes comandos para agregar la aplicación al grupo de aplicaciones RemoteApp:

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

3. Compruebe la lista de aplicaciones del grupo de aplicaciones ejecutando los siguientes comandos:

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

A continuación se explica cómo actualizar un paquete existente mediante Azure Portal:

1. En la información general de Azure Virtual Desktop, seleccione Asociación de aplicaciones. Deberías ver una lista de todos los paquetes existentes.

2. Seleccione el paquete que desea actualizar y, a continuación, en la información general, seleccione Actualizar.

3. Introduce la información del paquete actualizado:

   1. suscripción y grupo de recursos se rellenan previamente con los valores del paquete actual.

   2. Seleccione el grupo de hosts para el que desea actualizar el paquete.

   3. Seleccione la ruta de acceso de la imagen en Seleccione una cuenta de almacenamiento o una UNC de entrada. Los campos posteriores dependen de la opción que seleccione.

      1. En Seleccionar de la cuenta de almacenamiento, seleccione la cuenta de almacenamiento que contiene la imagen actualizada. Seleccione Seleccione un archivo y, a continuación, busque el recurso compartido de archivos y el directorio en el que se encuentra la imagen. Active la casilla situada junto a la imagen que desea agregar, por ejemplo MyApp.cim, y, a continuación, seleccione Seleccionar.
      2. En Entrada UNC, escriba la ruta de acceso UNC al archivo de imagen.

   4. Para el paquete MSIX, seleccione el paquete MSIX o Appx de la imagen.

4. Una vez que haya completado los campos, seleccione Actualizar.

Aquí se muestra cómo actualizar un paquete existente con el módulo Az.DesktopVirtualization de PowerShell.

1. En la misma sesión de PowerShell, obtenga las propiedades de la aplicación actualizada y almacénelas en una variable ejecutando los siguientes comandos:

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

2. Compruebe que solo tiene un objeto en las propiedades de la aplicación ejecutando los siguientes comandos:

   $app | FL *
   

   Si tiene más de un objeto en la salida, por ejemplo, una versión x64 y x86 de la misma aplicación, puede utilizar el parámetro PackageFullName para especificar cuál desea agregar ejecutando los comandos siguientes:

   # 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. Actualice un paquete existente ejecutando el siguiente comando. La nueva imagen de disco reemplaza a la existente, pero se mantienen las asignaciones existentes. No elimine la imagen existente hasta que los usuarios hayan dejado de usarla.

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

A continuación se explica cómo quitar un paquete de conexión de aplicaciones mediante Azure Portal:

1. En la información general de Azure Virtual Desktop, seleccione Asociación de aplicaciones. Deberías ver una lista de todos los paquetes existentes.

2. Marca la casilla situada junto al nombre del paquete que deseas quitar y, a continuación, selecciona Quitar. El paquete también se quita de los grupos de hosts a los que está asignado.

Aquí se muestra cómo quitar un paquete de conexión de aplicaciones mediante el módulo de PowerShell Az.DesktopVirtualization .

1. En la misma sesión de PowerShell, ejecute el siguiente comando para quitar el paquete que contiene una aplicación:

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