Incorporación y administración de aplicaciones de asociación de aplicaciones y de asociación de aplicaciones MSIX en Azure Virtual Desktop

Aquí se muestra cómo agregar una imagen MSIX o Appx como paquete de asociación de aplicaciones mediante Azure Portal:

1. Inicie sesión en Azure Portal.

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, después, + Crear.

4. En la pestaña Datos 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 o Appx en la lista desplegable.
   Resource group	Seleccione un grupo de recursos existente o vaya a Crear nuevo y escriba un nombre.
   Grupo de hosts	Seleccione un grupo de hosts existente en la lista desplegable.
   Location	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 Seleccionar de la cuenta de almacenamiento si la imagen está almacenada en Azure Files o Entrada UNC para especificar una ruta de acceso UNC. Los campos posteriores dependerán de la opción que seleccione.
   Seleccionar de la cuenta de almacenamiento
   Cuenta de almacenamiento	Seleccione la cuenta de almacenamiento en la que se encuentra la imagen.
   Recurso compartido de archivos	Seleccione Seleccionar un archivo y 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, después, seleccione Seleccionar.
   Paquete MSIX	Seleccione el paquete MSIX o Appx de la imagen.
   Entrada UNC
   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 desee 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 que haya completado esta pestaña, puede seguir asignando opcionalmente la aplicación a grupos de hosts, usuarios y grupos. Como alternativa, si desea configurar las asignaciones por separado, seleccione Revisar y crear y, después, 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 los grupos de hosts a los que desea asignar la aplicación. Si ya usa la asociación de aplicaciones MSIX con un grupo de hosts, no puede seleccionar ese grupo de hosts, ya que no puede usar ambas versiones de asociación de aplicaciones con el mismo grupo de hosts.

   2. Seleccione Agregar usuarios o grupos de usuarios y busque y seleccione los usuarios o grupos a los que desea asignar la aplicación. Cuando 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 cualquier nombre/par de valores que necesite y, a continuación, seleccione Revisar y crear.

8. En la pestaña Revisar y crear, asegúrese de que se apruebe la validación, 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 o Appx como paquete de asociación de aplicaciones mediante el módulo Az.DesktopVirtualization de PowerShell. Asegúrese de cambiar los valores de <placeholder> por sus propios valores.

1. Abra Azure Cloud Shell en 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 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 ejecutando los siguientes comandos:

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

   La salida debe ser similar al ejemplo 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. Para obtener las propiedades de la imagen que desea agregar y almacenarlas en una variable, ejecute el comando siguiente. Debe especificar un grupo de hosts, pero puede ser cualquier grupo en el que los hosts de sesión tengan acceso al recurso compartido de archivos.

   # Get the properties of the MSIX or Appx image
   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       Path = '<UNCPathToImageFile>'
   }
   
   $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 x86 de la misma aplicación, puede usar 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 = '<UNCPathToImageFile>'
   }
   
   $app = Import-AzWvdAppAttachPackageInfo @parameters | ? ImagePackageFullName -like *$packageFullName*
   

5. Para agregar la imagen como paquete de asociación de aplicaciones, ejecute el comando siguiente. 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 salida si 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 a la del siguiente ejemplo:

   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 Azure Portal:

Grupos de host

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 de hosts en la lista desplegable. Asegúrese de que todos los hosts de sesión del grupo de hosts tengan 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. Elija 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.

Grupos de host

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 ejecutando el siguiente comando:

   # 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 el comando siguiente:

   $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 que desea agregar o quitar de la aplicación y agréguelos a una matriz usando 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 mediante la ejecución de los comandos siguientes. 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 usando uno de los ejemplos siguientes, que asigna el rol RBAC 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í se muestra 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 dentro del 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 en el inicio de sesión y, a continuación, seleccione Guardar.

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

Aquí 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 comando siguiente. Establezca IsRegularRegistration en $true para Registrar en el inicio de sesión o $false para a petición.

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

   2. Para cambiar el estado, ejecute el comando siguiente. Establezca IsActive en $true para Activo o $false para Inactivo.

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

Aquí se muestra cómo agregar una aplicación a partir del paquete que agregó en este artículo a un grupo de aplicaciones de 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 Aplicaciones y, después, + 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 Datos básicos, complete la siguiente información:

   Parámetro	Valor/Descripción
   Origen de 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.
   Paquete	Seleccione un paquete disponible para el grupo de hosts en la lista desplegable. Los paquetes regionales proceden de la asociación de aplicaciones.
   Aplicación	Seleccione una aplicación en la lista desplegable.
   Identificador de la aplicación	Escriba un identificador único para la aplicación.
   Nombre para mostrar	Escriba un nombre descriptivo para la aplicación; es decir, 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 del 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, la cuenta de almacenamiento que contiene el archivo de iconos y, a continuación, Seleccionar archivo de icono. Vaya al recurso compartido de archivos y al 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 archivo .png. En Índice de icono, 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 de icono, escriba la ruta de acceso UNC al archivo de icono (por ejemplo, \\MyFileShare\MyApp.ico). También puede usar un archivo .png. En Índice de icono, 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 y agregar.

5. En la pestaña Revisar y agregar, asegúrese de que se apruebe la validación, 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 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 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. Ejecute los siguientes comandos para comprobar la lista de aplicaciones del grupo de aplicaciones:

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

Aquí se muestra 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ía 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. 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 dependerán 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 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, después, 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 completados los campos, seleccione Actualizar.

Aquí 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 = '<UNCPathToImageFile>'
   }
   
   $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 x86 de la misma aplicación, puede usar el parámetro PackageFullName para especificar cuál 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 = '<UNCPathToImageFile>'
   }
   
   $app = Import-AzWvdAppAttachPackageInfo @parameters | ? ImagePackageFullName -like *$packageFullName*
   

3. Actualice un paquete existente ejecutando el comando siguiente. 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
   

Aquí se muestra cómo quitar un paquete de asociación de aplicaciones 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.

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 de hosts a los que está asignado.

Aquí 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
   

Aquí se muestra cómo agregar una imagen MSIX mediante Azure Portal:

1. Inicie sesión en Azure Portal.

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 Grupos de hosts y, a continuación, seleccione el nombre del grupo de hosts al que desea agregar una imagen MSIX.

4. En la información general del grupo de hosts, seleccione Paquetes MSIX y, a continuación, seleccione + Agregar.

5. En Ruta de acceso de imagen MSIX, escriba una ruta de acceso UNC válida que apunte a la imagen MSIX del recurso compartido de archivos (por ejemplo, \\fileshare\Apps\MyApp\MyApp.cim) y seleccione Agregar, que comprueba que la ruta de acceso es válida.

6. Una vez comprobada la ruta de acceso, aparecen más campos. Complete la siguiente información:

   Parámetro	Descripción
   Paquete MSIX	Seleccione el nombre del paquete MSIX correspondiente en el menú desplegable.
   Aplicaciones de paquetes	Muestra Aplicación y no se puede configurar.
   Nombre para mostrar	Escriba un nombre descriptivo para el paquete.
   Versión	Compruebe que se muestra el número de versión esperado.
   Tipo de registro	Seleccione el tipo de registro que desee usar.
   Estado	Seleccione el estado inicial del paquete.

7. Una vez completados los campos, seleccione Agregar.

Aquí se muestra cómo agregar un paquete MSIX mediante el módulo Az.DesktopVirtualization de PowerShell. Asegúrese de cambiar los valores de <placeholder> por sus propios valores.

1. Abra Azure Cloud Shell en 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 asegúrese de que el contexto de Azure esté establecido en la suscripción que desea usar.

2. Para obtener las propiedades de la aplicación en la imagen MSIX que desea agregar y almacenarlas en una variable, ejecute los comandos siguientes:

   # Get the properties of the MSIX image
   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       Uri = '<UNCPathToImageFile>'
   }
   
   $app = Expand-AzWvdMsixImage @parameters
   

   La salida debe ser similar a la del siguiente ejemplo:

   Name
   ----
   hp01/expandmsiximage
   

3. 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 x86 de la misma aplicación, puede usar el parámetro PackageFullName para especificar cuál desea agregar ejecutando los siguientes comandos:

   # Specify the package full name
   $packageFullName = '<PackageFullName>'
   
   # Get the properties of the application
   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       Uri = '<UNCPathToImageFile>'
   }
   
   $app = Expand-AzWvdMsixImage @parameters | ? PackageFullName -like *$packageFullName*
   

4. Para agregar la imagen MSIX a un grupo de hosts, ejecute el siguiente comando. En este ejemplo, el estado de la aplicación se marca como activo.

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       PackageAlias = $app.PackageAlias
       DisplayName = '<DisplayName>'
       ImagePath = $app.ImagePath
       IsActive = $true
   }
   
   New-AzWvdMsixPackage @parameters
   

   No hay ninguna salida si el paquete MSIX se agrega correctamente.

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

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdMsixPackage @parameters | ? PackageFamilyName -eq $app.PackageFamilyName | FL *
   

   La salida debe ser similar a la del siguiente ejemplo:

   DisplayName                  : My App
   Id                           : /subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/avd/providers/Microsoft.DesktopVirtualization/hostpools/hp01/msixpackages/MyApp_1.0.0.0_neutral__abcdef123ghij
   ImagePath                    : \\fileshare\Apps\MyApp\MyApp.cim
   IsActive                     : True
   IsRegularRegistration        : False
   LastUpdated                  : 7/27/2023 10:02:29 AM
   Name                         : hp01/MyApp_1.0.0.0_neutral__abcdef123ghij
   PackageApplication           : {MyApp}
   PackageDependency            : {}
   PackageFamilyName            : MyApp_abcdef123ghij
   PackageName                  : MyApp
   PackageRelativePath          : apps\MyApp_1.0.0.0_neutral__abcdef123ghij
   SystemDataCreatedAt          : 7/28/2023 9:04:00 AM
   SystemDataCreatedBy          : avdadmin@contoso.com
   SystemDataCreatedByType      : User
   SystemDataLastModifiedAt     : 7/28/2023 9:04:00 AM
   SystemDataLastModifiedBy     : avdadmin@contoso.com
   SystemDataLastModifiedByType : User
   Type                         : Microsoft.DesktopVirtualization/hostpools/msixpackages
   Version                      : 1.0.0.0
   

Aquí se muestra 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 Grupos de hosts y, a continuación, seleccione el nombre del grupo de hosts al que se ha agregado el paquete MSIX.

2. En la información general del grupo de hosts, seleccione Paquetes MSIX. Debería ver una lista de todos los paquetes de MSIX existentes en el grupo de hosts.

3. Seleccione el nombre del paquete MSIX que desea cambiar.

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

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

Aquí 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, obtenga una lista de paquetes MSIX en un grupo de hosts y su tipo de registro y estado actuales mediante la ejecución de los siguientes comandos:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdMsixPackage @parameters | Select-Object DisplayName, ImagePath, Name, Version, IsRegularRegistration, IsActive
   

   La salida debe ser similar a la del siguiente ejemplo:

   DisplayName ImagePath                        Name                                      Version IsRegularRegistration IsActive
   ----------- ---------                        -----------------                         ------- --------------------- --------
   My App      \\fileshare\Apps\MyApp\MyApp.cim hp01/MyApp_1.0.0.0_neutral__abcdef123ghij 1.0.0.0                 False     True
   

2. Busque el paquete que desea quitar y use el valor del parámetro Name, pero quite el nombre del grupo de hosts y / del principio. Por ejemplo, hp01/MyApp_1.0.0.0_neutral__abcdef123ghij se convierte en MyApp_1.0.0.0_neutral__abcdef123ghij. He aquí un par de ejemplos:

   1. Para cambiar el tipo de registro, ejecute el comando siguiente. Establezca IsRegularRegistration en $true para Registrar en el inicio de sesión o $false para a petición.

      $parameters = @{
          FullName = '<FullName>'
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          IsRegularRegistration = $true
      }
      
      Update-AzWvdMsixPackage @parameters
      

   2. Para cambiar el estado, ejecute el comando siguiente. Establezca IsActive en $true para Activo o $false para Inactivo.

      $parameters = @{
          FullName = '<FullName>'
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          IsActive = $true
      }
      
      Update-AzWvdMsixPackage @parameters
      

Aquí se muestra cómo agregar una aplicación a partir del paquete que agregó en este artículo a un grupo de aplicaciones de 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 de escritorio o RemoteApp al que desea agregar una aplicación.

2. Seleccione Aplicaciones y, después, + 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, las opciones que ve dependen de si el grupo de aplicaciones es para un escritorio o para RemoteApp:

   1. Para un grupo de aplicaciones de escritorio, complete la siguiente información:

      Parámetro	Valor/Descripción
      Origen de aplicación	El paquete MSIX se selecciona automáticamente y está atenuado.
      Paquete	Seleccione un paquete disponible para el grupo de hosts en la lista desplegable.
      Identificador de la aplicación	Escriba un identificador único para la aplicación.
      Nombre para mostrar	Escriba un nombre descriptivo para la aplicación; es decir, para los usuarios.
      Descripción	Escriba una descripción para la aplicación.

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

   2. Para un grupo de aplicaciones RemoteApp, complete la siguiente información:

      Parámetro	Valor/Descripción
      Origen de 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.
      Paquete	Seleccione un paquete disponible para el grupo de hosts en la lista desplegable. Los paquetes del grupo de hosts proceden de la asociación de aplicaciones MSIX.
      Aplicación	Seleccione una aplicación en la lista desplegable.
      Identificador de la aplicación	Escriba un identificador único para la aplicación.
      Nombre para mostrar	Escriba un nombre descriptivo para la aplicación; es decir, para los usuarios.
      Descripción	Escriba una descripción para la aplicación.

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

      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 del 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, la cuenta de almacenamiento que contiene el archivo de iconos y, a continuación, Seleccionar archivo de icono. Vaya al recurso compartido de archivos y al 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 archivo .png. En Índice de icono, 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 de icono, escriba la ruta de acceso UNC al archivo de icono (por ejemplo, \\MyFileShare\MyApp.ico). También puede usar un archivo .png. En Índice de icono, 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 y agregar.

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

Aquí se muestra cómo agregar aplicaciones MSIX a un grupo de aplicaciones mediante el módulo Az.DesktopVirtualization de PowerShell.

1. En la misma sesión de PowerShell, agregue una aplicación MSIX a un grupo de aplicaciones ejecutando los comandos de uno de los ejemplos siguientes.

   1. Para agregar una aplicación MSIX a un grupo de aplicaciones de escritorio, ejecute los siguientes comandos:

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

   2. Para agregar una aplicación MSIX a un grupo de aplicaciones RemoteApp, 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 siguientes comandos:

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

      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.PackageFamilyName
          MsixPackageApplicationId = '<ApplicationID>'
          GroupName = '<ApplicationGroupName>'
          ResourceGroupName = '<ResourceGroupName>'
          CommandLineSetting = 'DoNotAllow'
      }
      
      New-AzWvdApplication @parameters
      

      Ejecute los siguientes comandos para comprobar la lista de aplicaciones del grupo de aplicaciones:

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

Aquí se muestra cómo quitar un paquete MSIX del grupo de hosts mediante Azure Portal:

1. En la información general de Azure Virtual Desktop, seleccione Grupos de hosts y, a continuación, seleccione el nombre del grupo de hosts al que se ha agregado el paquete MSIX.

2. En la información general del grupo de hosts, seleccione Paquetes MSIX. Debería ver una lista de todos los paquetes de MSIX existentes en el grupo de hosts.

3. Active la casilla situada junto al nombre del paquete MSIX que desea quitar y, a continuación, seleccione Quitar.

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

1. En la misma sesión de PowerShell, obtenga una lista de paquetes MSIX en un grupo de hosts mediante la ejecución de los siguientes comandos:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdMsixPackage @parameters | Select-Object DisplayName, ImagePath, PackageFamilyName, Version
   

   La salida debe ser similar a la del siguiente ejemplo:

   DisplayName ImagePath                        Name                                      Version
   ----------- ---------                        -----------------                         -------
   My App      \\fileshare\Apps\MyApp\MyApp.cim hp01/MyApp_1.0.0.0_neutral__abcdef123ghij 1.0.0.0
   

2. Busque el paquete que desea quitar y use el valor del parámetro Name, pero quite el nombre del grupo de hosts y / del principio. Por ejemplo, hp01/MyApp_1.0.0.0_neutral__abcdef123ghij se convierte en MyApp_1.0.0.0_neutral__abcdef123ghij. A continuación, quite el paquete mediante la ejecución de los siguientes comandos:

   $parameters = @{
       FullName = '<FullName>'
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Remove-AzWvdMsixPackage @parameters