Agente

Last published : Nov 13, 2026
Related information
Instalar y configurar

Instalar y configurar el agente

Nota:
  • No instale el agente de Workspace Environment Management™ (WEM) en el servidor de infraestructura.
  • No instale el agente de WEM y la consola de administración en la misma máquina.
  • Si tiene la intención de asignar recursos publicados en los almacenes de Citrix StoreFront como accesos directos de aplicaciones en WEM desde la consola de administración, asegúrese de que Citrix Workspace app para Windows esté instalada en la consola de administración y en las máquinas host del agente. Para obtener más información, consulte Requisitos del sistema.

Paso 1: Configurar las directivas de grupo (opcional)

Opcionalmente, puede configurar las directivas de grupo para el agente mediante la plantilla administrativa Agent Group Policies. El paquete de instalación de WEM contiene esta plantilla. Los archivos de plantilla se dividen en archivos .admx y archivos .adml específicos del idioma. Le recomendamos que configure las directivas de grupo en el controlador de dominio.
Para agregar la directiva de configuración del host del agente, siga estos pasos:
  1. Copie la carpeta Agent Group Policies proporcionada con el paquete de instalación de WEM en su controlador de dominio de WEM.
  2. Agregue los archivos .admx.
    1. Vaya a la carpeta Agent Group Policies > ADMX.
    2. Copie los dos archivos (Citrix Workspace Environment Management Agent Host Configuration.admx y CitrixBase.admx).
    3. Vaya a la carpeta <C:\Windows>\PolicyDefinitions y, a continuación, pegue los archivos.
  3. Agregue los archivos .adml.
    1. Vaya a la carpeta Agent Group Policies > ADMX > en-US.
    2. Copie los dos archivos (Citrix Workspace Environment Management Agent Host Configuration.adml y CitrixBase.adml).
    3. Vaya a la carpeta <C:\Windows>\PolicyDefinitions\en-US y, a continuación, pegue los archivos.
  4. En la ventana Group Policy Management Editor, vaya a Computer Configuration > Policies > Administrative Templates > Citrix Components > Workspace Environment Management > Agent Host Configuration y configure los siguientes ajustes::
Editor de administración de directivas de grupo
Configuración personalizada para la implementación básica. Configuración de agente personalizada utilizada para la implementación. Para obtener más información sobre la configuración de agente disponible para la implementación básica, consulte Administrar agentes de implementación básica.
Configuración personalizada de WEM para la implementación básica
Anular tipo de implementación del agente. Anula el tipo de implementación del agente de WEM. Elija una de las siguientes opciones:
  • Implementación de servicio en la nube: Conecta el agente al servicio WEM en Citrix Cloud, lo que proporciona todas las funcionalidades de WEM.
  • Implementación local: Conecta el agente a una implementación de WEM local, lo que proporciona todas las funcionalidades de WEM.
  • Implementación básica: Ejecuta el agente en modo de máquina única con funcionalidad limitada, sin conectarse a una infraestructura de WEM.
  • Deshabilitado: Deshabilita todas las funciones de WEM en la máquina donde está instalado el agente.
Detectar Citrix Cloud Connector™ desde el servicio CVAD. No aplicable a las versiones locales de WEM. Deje el estado Sin configurar.
Servidor de infraestructura. La dirección del servidor de infraestructura de WEM. Escriba el nombre o la dirección IP de la máquina donde está instalado el servicio de infraestructura.
Puerto del servicio de agente. El puerto en el que el agente se conecta al servidor de infraestructura. El puerto del servicio de agente debe ser el mismo que el puerto que configuró para el puerto del servicio de agente durante la configuración de los servicios de infraestructura. Si no se especifica, el puerto predeterminado es 8286.
Puerto de sincronización de datos en caché. (Aplicable a Workspace Environment Management 1912 y versiones posteriores; reemplaza a Puerto de sincronización de caché de Workspace Environment Management 1909 y versiones anteriores.) El puerto en el que el proceso de sincronización de la caché del agente se conecta al servicio de infraestructura para sincronizar la caché del agente con el servidor de infraestructura. El puerto de sincronización de datos en caché debe ser el mismo que el puerto que configuró para el puerto de sincronización de datos en caché (Configuración del servicio de infraestructura de WEM > Configuración de red) durante la configuración de los servicios de infraestructura. El puerto predeterminado es 8288 y corresponde al argumento de línea de comandos CachedDataSyncPort. Alternativamente, puede especificar el puerto mediante una opción de línea de comandos en la instalación silenciosa del agente WEM. Por ejemplo:
  • citrix_wem_agent_bundle.exe /quiet CachedDataSyncPort=9000
Conectores de Citrix Cloud™. No aplicable a las versiones locales de WEM. Deje el estado No configurado.
Configuración del proxy del agente. No aplicable a las versiones locales de WEM. Deje el estado No configurado.
Retraso de sincronización adicional de VUEMAppCmd. Especifica, en milisegundos, cuánto tiempo espera el iniciador de aplicaciones del agente (VUEMAppCmd.exe) antes de que se inicien los recursos publicados de Citrix Virtual Apps and Desktops. Esto garantiza que el trabajo necesario del agente se complete primero. El valor recomendado es de 100 a 200. El valor predeterminado es 0.

Paso 2: Instalar el agente

Importante:
Aunque .NET Framework se puede instalar automáticamente durante la instalación del agente, le recomendamos que lo instale manualmente antes de instalar el agente. De lo contrario, deberá reiniciar su máquina para continuar con la instalación del agente, y podría tardar mucho tiempo en completarse.
Puede ejecutar Citrix Workspace™ Environment Management Agent en su entorno de usuario. También puede optar por instalar el agente mediante la línea de comandos. De forma predeterminada, el agente se instala en una de las siguientes carpetas, según su sistema operativo:
  • C:\Program Files (x86)\Citrix\Workspace Environment Management Agent (en SO de 64 bits)
  • C:\Program Files\ Citrix\Workspace Environment Management Agent (en SO de 32 bits)
Para instalar el agente de forma interactiva, siga estos pasos:
  1. Ejecute Citrix Workspace Environment Management Agent.exe en su máquina.
  2. Seleccione Acepto los términos y condiciones de la licencia y, a continuación, haga clic en Instalar.
  3. En la página de bienvenida, haga clic en Siguiente.
    Nota:
    La página de bienvenida puede tardar un tiempo en aparecer. Este retraso se produce cuando falta el software necesario y se está instalando en segundo plano.
  4. En la página Carpeta de destino, haga clic en Siguiente.
    • De forma predeterminada, el campo de la carpeta de destino se rellena automáticamente con la ruta de la carpeta predeterminada. Si quiere instalar el agente en otra carpeta, haga clic en Cambiar para ir a la carpeta y, a continuación, haga clic en Siguiente.
    • Si ya ha instalado el agente WEM, el campo de la carpeta de destino se rellena automáticamente con la ruta de la carpeta de instalación existente.
  5. En la página Tipo de implementación, seleccione el tipo de implementación aplicable y, a continuación, haga clic en Siguiente. En este caso, seleccione Implementación local.
  6. También puede seleccionar el tipo de Implementación básica. Cuando selecciona el tipo de Implementación básica, el agente activa la configuración de optimización predeterminada sin conectarse al servicio de infraestructura.
    Instalación del agente WEM 01
  7. En la página Configuración del servicio de infraestructura, especifique el servicio de infraestructura al que se conecta el agente y, a continuación, haga clic en Siguiente.
    • Omitir configuración. Seleccione esta opción si ya ha configurado el ajuste mediante la Directiva de grupo.
    • Configurar el servicio de infraestructura. Permite configurar el servicio de infraestructura escribiendo el FQDN o la dirección IP del servicio de infraestructura.
    • Puerto del servicio del agente. De forma predeterminada, el valor es 8286.
    • Puerto de sincronización de datos en caché. De forma predeterminada, el valor es 8288.
    Instalación del agente WEM 02
  8. En la página Configuración avanzada, configure los ajustes avanzados para el agente y, a continuación, haga clic en Siguiente.
    • Ubicación de caché alternativa (opcional). Permite especificar una ubicación alternativa para la caché del agente. Haga clic en Examinar para navegar a la carpeta aplicable. Alternativamente, puede hacerlo a través del registro. Para ello, primero detenga el servicio Citrix WEM Agent Host y luego modifique la siguiente clave de registro.
      HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Norskale\Agent Host
      Nombre: AgentCacheAlternateLocation
      Tipo: REG_SZ
      Valor: Vacío
      De forma predeterminada, el valor está vacío. La carpeta predeterminada es: <WEM agent installation folder path>\Local Databases Set. Especifique una ruta de carpeta diferente si es necesario. Para que los cambios surtan efecto, reinicie el servicio Citrix WEM Agent Host. Si el cambio surte efecto, los siguientes archivos aparecerán en la carpeta: LocalAgentCache.db y LocalAgentDatabase.db.
      Precaución:
      La edición incorrecta del registro puede causar problemas graves que podrían requerir la reinstalación del sistema operativo. Citrix no puede garantizar que los problemas resultantes del uso incorrecto del Editor del Registro puedan resolverse. Utilice el Editor del Registro bajo su propia responsabilidad. Asegúrese de hacer una copia de seguridad del registro antes de editarlo.
    • Retraso de sincronización adicional de VUEMAppCmd (opcional). Permite especificar cuánto tiempo espera el iniciador de aplicaciones del agente (VUEMAppCmd.exe) antes de que se inicien los recursos publicados. Establecer este retraso garantiza que el trabajo necesario del agente se complete primero. El valor predeterminado es 0.
      Nota:
      El valor que escriba para el intervalo de retraso de sincronización adicional debe ser un número entero mayor o igual que cero.
    Instalación del agente WEM 03
  9. En la página Listo para instalar, haga clic en Instalar.
  10. Haga clic en Finalizar para salir del asistente de instalación.
Alternativamente, puede elegir una instalación silenciosa del agente WEM. Para ello, utilice la siguiente línea de comandos:
  • "Citrix Workspace Environment Management Agent.exe" /quiet Cloud=0
Consejo:
  • Para los agentes que se ejecutan en una implementación de WEM local, introduzca Cloud=0. Para los agentes que se ejecutan en una implementación del servicio WEM, introduzca Cloud=1.
  • Es posible que desee consultar los archivos de registro para solucionar problemas de la instalación del agente. De forma predeterminada, los archivos de registro que registran todas las acciones que se producen durante la instalación se crean en %TEMP%. Puede utilizar el comando /log log.txt para designar una ubicación específica donde guardar los archivos de registro.
También puede utilizar opciones de línea de comandos para especificar argumentos personalizados. Esto le permite personalizar la configuración del agente y del sistema durante el proceso de instalación. Para obtener más información, consulte Información útil.
Después de la instalación, el agente se ejecuta como Citrix WEM Agent Host Service (anteriormente Norskale Agent Host Service) y Citrix WEM Agent User Logon Service. El agente se ejecuta como la cuenta LocalSystem. No admitimos el cambio de esta cuenta. El servicio requiere el permiso de iniciar sesión como sistema local.

Paso 3: Reinicie la máquina para completar la instalación

Requisitos previos y recomendaciones

Para asegurarse de que el agente de WEM funciona correctamente, tenga en cuenta los siguientes requisitos previos y recomendaciones:

Requisitos previos

verificar que se cumplen los siguientes requisitos:
  • El servicio de Windows System Event Notification Service está configurado para iniciarse automáticamente al arrancar.
  • Los servicios del agente de WEM Citrix WEM Agent Host Service y Citrix WEM User Logon Service están configurados para iniciarse automáticamente al arrancar.
  • La caché del agente reside en una ubicación persistente siempre que sea posible. El uso de una ubicación de caché no persistente puede causar posibles problemas de sincronización de caché, uso excesivo de datos de red, problemas de rendimiento, etc.

Recomendaciones

Siga las recomendaciones de esta sección para una implementación correcta del agente:
  • No opere manualmente el Citrix WEM Agent Host Service, por ejemplo, mediante scripts de inicio de sesión o de arranque. Operaciones como detener o reiniciar el Citrix WEM Agent Host Service pueden impedir que el servicio Netlogon funcione, lo que causaría problemas con otras aplicaciones.
  • No utilice scripts de inicio de sesión para iniciar agentes en modo UI o CMD. De lo contrario, algunas funcionalidades podrían no funcionar.

Comportamientos de inicio del agente

  • El Citrix WEM Agent Host Service recarga automáticamente la configuración de Cloud Connector configurada a través de la Directiva de grupo después de que se inicie el servicio.
  • El Citrix WEM Agent User Logon Service inicia automáticamente el Citrix WEM Agent Host Service si el servicio de host del agente no se inicia durante el primer inicio de sesión. Este comportamiento garantiza que la configuración del usuario se procese correctamente.
  • El Citrix WEM Agent Host Service realiza automáticamente comprobaciones en los siguientes archivos de base de datos locales al inicio: LocalAgentCache.db y LocalAgentDatabase.db. Si la máquina virtual está aprovisionada y los archivos de base de datos locales provienen de la imagen base, los archivos de base de datos se purgan automáticamente.
  • Cuando se inicia el Citrix WEM Agent Host Service, verifica automáticamente que la caché local del agente se haya actualizado recientemente. Si la caché no se ha actualizado durante más de dos intervalos de tiempo de sincronización de caché configurados, la caché se sincroniza inmediatamente. Por ejemplo, supongamos que el intervalo de sincronización de la caché del agente predeterminado es de 30 minutos. Si la caché no se actualizó en los últimos 60 minutos, se sincroniza inmediatamente después de que se inicie el Citrix WEM Agent Host Service.
  • Durante la instalación, el instalador del agente WEM configura el servicio de Windows System Event Notification Service para que se inicie automáticamente.
  • El instalador del agente WEM inicia automáticamente el servicio Netlogon una vez completada la actualización del agente WEM.

Opciones de la utilidad de caché del agente

El Citrix WEM Agent Host Service gestiona automáticamente la actualización de la configuración y la sincronización de la caché. Utilice la utilidad de caché del agente solo en escenarios en los que sea necesario actualizar inmediatamente la configuración y sincronizar la caché.
Utilice la línea de comandos para ejecutar AgentCacheUtility.exe en la carpeta de instalación del agente. El ejecutable acepta los siguientes argumentos de línea de comandos:
  • -help: Muestra una lista de argumentos permitidos.
  • -RefreshCache o -r: Activa la creación o actualización de una caché.
  • -RefreshSettings o -S: Actualiza la configuración del host del agente.
  • -Reinitialize o -I: Reinicializa la caché del agente cuando se usa junto con la opción -RefreshCache.
Consulte los siguientes ejemplos para obtener detalles sobre cómo usar la línea de comandos:
  • Actualizar la configuración del host del agente:
    • AgentCacheUtility.exe -RefreshSettings
  • Actualizar la configuración del host del agente y la caché del agente simultáneamente:
    • AgentCacheUtility.exe -RefreshSettings -RefreshCache
  • Reinicializar la caché del agente:
    • AgentCacheUtility.exe -RefreshCache -Reinitialize

Es bueno saberlo

El ejecutable del agente acepta argumentos personalizados como se describe en las secciones Configuración del agente y Configuración del sistema.

Configuración del agente

La configuración del agente de WEM incluye:
  • AgentLocation. Permite especificar la ubicación de instalación del agente. Especifique una ruta de carpeta válida.
  • AgentCacheLocation. Permite especificar una ubicación alternativa para la caché del agente. Si está configurado, el archivo de caché local del agente se guarda en la ubicación designada en lugar de en la carpeta de instalación del agente.
  • AgentCacheSyncPort. Permite especificar el puerto en el que el proceso de sincronización de la caché del agente se conecta al servicio de infraestructura para sincronizar la caché del agente con el servidor de infraestructura.
  • AgentServicePort. Permite especificar el puerto en el que el agente se conecta al servidor de infraestructura.
  • InfrastructureServer. Permite especificar el FQDN o la dirección IP del servidor de infraestructura donde se ejecuta el servicio de infraestructura.
  • VUEMAppCmdDelay. Permite especificar cuánto tiempo espera el iniciador de aplicaciones del agente (VUEMAppCmd.exe) antes de que se inicien los recursos publicados de Citrix Virtual Apps and Desktops. El valor predeterminado es 0 (milisegundos). El valor que escriba para el intervalo de retardo de sincronización adicional debe ser un número entero mayor o igual que cero.
Tenga en cuenta lo siguiente:
  • Si configura los parámetros mediante la línea de comandos, el instalador del agente de WEM utiliza los parámetros configurados.
  • Si no configura los parámetros mediante la línea de comandos y hay parámetros configurados previamente, el instalador utiliza los parámetros que se configuraron anteriormente.
  • Si no configura los parámetros mediante la línea de comandos y no hay parámetros configurados previamente, el instalador utiliza los parámetros predeterminados.

Configuración del sistema

La configuración del sistema asociada a la máquina host del agente incluye:
  • GpNetworkStartTimeoutPolicyValue. Permite configurar el valor, en segundos, de la clave de registro GpNetworkStartTimeoutPolicyValue creada durante la instalación. Este argumento especifica cuánto tiempo espera la directiva de grupo a las notificaciones de disponibilidad de red durante el procesamiento de directivas al iniciar sesión. El argumento acepta cualquier número entero en el rango de 1 (mínimo) a 600 (máximo). De forma predeterminada, este valor es 120.
  • SyncForegroundPolicy. Permite configurar el valor de registro SyncForegroundPolicy durante la instalación del agente. Esta configuración de directiva determina si el procesamiento de la directiva de grupo es sincrónico. Valores aceptados: 0, 1. Si el valor no está establecido o lo establece en 0, el servicio de inicio de sesión de usuario del agente de Citrix WEM no retrasa los inicios de sesión y la configuración de la directiva de grupo de usuario se procesa en segundo plano. Si establece el valor en 1, el servicio de inicio de sesión de usuario del agente de Citrix WEM retrasa los inicios de sesión hasta que finalice el procesamiento de la configuración de la directiva de grupo de usuario. De forma predeterminada, el valor no cambia durante la instalación.
    Importante:
    Si la configuración de la directiva de grupo se procesa en segundo plano, Windows Shell (Explorador de Windows) podría iniciarse antes de que se procese toda la configuración de la directiva. Por lo tanto, es posible que algunas configuraciones no surtan efecto la primera vez que un usuario inicia sesión. Si desea que toda la configuración de la directiva se procese la primera vez que un usuario inicia sesión, establezca el valor en 1.
  • WaitForNetwork. Permite configurar el valor, en segundos, de la clave de registro WaitForNetwork creada durante la instalación. Este argumento especifica cuánto tiempo espera el host del agente a que la red se inicialice y esté disponible por completo. El argumento acepta cualquier número entero en el rango de 0 (mínimo) a 300 (máximo). De forma predeterminada, este valor es 30.
Las tres claves anteriores garantizan que el servicio del agente de WEM se inicie antes de que aparezca la pantalla de inicio de sesión de Windows. Las tres claves se crean en HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon durante la instalación. Las claves también garantizan que el entorno de usuario reciba las GPO de la dirección del servidor de infraestructura antes del inicio de sesión. En entornos de red donde los servidores de Active Directory o de controlador de dominio tardan en responder, puede que se produzca un tiempo de procesamiento adicional antes de que aparezca la pantalla de inicio de sesión. Recomendamos establecer el valor de la clave GpNetworkStartTimeoutPolicyValue en un mínimo de 30 para que tenga efecto.
  • ServicesPipeTimeout. Permite configurar el valor de la clave de registro ServicesPipeTimeout. La clave se crea durante la instalación en HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control. Esta clave de registro añade un retraso antes de que el administrador de control de servicios pueda informar sobre el estado del servicio del agente de WEM. El retraso evita que el agente falle al impedir que el servicio del agente se inicie antes de que se inicialice la red. Este argumento acepta cualquier valor, en milisegundos. Si no se especifica, se utiliza un valor predeterminado de 60000 (60 segundos).
    Nota:
    Si no configura los ajustes anteriores mediante la línea de comandos, el instalador del agente de WEM no los procesa durante la instalación.

Ejemplos

Puede configurar los ajustes mediante el siguiente formato de línea de comandos:
  • "Citrix Workspace Environment Management Agent.exe" <key=value>
Por ejemplo:
  • Elija una instalación o actualización silenciosa del agente de WEM
    • "Citrix Workspace Environment Management Agent.exe" /quiet Cloud=0
  • Establezca el tiempo de espera de la red de inicio de sesión de usuario en 60 segundos
    • "Citrix Workspace Environment Management Agent.exe" WaitForNetwork=60