Migración de un paquete MSIX desde la asociación de aplicaciones MSIX a la asociación de aplicaciones

La conexión de aplicaciones mejora las experiencias administrativas y de usuario con respecto a la conexión de aplicaciones MSIX. Si usa la asociación de aplicaciones MSIX, puede migrar los paquetes MSIX a la asociación de aplicaciones mediante un script de PowerShell.

El script de migración puede realizar las siguientes acciones:

• Crea un nuevo objeto de paquete de asociación de aplicaciones y puede eliminar el objeto de paquete MSIX original, si es necesario.

• Copie los permisos de los grupos de aplicaciones asociados al grupo de hosts y al paquete MSIX.

• Copie la ubicación y el grupo de recursos del grupo de hosts y el paquete MSIX.

• Actividad de migración de registros.

Requisitos previos

Para usar el script de migración, necesita:

• Un grupo de hosts configurado como entorno de validación, con al menos un paquete MSIX agregado con la asociación de aplicaciones MSIX.

• Una cuenta de Azure con el rol de control de acceso basado en rol (RBAC) Colaborador de virtualización de escritorio de Azure asignado en el grupo de recursos.

• Un dispositivo local con PowerShell. Asegúrese de que tiene instaladas las versiones más recientes de Az PowerShell y elSDK de PowerShell en Microsoft Graph. Concretamente, se requieren los módulos siguientes:

  • Az.DesktopVirtualization
  • Az.Accounts
  • Az.Resources
  • Microsoft.Graph.Authentication

Parámetros

Estos son los parámetros que puede usar con el script de migración:

Parámetro	Descripción
MsixPackage	El objeto de paquete MSIX que se va a migrar a un objeto de asociación de aplicaciones. Este valor se puede pasar a través de la canalización.
PermissionSource	Dónde obtener permisos para el nuevo objeto de asociación de aplicaciones. El valor predeterminado es que no se conceden permisos. Las opciones son: DAG: el grupo de aplicaciones de escritorio asociados al grupo de hosts y al paquete MSIX RAG: uno o más grupos de aplicaciones de RemoteApp asociados al grupo de hosts y al paquete MSIX Ambas opciones conceden permiso a todos los usuarios y grupos con cualquier permiso cuyo ámbito sea específico para el grupo de aplicaciones.
HostPoolsForNewPackage	Identificadores de recursos de grupos de hosts con los que asociar un nuevo objeto de asociación de aplicaciones. El valor predeterminado es ningún grupo de hosts. Los grupos de hosts deben estar en la misma ubicación que los paquetes de asociación de aplicaciones a los que están asociados.
TargetResourceGroupName	Grupo de recursos para almacenar el nuevo objeto de asociación de aplicaciones. El valor predeterminado es el grupo de recursos del grupo de hosts al que está asociado el paquete MSIX.
Location	Región de Azure en la que se va a crear un nuevo objeto de asociación de aplicaciones. El valor predeterminado es la ubicación del grupo de hosts al que está asociado el paquete MSIX. Los paquetes de asociación de aplicaciones deben estar en la misma ubicación que los grupo de hosts a los que están asociados.
DeleteOrigin	Elimine el paquete MSIX de origen después de la migración.
IsActive	Habilita el nuevo objeto de asociación de aplicaciones.
DeactivateOrigin	Deshabilita el objeto de paquete MSIX de origen después de la migración.
PassThru	Pasa el nuevo objeto de asociación de aplicaciones. Passthru devuelve el objeto del paquete creado. Use este valor si desea inspeccionarlo o pasarlo a otro comando de PowerShell.
LogInJSON	Escriba en el archivo de registro en formato JSON.
LogFilePath	Ruta de acceso del archivo de registro, el valor predeterminado es MsixMigration[Timestamp].log en una carpeta temporal, como C:\Users\%USERNAME%\AppData\Local\Temp\MsixMigration<DATETIME>.log. La ruta de acceso para el registro se escribe en la consola cuando se ejecuta el script.

Descarga y ejecución del script de migración

Aquí se muestra cómo migrar un paquete MSIX desde la asociación de aplicaciones MSIX a la asociación de aplicaciones.

Importante

En los siguientes ejemplos, deberá cambiar los valores de <placeholder> por los suyos.

1. Abra un símbolo del sistema de PowerShell en el dispositivo local.

2. Descargue el script Migrate-MsixPackagesToAppAttach.ps1 de PowerShell y desbloquéelo ejecutando los siguientes comandos:

   $url = "https://raw.githubusercontent.com/Azure/RDS-Templates/master/msix-app-attach/MigrationScript/Migrate-MsixPackagesToAppAttach.ps1"
   $filename = $url.Split('/')[-1]
   
   Invoke-WebRequest -Uri $url -OutFile $filename | Unblock-File
   

3. Importar los módulo necesarios ejecutando los comandos siguientes:

   Import-Module Az.DesktopVirtualization
   Import-Module Az.Accounts
   Import-Module Az.Resources
   Import-Module Microsoft.Graph.Authentication
   

4. Para conectarse a Azure, ejecute el siguiente comando y siga las indicaciones para iniciar sesión en su cuenta de Azure:

   Connect-AzAccount
   

5. Conéctese a Microsoft Graph mediante la ejecución del siguiente comando:

   Connect-MgGraph -Scopes "Group.Read.All"
   

Las subsecciones siguientes contienen algunos ejemplos de cómo usar el script de migración. Consulte la sección parámetros para ver todos los parámetros disponibles y una descripción de cada parámetro.

Sugerencia

Si no pasa ningún parámetro al script de migración, tiene el siguiente comportamiento predeterminado:

• No se conceden permisos al nuevo paquete de asociación de aplicaciones.
• El nuevo paquete de asociación de aplicaciones no está asociado a ningún grupo de hosts y está inactivo.
• El nuevo paquete de asociación de aplicaciones se crea en el mismo grupo de recursos y ubicación que el grupo de hosts.
• El paquete MSIX original todavía está activo no está deshabilitado ni eliminado.
• La información de registro se escribe en la ruta de acceso del archivo predeterminada.

Migración de un paquete MSIX específico agregado a un grupo de hosts y un grupo de aplicaciones

Este es un ejemplo para migrar un paquete MSIX específico agregado a un grupo de hosts desde la asociación de aplicaciones MSIX a la asociación de aplicaciones. Este ejemplo:

• Migra el paquete MSIX al mismo grupo de recursos y ubicación que el grupo de hosts.
• Asigna el paquete MSIX en la asociación de aplicaciones al mismo grupo de hosts y a los mismos usuarios que el origen del grupo de aplicaciones de RemoteApp.
• Deja la configuración del paquete MSIX existente en la asociación de aplicaciones MSIX activo en el grupo de hosts. Si desea deshabilitar el paquete MSIX inmediatamente, use el parámetro -DeactivateOrigin.
• Establece la nueva configuración del paquete MSIX en la asociación de aplicaciones inactivo. Si desea habilitar el paquete MSIX inmediatamente, use el parámetro -IsActive.
• Escribe información de registro en la ruta de acceso y formato del archivo predeterminada.

1. Desde la misma solicitud de PowerShell, obtenga una lista de paquetes MSIX agregados a un grupo de hosts ejecutando los siguientes comandos:

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

   La salida es similar a la del ejemplo siguiente:

   DisplayName Name
   ----------- ----
   MyApp       hp01/MyApp_1.0.0.0_neutral__abcdef123ghij
   

2. Busque el paquete MSIX que desea migrar y use el valor del parámetro Name en la salida anterior:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   $msixPackage = Get-AzWvdMsixPackage @parameters | ? Name -Match '<MSIXPackageName>'
   $hostPoolId = (Get-AzWvdHostPool @parameters).Id
   

3. Migre el paquete MSIX ejecutando el comando siguiente:

   $parameters = @{
       PermissionSource = 'RAG'
       HostPoolsForNewPackage = $hostPoolId
       PassThru = $true
   }
   
   $msixPackage | .\Migrate-MsixPackagesToAppAttach.ps1 @parameters
   

Migración de todos los paquetes MSIX agregados a un grupo de hosts

Este es un ejemplo para migrar todos los paquetes MSIX específicos agregados a un grupo de hosts desde la asociación de aplicaciones MSIX a la asociación de aplicaciones. Este ejemplo:

• Migra los paquetes MSIX al mismo grupo de recursos y ubicación.
• Agrega los nuevos paquetes de asociación de aplicaciones al mismo grupo de hosts.
• Establece todos los paquetes de asociación de aplicaciones en activo.
• Establece todos los paquetes MSIX en inactivos.
• Copia los permisos del grupo de aplicaciones de escritorio asociado.
• Escribe información de registro en una ruta de acceso de archivo personalizada en C:\MsixToAppAttach.log en formato JSON.

1. Desde la misma solicitud de PowerShell, obtenga todos los paquetes MSIX agregados a un grupo de hosts y almacénelos en una variable ejecutando los siguientes comandos:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   $msixPackages = Get-AzWvdMsixPackage @parameters
   $hostPoolId = (Get-AzWvdHostPool @parameters).Id   
   

2. Migre el paquete MSIX ejecutando el comando siguiente:

   $logFilePath = "C:\Temp\MsixToAppAttach.log"
   
   $parameters = @{
       IsActive = $true
       DeactivateOrigin = $true
       PermissionSource = 'DAG'
       HostPoolsForNewPackage = $hostPoolId
       PassThru = $true
       LogInJSON = $true
       LogFilePath = $LogFilePath
   }
   
   $msixPackages | .\Migrate-MsixPackagesToAppAttach.ps1 @parameters