Problemas conocidos

Last published : Oct 24, 2026

Actualización de App Layering

App Layering 2603

  • Las actualizaciones de junio de Windows 11 añaden una nueva dependencia a los Servicios de Escritorio Remoto en el servicio State Repository. Esto hará que los Servicios de Escritorio Remoto no se inicien hasta después de que el usuario haya iniciado sesión cuando se utilizan capas de usuario completas o si se utiliza la Capa de Personalización de Usuario (UPL). Si necesita que los Servicios de Escritorio Remoto se inicien antes del inicio de sesión, debe eliminar el servicio State Repository de la lista de dependencias del Servicio de Escritorio Remoto en la revisión del SO o en la imagen cuando utilice UPL.

App Layering 2511

  • Para el conector de Google Cloud Platform, actualmente existe un problema con el empaquetado de capas y la publicación de imágenes en capas. La tarea falla después de esperar a que se inicie el Compositing Engine, con un mensaje de error que contiene The resource 'citrix-ce/' of type 'Guest Attribute' was not found. . Este problema se resolverá en una futura actualización o versión.
  • La función del Servicio de Portabilidad de Imágenes actualmente no es compatible con las imágenes de Azure configuradas con un controlador de disco NVMe. El soporte está previsto para una futura versión.

App Layering 2409

  • Puede que encuentre un mensaje incorrecto después de que la migración se complete con agentes fallidos en Citrix App Layering. El mensaje indica: "La migración se ha completado correctamente, pero no pudimos registrar los siguientes agentes de App Layering con el dispositivo de destino: System.Collections.Generic.List`1."
  • Después de la migración al Elastic Layer Manager (ELM) de destino, no se le pedirá que establezca las contraseñas de root y de administrador de la consola. Si estas contraseñas no se configuraron antes de la migración, se restablecerán a la configuración de fábrica.
    Como solución alternativa:
    Si las contraseñas no se configuraron antes de la migración, inicie sesión en la consola de ELM de destino como root y cambie las contraseñas manualmente utilizando los siguientes comandos:
    • Cambiar la contraseña de root:
      passwd
      Se le pedirá que establezca una contraseña para root.
    • Cambiar la contraseña de administrador:
      passwd administrator
      Se le pedirá que establezca una contraseña para el administrador, use una 'a' minúscula.
  • Cuando se conecta a un nuevo ELM usando un usuario que no es root, puede recibir un mensaje de error poco claro que dice: "Cannot convert undefined or null to object." Debería esperar un mensaje específico que indique que el usuario es incorrecto.
  • Debe evitar el uso de caracteres especiales como &, < y > en su contraseña de administrador predeterminada en el ELM, ya que esto puede causar fallos en la creación de capas de SO a través del script de importación.
  • Después de la migración, la contraseña de administrador de la consola de administración en el Elastic Layer Manager (ELM) de destino se sobrescribirá con la contraseña del ELM de origen. Como solución alternativa, puede iniciar sesión en el ELM de destino como un usuario con privilegios de administrador y cambiar la contraseña de administrador predeterminada.
  • Después de la migración, las hojas Images, Connectors, Directory Services y User Layer Storage en el ELM de destino no se actualizan automáticamente. Es posible que observe que estas hojas aparecen vacías, aunque la hoja Layers muestre datos. Para mostrar la información correcta, actualice manualmente su navegador o pestaña.
  • Después de realizar una migración de copia, no puede iniciar capas de aplicaciones asignadas elásticamente en imágenes publicadas por el Elastic Layer Manager (ELM) de destino cuando se crea un nuevo recurso compartido de red.
    Causa
    El nuevo recurso compartido de red no contiene ninguna capa de aplicación que se haya asignado y sincronizado previamente con el recurso compartido de red original en el ELM de origen.
    Soluciones alternativas
    Solución alternativa 1: Ejecute el siguiente comando: mono /usr/local/unitools/MAService.exe -fire SyncRevisionsToShareEvent
    Solución alternativa 2: Copie manualmente todas las capas de aplicación del recurso compartido de red del ELM de origen al nuevo recurso compartido de red asociado con el ELM de destino.
    Solución alternativa 3: Desasigne y luego reasigne las capas de aplicación. Esta acción activará una sincronización de las capas con el nuevo recurso compartido de red.

App Layering 2312

La actualización a App Layering 2312 podría fallar, devolviendo el error "Se produjo un error al actualizar el dispositivo. Intente la actualización de nuevo después de revertir desde una instantánea limpia." Somos conscientes de un problema con algunos dispositivos que se actualizaron desde versiones anteriores. En este escenario, la actualización podría fallar debido a la presencia de componentes de actualización heredados. Estamos trabajando en una compilación parcheada para App Layering 2306 que contiene una solución permanente para este problema.
Para solucionar este problema, es necesario eliminar el módulo heredado realizando los siguientes cambios en el dispositivo de Layering:
  1. Inicie sesión en la consola del dispositivo utilizando el inicio de sesión y la contraseña de root.
  2. Ejecute el comando "yum remove mod_http2". La ejecución del comando puede tardar varios minutos.
  3. Una vez completado el comando, vuelva a iniciar sesión en el dispositivo mediante un navegador web y vuelva a ejecutar la actualización.
  4. La actualización puede tardar 30 minutos o más en completarse, pero ahora debe realizarse correctamente.

App Layering 2005

  • El paquete de actualización de App Layering 2005 es lo suficientemente grande como para que los dispositivos más antiguos no puedan descargarlo automáticamente. Si está ejecutando la versión 2001 o anterior, descargue el paquete manualmente desde el sitio de descargas.
  • Recomendamos ejecutar la actualización desde una consola de administración en HTTP seguro (HTTPS). Si actualiza mientras está en HTTP, los mensajes no se muestran en el navegador. Si esto ocurre, actualice el navegador después de 20 minutos. (Actualizar no causará problemas a pesar del mensaje que indica que no se actualice). Si la actualización sigue en curso, recibirá un error de "servicio no disponible". Es seguro ignorar el mensaje y seguir actualizando el navegador cada pocos minutos hasta que aparezca la página de inicio de sesión.
  • Si tiene dos paquetes de actualización con el mismo nombre en diferentes carpetas en el recurso compartido de red, al seleccionar uno de esos paquetes se seleccionan ambos. Si ambos paquetes tienen la misma versión, la actualización se realiza correctamente. Si tienen versiones diferentes, el sistema elige el número de versión inferior. Esto ocurre con Enterprise Layer Manager (ELM) versión 22.2.

Dispositivo y consola de administración de App Layering

  • En la nueva interfaz de usuario, los tipos de plataforma no se pueden editar. Editar tipos de plataforma sigue funcionando correctamente en la interfaz de usuario antigua. (UNI-86856)
  • Al instalar el dispositivo App Layering, debe usar la configuración de CPU predeterminada de 4 CPU.
  • Si utiliza roles en un entorno complejo de Active Directory y los inicios de sesión son lentos, asigne todos los roles a usuarios explícitos en lugar de a grupos.

Enlaces a la documentación de App Layering

Los enlaces de la documentación en la consola de administración se abren como una página en blanco en Internet Explorer 11. Para solucionar este problema, pegue el enlace en otro navegador. La documentación se muestra correctamente.

Agente de App Layering

De forma predeterminada, el agente de Citrix App Layering™ se ejecuta con la cuenta de Sistema local en el servidor Hyper-V. Si cambia la cuenta a una diferente de Sistema local, el agente no podrá transferir discos desde y hacia el dispositivo.

Herramientas de máquina del SO de App Layering

  • (Solo versión 19.5) Después de actualizar a la versión 19.5 (o posterior) desde la 19.3 (o anterior), asegúrese de actualizar la activación de KMS Office para usar Office 2019. Al preparar la imagen del SO para la creación de capas, descargue y ejecute las nuevas herramientas de máquina del SO de App Layering.
  • (Solo versión 19.1) Al preparar la imagen del SO para la creación de capas, asegúrese de que la activación de KMS Office se active al iniciar el escritorio. Solo para esta versión, descargue y ejecute las herramientas de máquina del SO de App Layering de la versión 18.12.

Microsoft Teams 2.x

  • Para obtener más información sobre Microsoft Teams 2.x, consulte Guía de implementación de New Teams para App Layering o User Personalization Layer (UPL).

Creación de capas elásticas

  • Microsoft Office no se puede aplicar en capas elásticas debido a la forma en que sus licencias están integradas con la Tienda Windows. La capa de la aplicación de Office debe incluirse en la imagen en capas.
  • Cuando habilita una imagen con capas elásticas, los usuarios podrían ver archivos y directorios de otras sesiones en el Explorador de Windows. Los directorios explorados en la otra sesión podrían crear carpetas visibles para todas las sesiones que tengan permiso para explorar ese directorio.
  • Si utiliza asignaciones de capas elásticas con Windows Server 2008 o Windows 7, cree su recurso compartido de archivos con un tamaño de sector de 512. Para obtener detalles sobre este problema y las actualizaciones del sistema operativo relacionadas, consulte lo siguiente:

Capas de usuario

  • Inicio de sesión después de la actualización inicia las pantallas de primer inicio de sesión de Windows: Al iniciar sesión después de actualizar a la versión 4.10 o posterior, el primer inicio de sesión de Windows habitual actualiza la capa de usuario a la versión del SO. El proceso conserva los archivos de la capa de usuario.

Compatibilidad con Windows 10

  • Actualizaciones de Windows 10, versión 20H2. Si actualiza la capa del SO a Windows 10 20H2 desde una versión anterior, actualice directamente a la compilación 19042.630 o posterior. La actualización desde compilaciones de Windows 10 20H2 publicadas antes del 11/16/2020 puede dar lugar a implementaciones de imágenes inconsistentes. Por ejemplo, si publica imágenes utilizando una plantilla con la opción Generalizar sin conexión seleccionada, es posible que las imágenes publicadas no funcionen correctamente.
  • La actualización requiere pasos adicionales al pasar a una nueva versión principal de Windows 10: Durante la actualización, Windows 10 puede crear un volumen de recuperación en el mismo disco que la versión de la capa del SO. Elimine siempre este volumen antes de finalizar la versión de la capa del SO. De lo contrario, el volumen de recuperación puede hacer que los escritorios no se inicien correctamente. Para obtener más información, consulte el problema 9 en Windows 10 v2004, 20H2, 21H1 y 21H2 - Problemas conocidos de Citrix.
  • Si ha generado y aplicado el script Optimizations.cmd de App Layering a una capa de SO de Windows 10 1909, es posible que la opción Buscar del menú Inicio no funcione como se espera. Para evitar este problema, agregue una versión a la capa del SO y ejecute el programa c:\windows\setup\scripts\Optimize.hta. Para crear un nuevo script Optimizations.cmd para aplicar a la nueva versión de la capa, anule la selección de Deshabilitar el servicio de entrada de tableta (Sección 6, Opción M) y seleccione Guardar archivo. Antes de finalizar la capa del SO, ejecute el comando Powershell Set-Service TabletInputService -startuptype manual para deshacer el efecto de cualquier Optimizations.cmd anterior que pudiera haber deshabilitado el servicio.

Conectores

  • Al usar el conector Azure Deployments, si elimina todas las plantillas y edita el conector para elegir una nueva plantilla, aparece una versión de plantilla eliminada. Luego, al hacer clic en Guardar, aparece un error. Como solución alternativa, vuelva a seleccionar una versión de plantilla válida antes de hacer clic en Guardar. (UNI-88412)
  • Cuando se utiliza la opción de disco de arranque mínimo de Windows, se pueden especificar hasta cuatro capas de requisitos previos para cualquier capa de aplicación determinada. Si una aplicación requiere que haya más de cuatro aplicaciones presentes durante la instalación, instale varias aplicaciones en una sola capa. (UNI-69524)
  • Al crear una capa (de aplicación, SO o plataforma) en Windows 7 de 64 bits, si selecciona Descargar composición en la configuración del conector, puede tener problemas al agregar una versión a la capa. Se produce un error y la máquina de empaquetado no se crea. Cuando Descargar composición no está seleccionada en la configuración del conector, la máquina de empaquetado se crea. (UNI-82545)
  • Recibiendo el error 503, "Problemas de servidor ocupado" de Azure. Si recibe este error de forma constante, siga los pasos de CTX310868. Este problema ocurre esporádicamente y se está probando una solución. (ALHELP-1383)
  • Si intenta introducir un nombre para un conector y ese nombre ya existe, recibirá un mensaje de error genérico del sistema, en lugar del mensaje de error correcto. El problema ocurre con los conectores Azure Deployments, Machine Creation for Azure Deployments, VMware vSphere y Machine Creation for vSphere. (UNI-89218)

Citrix Provisioning™

  • Al crear una plantilla de imagen, la configuración de hardware del dispositivo de destino debe coincidir con la configuración de la capa del sistema operativo Windows y de la plataforma. Asegúrese de que la configuración de hardware del dispositivo de destino coincida con la configuración de hardware de la capa del sistema operativo y de la plataforma, especialmente el número de CPU. Si la configuración no coincide, puede aparecer un mensaje de "reiniciar requerido" al iniciar la imagen publicada. (UNI-50799)
  • Si utiliza Provisioning Services, debe deshabilitar IPv6 en la capa del SO y no en la capa de la plataforma. (UNI-53600)
  • Al importar archivos VHDX publicados desde App Layering al almacén de discos de PVS, a veces recibe un mensaje de disco no válido. Elimine el error cambiando los caracteres de punto (.) en la fecha y hora del nombre del archivo publicado. Un nombre de archivo válido contiene solo un punto para la extensión de nombre de archivo VHDX. (UNI-75902)
  • Cuando se selecciona Offload Compositing en la configuración del conector:
    • La ruta del Citrix Provisioning Store no se valida si contiene espacios. Reemplace los espacios por %20 para que el nombre sea válido. (UNI-84868)
    • Los trabajos de publicación fallan si la ruta de recurso compartido de archivos termina con una barra invertida (\\). (UNI-85045)
    • Los trabajos de publicación fallan con un mensaje de error de ComponentActivator si el usuario de dominio no tiene permisos de lectura y escritura para la ruta de recurso compartido de archivos. (UNI-85020)
  • Cuando selecciona un conector Hyper-V para la configuración de composición de descarga y la capa de SO es Gen 2, debe crear otra versión de la capa de SO y, a continuación, crear la capa de plataforma a partir de esa versión de SO. De lo contrario, el destino no arranca. (UNI-85044)
  • Al establecer la ruta de recurso compartido de archivos de composición para la configuración del conector, no se verifica la conectividad entre el motor de composición y el Citrix Provisioning Store. Si la ruta del almacén no se asigna a la ruta de recurso compartido de archivos, recibirá un error similar a:
    • Error: "Se produjo un error inesperado del sistema. Vuelva a intentar la operación o póngase en contacto con el soporte técnico. Mensaje de excepción: El código de estado de la respuesta no indica éxito: 404 (No encontrado). (UNI-85045), (UNI-85020)

XenServer®

  • Cuando prepare la imagen del sistema operativo para usarla en su XenServer, debe abrir el puerto 5900 para permitir el acceso a la consola. (UNI-50846)
  • Configure siempre la configuración del conector de Citrix App Layering para que apunte al nodo maestro. (UNI-52454)
  • Capas de requisitos previos:
    • Si una máquina se bloquea al arrancar y se selecciona una capa de requisitos previos, es probable que uno de los discos de capa no esté conectado. Asegúrese de que las Citrix Guest Tools estén incluidas en las capas de SO o de plataforma.
    • Si utiliza capas de requisitos previos para crear la capa de SO o de plataforma, las Citrix Tools deben estar presentes. Sin las herramientas, la máquina de empaquetado falla y aparece una pantalla azul. XenServer no puede ver ningún dispositivo conectado después de la unidad de DVD. La unidad de DVD siempre está en la tercera ranura. (UNI-67741)

Aplicaciones y Escritorios Virtuales de Citrix™ (CVAD)

  • Al actualizar Citrix Virtual Apps and Desktops a la versión 7.15 CU4, primero debe instalar .NET Framework 4.7.1 en una nueva versión de su capa de SO, en lugar de en la capa de plataforma. La instalación de .NET Framework 4.7.1 en la capa de SO garantiza que todas las capas de aplicaciones, capas de plataforma e imágenes funcionen correctamente. Las últimas actualizaciones de Windows ya incluyen .NET Framework 4.7.1 como parte de las actualizaciones. (ALHELP-588, UNI-75108)

Google Cloud

  • Al importar capas de otra plataforma, debe agregar una versión a la capa del SO y, a partir de ese momento, cambiar a la nueva versión de la capa. De lo contrario, es probable que las máquinas de empaquetado y las imágenes publicadas fallen con una pantalla azul.
  • Configuración del conector de Google Cloud. "Comprobar credenciales" verifica el rol de usuario de la cuenta de servicio. Si la cuenta de servicio especificada en el archivo Service Account JSON key file de la configuración del conector de Google Cloud es diferente de la cuenta de servicio asociada a la Instance Template seleccionada, su cuenta de servicio en la configuración debe tener el rol de Service Account User. Si no lo tiene, recibirá un error al implementar una máquina con esa configuración de conector. (UNI-82082)

Nutanix Acropolis

  • El siguiente mensaje durante la creación de la capa de aplicación indica que la configuración de la capa de aplicación especifica una capa de plataforma. No utilice capas de plataforma con la función de almacenamiento en caché que mejora el rendimiento de la capa de aplicación. (UNI-67742)
    imagen

VMware vSphere

  • Al crear la capa del SO con el Asistente para crear capas del SO, se muestran las máquinas virtuales de la Interfaz de firmware extensible unificada (UEFI). Sin embargo, no puede crear máquinas UEFI con el asistente. En su lugar, utilice el nuevo script ImportOsLayer.ps1 para importar el SO a la nueva máquina de capa del SO.
  • Cuando se utiliza una configuración de conector de vSphere con VMware Cloud y un almacén de datos vSAN 7.0 Update 2 (o posterior), se debe seleccionar Offload Compositing. (UNI-85216)
  • Al usar el nuevo conector de VMware vSphere en AL 23.4, si selecciona una red opaca al crear o editar el conector, este falla. Como solución alternativa, seleccione una red no opaca. Las configuraciones de conector existentes que usan una red opaca creada antes de AL 23.4 siguen funcionando con normalidad. (UNI-89439)

Microsoft Azure

  • App Layering no es compatible con el almacenamiento de archivos de Azure. Para el almacenamiento en Azure, cree un recurso compartido de archivos SMB o un recurso compartido de archivos de red. (UNI-42272)
  • Los discos administrados solo son compatibles con las importaciones del SO. El empaquetado de capas de aplicación y la publicación de imágenes solo producen discos no administrados. Al crear una máquina virtual en Azure, seleccione No managed disks.

Microsoft Hyper-V

  • Al seleccionar una configuración de conector de Hyper-V para la composición de descarga y su capa de SO es Gen 2, la capa debe tener al menos una versión además de la original. Además, la capa de plataforma donde está instalado el software del dispositivo de destino de Citrix Provisioning debe crearse utilizando la nueva versión de la capa de SO. (UNI-85044)
  • Cuando una configuración de conector de Hyper-V está establecida para Offload Compositing con Gen 2 (UEFI) y VHDX, se permite elegir VHD como formato de disco en la configuración del conector de Citrix Provisioning, pero esta configuración no es compatible.
  • Al configurar Elastic Layering en Hyper-V, debe usar grupos de RDS no administrados (UNI-53545)
  • Al crear una capa de aplicación, si se especifica una capa de plataforma en la configuración de la capa de aplicación, recibirá un error. No utilice capas de plataforma con la función de almacenamiento en caché de App Layering. (UNI-71868, UNI-67743)
    image
  • La creación de una capa de SO en Hyper-V Server 2019 puede provocar este error:
    'No se pudo crear el VHD. Asegúrese de que haya suficiente espacio en el recurso compartido especificado en la configuración del conector.'
    Este error se debe a un problema con el cmdlet New-VHD de Microsoft PowerShell. Estamos atentos a una solución por parte de Microsoft. Mientras tanto, utilice la siguiente solución alternativa para este error:
    1. Asegúrese de que la VM Gold no tenga puntos de control.
    2. Asegúrese de que el disco de la VM Gold esté en la misma ruta de directorio que está configurada en la configuración del conector. Ejemplo: La ruta local es D:\Brock
      El disco de la VM Gold se almacena en D:\Brock\WIn10Gold\Win10GoldDisk.vhdx
  • App Layering no puede crear una capa de aplicación/plataforma si la ruta de almacenamiento en la configuración del conector de Hyper-V contiene una tilde grave (`). Por ejemplo:
    mystoragename`

Impresión

Con las imágenes de App Layering configuradas para Full User Layer, puede instalar sus propios dispositivos de impresora directamente. Sin embargo, al cerrar y volver a iniciar sesión, Impresoras y escáneres ya no muestran los dispositivos de impresora auto-instalados.
Como solución alternativa, puede acceder o seleccionar las impresoras desde las aplicaciones.

Red

Las aplicaciones que incluyen componentes de red pueden no funcionar correctamente cuando se instalan en una capa de aplicación y luego se incluyen en una imagen publicada. Las aplicaciones de este tipo deben instalarse en la capa de SO o en la capa de plataforma para garantizar una fusión adecuada de la información del registro relacionada con la red en la imagen.

Información relacionada

  • Centro de conocimiento de soporte
  • TechTalks de arquitectos empresariales: Preguntas frecuentes sobre Citrix App Layering
  • Debates sobre Citrix App Layering
  • Recetas de capas de aplicaciones