Adición y administración de aplicaciones adjuntas en Azure Virtual Desktop

A continuación se muestra cómo agregar una imagen MSIX, una imagen de Appx o un paquete de App-V como un paquete de Asociación de aplicaciones mediante el 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 coincidente para ir a la información general de Azure Virtual Desktop.

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

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

   Parámetro	Descripción
   Suscripción	Seleccione la suscripción a la que desea agregar una imagen MSIX, una imagen de 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 asociación de aplicaciones.

   Una vez que haya completado esta pestaña, seleccione Siguiente.

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

   Parámetro	Descripción
   Ruta de acceso de la imagen	Seleccione en Seleccionar de la cuenta de almacenamiento si la imagen está almacenada en Azure Files o UNC de entrada para especificar una ruta de acceso UNC. Los campos posteriores dependen de la opción que seleccione.
   Selección de una cuenta de almacenamiento
   Cuenta de almacenamiento	Seleccione la cuenta de almacenamiento en la que se encuentra la imagen.
   Compartir archivos	Seleccione Seleccionar un archivo y, a continuación, vaya al recurso compartido de archivos y al directorio en el que se encuentra la imagen. Active la casilla situada junto a la imagen que desea agregar, por ejemplo MyApp.cim, y seleccione Seleccionar.
   Paquete MSIX	Seleccione el paquete MSIX o Appx en la imagen.
   UNC de entrada
   UNC	Escriba la ruta de acceso UNC al archivo de imagen.
   Paquete MSIX	Seleccione el paquete MSIX o Appx en la imagen.
   Cualquiera de las dos 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 desea 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 haya completado esta pestaña, seleccione Siguiente.

   Sugerencia

   Una vez completada esta pestaña, puede seguir asignando opcionalmente la aplicación a grupos de hosts, usuarios y grupos. Como alternativa, si desea configurar asignaciones por separado, seleccione Revisar y crear y, a continuación, vaya a Asignar un paquete de asociación de aplicaciones.

6. Opcional: en la pestaña Asignaciones , complete la siguiente información:

   1. En Grupo de hosts, seleccione a qué grupos de hosts 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. Una vez que haya terminado, seleccione Seleccionar.

   3. Revise las asignaciones que agregó y, a continuación, seleccione Siguiente.

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

8. En la pestaña Revisar y crear , asegúrese de que la validación pasa 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 muestra cómo agregar una imagen MSIX, una imagen de Appx o un paquete de App-V como paquete de asociación de aplicaciones mediante el módulo Az.DesktopVirtualization de PowerShell. Asegúrese de cambiar los <placeholder> valores de los suyos propios.

1. Abra Azure Cloud Shell en el Azure Portal con el tipo de terminal de 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, inicie sesión primero con Azure PowerShell y, a continuación, 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 los cmdlets de PowerShell disponibles mediante la ejecución de los siguientes comandos:

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

   La salida debe ser similar a la siguiente salida:

   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 de Appx o el paquete de App-V que desea agregar y almacenar en una variable mediante la ejecución del siguiente comando. Debe especificar un grupo de hosts, pero puede ser cualquier grupo host en el que los hosts de 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 mediante la ejecución de los siguientes comandos:

   $app | FL *
   

   Opcional: si tiene más de un objeto en la salida, por ejemplo, una versión x64 y una versión x86 de la misma aplicación, puede usar el parámetro PackageFullName para especificar qué aplicación desea agregar mediante la ejecución de 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*
   

5. Agregue la imagen o el paquete como un paquete de Asociación de aplicaciones mediante la ejecución del 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 comprobación de estado del host de 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 ninguna salida cuando el paquete se agrega correctamente.

6. Para comprobar que el paquete se agrega, ejecute los siguientes comandos:

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

   La salida debe ser similar al 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
   

A continuación se muestra cómo asignar un paquete de aplicación a grupos de hosts, usuarios y grupos mediante el Azure Portal:

Grupo de hosts

1. En la información general de Azure Virtual Desktop, seleccione Asociación de aplicaciones y, a continuación, seleccione el nombre del paquete de asociación de aplicaciones 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 host 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 muestra en los requisitos previos.

4. Seleccione Agregar.

Grupos y usuarios

1. En la información general de Azure Virtual Desktop, seleccione Asociación de aplicaciones y, a continuación, seleccione el nombre del paquete de asociación de aplicaciones 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.

Aquí se muestra cómo asignar un paquete de aplicación a grupos de hosts, así como a 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 recurso 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 comandos siguientes:

   # 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 mediante la ejecución de los siguientes comandos:

   $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

Aquí se muestra 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 a los que desea agregar o quitar de la aplicación y agréguelos a una matriz a mediante uno de los ejemplos siguientes. Se recomienda asignar aplicaciones a grupos.

   1. Obtenga el identificador de objeto del grupo o grupos y agréguelos a una matriz a mediante la ejecución de 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 a 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
      }
      

A continuación se muestra cómo cambiar el tipo de registro y el estado de un paquete mediante el 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 dentro del grupo host.

2. Seleccione el nombre del paquete que desea cambiar.

   1. Para cambiar el tipo de registro, seleccione A petición o Registrarse 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.

A continuación se muestra 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 de registro y el estado ejecutando los siguientes comandos:

   1. Para cambiar el tipo de registro, ejecute el siguiente comando. Establézcalo IsRegularRegistrationen para Registrarse al iniciar sesión o $false para a petición.$true

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

   2. Para cambiar el estado, ejecute el siguiente comando. Establézcalo $true en IsActiveactivo o $falseinactivo.

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

A continuación se muestra cómo agregar una aplicación desde el paquete que agregó en este artículo a un grupo de aplicaciones RemoteApp mediante el Azure Portal:

1. En la introducción a 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 Aplicaciones, + Agregar. Asegúrese de que tiene al menos un host de sesión encendido 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 Publicación de 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 en 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 es para los usuarios.
   Descripción	Escriba una descripción para la aplicación.

   Una vez que haya completado esta pestaña, seleccione Siguiente.

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

   • Examine Azure Files para usar un icono de un recurso compartido de archivos de Azure. Seleccione Seleccionar una cuenta de almacenamiento y seleccione la cuenta de almacenamiento que contiene el archivo de icono y seleccione Seleccionar archivo de icono. Vaya al recurso compartido de archivos y el directorio en el que se encuentra el icono, active la casilla situada junto al icono que desea agregar, por ejemplo MyApp.ico, y seleccione Seleccionar. También puede usar un .png archivo. En Índice de icono, especifique el número de índice para el 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 de 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 icono, especifique el número de índice para el icono que desea usar. Este número suele ser 0.

   Una vez completada esta pestaña, seleccione Revisar y agregar.

5. En la pestaña Revisar y agregar , asegúrese de que la validación pasa 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.

Aquí se muestra cómo agregar una aplicación desde el 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 mediante la ejecución de los comandos siguientes:

   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 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. Para comprobar la lista de aplicaciones del grupo de aplicaciones, ejecute los comandos siguientes:

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

A continuación se muestra cómo actualizar un paquete existente mediante el 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.

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

3. Escriba la información del paquete actualizado:

   1. La suscripción y el 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 Seleccionar de la cuenta de almacenamiento o Entrada UNC. 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 Seleccionar un archivo y, a continuación, vaya al recurso compartido de archivos y al directorio en el que se encuentra la imagen. Active la casilla situada junto a la imagen que desea agregar, por ejemplo MyApp.cim, y seleccione Seleccionar.
      2. En Input UNC (Entrada UNC), escriba la ruta de acceso UNC al archivo de imagen.

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

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

A continuación se muestra cómo actualizar un paquete existente mediante 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 mediante la ejecución de 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 mediante la ejecución de los siguientes comandos:

   $app | FL *
   

   Si tiene más de un objeto en la salida, por ejemplo, una versión x64 y una versión x86 de la misma aplicación, puede usar el parámetro PackageFullName para especificar cuál desea agregar mediante la ejecución de 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 mediante la ejecución del siguiente comando. La nueva imagen de disco reemplaza a la existente, pero se conservan 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 muestra cómo quitar un paquete de Asociación de aplicaciones mediante el 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.

2. Active la casilla situada junto al nombre del paquete que desea quitar y, a continuación, seleccione Quitar. El paquete también se quita de los grupos host a los que está asignado.

A continuación se muestra cómo quitar un paquete de Asociación de aplicaciones mediante el módulo Az.DesktopVirtualization de PowerShell.

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