Documentación de productos
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Ver PDF

Instalar agentes VDA mediante SCCM

November 25, 2025
Contribución de: 
C

Información general

Microsoft Endpoint Configuration Manager, anteriormente System Center Configuration Manager (SCCM), es un producto de Windows que habilita la administración, implementación y protección de dispositivos y aplicaciones en toda la empresa.

Nota:

El siguiente artículo describe solo las recomendaciones basadas en la forma en que Citrix® ha probado el entorno. Puede personalizar estos pasos según sus necesidades. Citrix no se hace responsable de las actualizaciones o ajustes necesarios para adaptarlo a las necesidades de los clientes.

Recomendaciones

  • Para implementar correctamente un Virtual Delivery Agent (VDA) con SCCM o herramientas de distribución de software similares, Citrix recomienda usar el instalador de VDA a través de una serie de pasos.

  • Citrix no recomienda utilizar la utilidad de limpieza de VDA como parte de la instalación o la actualización de un VDA. Utilice la utilidad de limpieza de VDA solamente en el caso limitado en que el instalador de VDA haya fallado antes.

Antes de comenzar

La cantidad de reinicios necesarios durante la instalación del VDA depende del entorno. Por ejemplo:

  • Es posible que necesite reiniciar por actualizaciones pendientes o instalaciones de software anteriores.
  • Es posible que haya archivos previamente bloqueados por otros procesos que necesiten actualizaciones, lo que obliga a realizar un reinicio más.
  • Es posible que algunos componentes opcionales del instalador de VDA (como Citrix Profile Management o Citrix Files) requieran un reinicio.
  • Al actualizar la versión de un VDA, la máquina en la que está instalado debe estar en modo de mantenimiento, sin sesiones.
  • Cuando se ejecuta la instalación de un VDA por primera vez en una máquina, el instalador de VDA que se utiliza se copia en esa máquina. Para obtener más información sobre la instalación de VDA, consulte Instaladores.

El secuenciador de tareas de SCCM administra todos los reinicios necesarios.

Pasos clave para implementar VDA con SCCM

En los pasos siguientes se describe cómo implementar el VDA mediante SCCM en la máquina virtual.

  1. Instalar el VDA.
  2. Crear una unidad organizativa (OU).
  3. Verificar las máquinas.
  4. Usar VDA para distribuir contenido.

Paso 1: Instalar el VDA

Después de identificar todos los requisitos previos, use el secuenciador de tareas de SCCM para completar las siguientes tareas:

  1. Instale los VDA desde una copia accesible de los medios de instalación o desde uno de los instaladores independientes de VDA:

    • VDAWorkstationSetup_XXXX.exe
    • VDAServerSetup_XXXX.exe
    • VDAWorkstationCoreSetup_XXXX.exe

    Para obtener más información sobre los instaladores de VDA, consulte Instaladores.

    Nota:

    Al actualizar la versión de un VDA, la máquina en la que está instalado debe estar en modo de mantenimiento, sin sesiones.

  2. Cuando se ejecuta la instalación de un VDA por primera vez en una máquina, el instalador de VDA que se utiliza se copia en esa máquina.
    • Cuando utiliza un instalador de VDA distinto de VDAWorkstationCoreSetup_XXXX.exe, el instalador de VDA se copia a %ProgramData%\Citrix\XenDesktopSetup\XenDesktopVdaSetup.exe.
    • Cuando usa VDAWorkstationCoreSetup_XXXX.exe, el instalador de VDA se copia a %ProgramData%\Citrix\XenDesktopSetup\XenDesktopRemotePCSetup.exe.

  3. La ubicación del directorio del instalador del VDA también se almacena en el registro HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\MetaInstall” “MetaInstallerInstallLocation”.

  4. Agregue las opciones de línea de comandos /NOREBOOT, /NORESUME y /QUIET a sus opciones de línea de comandos.

    • /QUIET: No mostrar la interfaz de usuario durante la instalación, para que SCCM tenga control del proceso de instalación.
    • /NOREBOOT: Evita que el instalador de VDA se reinicie automáticamente. SCCM activa los reinicios cuando es necesario.
    • /NORESUME: En general, cuando se necesita reiniciar durante la instalación, el instalador del VDA establece una clave de registro de ejecución única (\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce). Windows usa la clave para abrir el instalador del VDA cuando se reinicia la máquina. Esto es un problema para SCCM, ya que SCCM no puede supervisar la instalación ni capturar el código de salida.

Paso 2: Crear una unidad organizativa (OU)

  1. Cree dos máquinas virtuales unidas a un dominio que quiera agregar a la OU. Cuando se crean inicialmente las máquinas virtuales, se encuentran en la carpeta Computers. Mueva las máquinas virtuales a la carpeta SCCM. Ejemplo: WIN10EN-BB80MJ4.cseblr.com W2K19ST-EBPR3UG.cseblr.com

    VDA gestionado por SCCM

  2. En Microsoft Configuration Manager, vaya a “\Administración\Descripción general\Configuración de jerarquía\Métodos de descubrimiento\”.

  3. Haga clic en Detección del sistema de Active Directory y seleccione la casilla de verificación Habilitar detección del sistema de Active Directory para habilitar la detección automática de las máquinas virtuales recién creadas.

  4. Haga clic en el icono icon para seleccionar nuevos contenedores.

  5. En la sección Ubicación, agregue la ruta donde se encuentran sus máquinas virtuales de SCCM.

  6. Vaya a \Administración\Descripción general\Configuración del sitio\Sitios y haga clic con el botón secundario en el VDA gestionado por SCCM.

  7. Seleccione Configuración de instalación del cliente > Instalación push del cliente. Se abre la ventana Propiedades de instalación push del cliente .

  8. Una vez que las máquinas virtuales estén configuradas en Habilitadas, podrá ver la lista de máquinas virtuales como se ilustra en las siguientes imágenes.

    SCCM

    SCCM-2

  9. Cree la colección de dispositivos para crear la OU. Introduzca el nombre de la colección.

    Colección de dispositivos

  10. Siga las instrucciones del asistente.

    Reglas de pertenencia

    Se crea la OU.

    Creación de OU

  11. Agregue las máquinas virtuales creadas a la colección de dispositivos recién creada.

    1. Haga clic con el botón secundario en la VM. Seleccione Agregar elementos seleccionados > Agregar elementos seleccionados a la colección de dispositivos existente.

      Agregar elemento

    2. En la ventana Seleccionar colección, seleccione el nombre del dispositivo requerido. En este ejemplo, es Dispositivos-SCCM.

      Lista de dispositivos

    Dispositivos-SCCM se muestra en Activos y cumplimiento > Descripción general > Colecciones de dispositivos.

    Dispositivo en la lista

  12. Seleccione Instalar cliente en el recopilador de dispositivos.

    Instalar cliente

  13. Seleccione el sitio de la instalación.

    Sitio de instalación

  14. Siga las instrucciones del asistente. El asistente de instalación del cliente de Configuration Manager se completa correctamente.

    Instalación completa

Para obtener información detallada, consulte Administrar colecciones en la documentación de Microsoft.

Paso 3: Verificar las máquinas

  1. En la máquina cliente, verifique que el cliente esté instalado verificando si el proceso CCMExec está ejecutándose.

    CCMexe.exe

  2. Verifique si el cliente se está ejecutando para las máquinas virtuales de SCCM.

Paso 4: Usar VDA para distribuir contenido

Los pasos siguientes describen cómo puede usar el VDA implementado para distribuir contenido en las máquinas virtuales asociadas.

  1. Crear un paquete

  2. Distribuir contenido

Crear un paquete

  1. Para crear un paquete, haga clic con el botón secundario en el VDA y haga clic en Crear paquete.

    Crear paquete

  2. Especifique la ubicación de los archivos de origen de este paquete haciendo clic en Examinar.

    Examinar paquete

  3. Seleccione un tipo de paquete.

    Asistente para la creación de paquetes y programas

  4. Introduzca el nombre del paquete y la línea de comandos.

    Especificar los detalles del paquete

  5. Haga clic en Siguiente.

    Paquete correcto

Para obtener información detallada, consulte Paquetes y programas en Configuration Manager en la documentación de Microsoft.

Distribuir contenido

  1. Haga clic con el botón secundario en el nombre del paquete que ha creado.

  2. Seleccione Distribuir contenido.

    Distribuir contenido

  3. En la ventana del asistente para la distribución de contenido, seleccione la ubicación de los archivos de origen del paquete que ha creado. En este ejemplo, es 2019-SCCM. Haga clic en Siguiente.

    Especificar ubicación

  4. Verifique que el paquete (en este ejemplo, Zodiac) esté disponible para implementar.

    Verificación

    La siguiente imagen muestra que el paquete está disponible para su implementación.

    Paquete para implementar

Para obtener información detallada, consulte Implementar y administrar contenido para Configuration Manager en la documentación de Microsoft.

Ejemplo de secuencia de instalación mediante SCCM

En este ejemplo se muestra la secuencia de instalación.

  1. Reiniciar el equipo: Prepare la máquina reiniciándola.

    Reinicie el equipo

  2. Primer intento de instalación del VDA: Inicie la instalación del VDA.

    1. Agregue las opciones /quiet, /noreboot y /noresume a sus opciones de línea de comandos.

    2. Ejecute el instalador de VDA que prefiera (imagen local o uno de los instaladores mínimos).

      Primer intento de instalación del VDA

    3. SCCM debe capturar el código de devolución.

      • Si el código de devolución es 0 u 8, la instalación se ha completado y es necesario reiniciar.

        SCCM captura el código de devolución

      • Si el código de devolución es 3, reinicie la máquina y, a continuación, pase el control a Segundo intento de instalación del VDA.

        Reiniciar máquina

  3. Segundo intento de instalación del VDA: Prosiga con la instalación del VDA.

    1. Después del Primer intento de instalación del VDA si el archivo %programdata%\Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xml existe, la instalación no está completa y debe continuarse después de que se complete el reinicio.

      Segundo intento de instalación del VDA

    2. Segundo intento de instalación del VDA se repite hasta que el archivo %programdata%\Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xml no exista o se devuelva un código de retorno distinto de 0 u 8. Trate los demás códigos de devolución como un error y SEGUNDO INTENTO DE INSTALCIÓN DEL VDA debería notificar un error y detenerse.

    3. Reanude la instalación de VDA ejecutando el instalador de VDA apropiado (XenDesktopVdaSetup.exe para la mayoría de los casos, o XenDesktopRemotePCSetup.exe si se utilizó VDAWorkstationCoreSetup_XXXX.exe) desde el directorio del archivo “%programdata%\ Citrix\XenDesktopSetup\” sin parámetros de línea de comandos. (el instalador de VDA utiliza los parámetros que guardó durante la primera ejecución del instalador).

      Actualizar la versión del editor de secuencia de tareas

    4. Preste atención al código de devolución del instalador de VDA.

      • 0 u 8: Operación correctamente realizada, instalación completa, es necesario reiniciar.

        Instalación exitosa completada

      • 3: La instalación no se ha completado. Reinicie la máquina y repita SEGUNDO INTENTO DE INSTALACIÓN DEL VDA hasta que el archivo %programdata%\ Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xml no exista o hasta que se devuelva un 0 o un 8. Trate los demás códigos de devolución como un error y SEGUNDO INTENTO DE INSTALCIÓN DEL VDA debería notificar un error y finalizar.

Para obtener más información acerca de los códigos de retorno, consulte Códigos de retorno en la instalación de Citrix.

Ejemplos de comandos de instalación de VDA

Las opciones de instalación disponibles varían dependiendo del instalador que se utilice. Consulte los siguientes artículos para obtener información detallada sobre las opciones de línea de comandos

Comandos de instalación para Acceso con Remote PC

  • El siguiente comando utiliza el instalador principal de VDA de sesión única (VDAWorkstationCoreSetup.exe):

    VDAWorkstationCoreSetup.exe /quiet /controllers “control.domain.com” /enable_hdx_ports /noresume /noreboot

  • El siguiente comando utiliza el instalador VDA completo de sesión única (VDAWorkstationSetup.exe):

    VDAWorkstationSetup.exe /quiet /remotepc /physicalmachine /controllers “control.domain.com” /enable_hdx_ports /noresume /noreboot

Comando de instalación para imagen de disco virtual (VDI) dedicada

  • El siguiente comando utiliza el instalador VDA completo de sesión única (VDAWorkstationSetup.exe):

    VDAWorkstationSetup.exe /quiet /components vda /controllers “control.domain.com” /enable_hdx_ports /enable_remote_assistance /noresume /noreboot

Instalar agentes VDA mediante SCCM
November 25, 2025
Contribución de: 
C
November 25, 2025
Contribución de: 
C

En este artículo

Comentarios sobre el sitio | Your privacy choices footer linkSus opciones de privacidad | Condiciones legales y de privacidad | Preferencias de cookies | Parámetros de consentimiento | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.