Workspace Environment Management

Tareas externas

Controla la ejecución de tareas externas. Las tareas externas incluyen scripts y aplicaciones en ejecución siempre que el host del agente tenga los programas correspondientes para ejecutarlas. Los scripts utilizados comúnmente incluyen: scripts .vbs y .cmd.

Con la función de tareas externas, puede especificar cuándo ejecutar una tarea externa. Al hacerlo, podrá administrar de manera más eficaz los entornos de usuario.

Consejo:

Puede utilizar tokens dinámicos para ampliar las acciones de Workspace Environment Management y hacerlas más eficaces.

Lista de tareas externas

Una lista de las tareas externas existentes. Puede utilizar Buscar para filtrar la lista.

Para agregar una tarea externa

  1. Utilice el comando Agregar del menú contextual.
  2. Introduzca los detalles en las fichas de diálogo Nueva tarea externa y, a continuación, haga clic en Aceptar.

Campos y controles

Agregar tarea externa

Nombre. Permite especificar el nombre para mostrar de la tarea externa, que aparece en la lista de tareas externas.

Descripción. Permite especificar información adicional sobre la tarea externa.

Ruta. Permite especificar la ruta de acceso a la tarea externa. La ruta de acceso se resuelve en el entorno de usuario. Asegúrese de que:

  • La ruta de acceso especificada aquí es coherente con el host del agente.
  • El host del agente tiene el programa correspondiente para ejecutar la tarea.

Argumentos. Permite especificar parámetros o argumentos de inicio. Puede escribir una cadena. La cadena contiene argumentos para pasar a la aplicación o script de destino. Para ver ejemplos de uso de los campos Ruta y Argumentos, consulte Ejemplos de tareas externas.

Estado de tarea externa. Controla si la tarea externa está habilitada o inhabilitada. Cuando se inhabilita, el agente no procesa la tarea aunque la tarea esté asignada a los usuarios.

Ejecutar oculto. Si está seleccionada, la tarea se ejecuta en segundo plano y no se muestra a los usuarios.

Ejecutar una vez. Si se selecciona, WEM ejecuta la tarea solo una vez, independientemente de las opciones que seleccione en la ficha Desencadenadores e independientemente de si los agentes se reinician. Esta es la opción predeterminada.

Orden de ejecución. Le permite especificar el orden de ejecución de cada tarea. La opción puede resultar útil cuando tiene varias tareas asignadas a los usuarios y algunas de esas tareas dependen de que otras se ejecuten correctamente. De forma predeterminada, el valor es 0. Las tareas con un valor de orden de ejecución de 0 (cero) se ejecutan primero, después las que tienen un valor de 1, luego las que tienen un valor de 2, y así sucesivamente.

Espere a que finalice la tarea. Permite especificar cuánto tiempo espera el agente a que se complete la tarea. De forma predeterminada, el valor Tiempo de espera es de 30 segundos.

Tipo de acción. Describe qué tipo de acción es la tarea externa.

Activadores de tareas externas

Desencadenadores de sesión de usuario. Esta función le permite configurar las siguientes actividades de sesión como activadores de tareas externas:

  • Actualizar. Controla si se debe ejecutar la tarea externa cuando los usuarios actualicen el agente. De forma predeterminada, la opción está seleccionada.

  • Vuelva a conectar. Controla si se debe ejecutar la tarea externa cuando un usuario se vuelve a conectar a un equipo en el que se está ejecutando el agente. De forma predeterminada, la opción está seleccionada. Si el agente de WEM está instalado en un dispositivo Windows físico, esta opción no es aplicable.

  • Índice. Controla si se debe ejecutar la tarea externa cuando los usuarios inician sesión. De forma predeterminada, la opción está seleccionada.

  • Cierre de sesión. Controla si se debe ejecutar la tarea externa cuando los usuarios cierran la sesión. Esta opción no funciona a menos que Citrix User Logon Service se esté ejecutando. De forma predeterminada, la opción no está seleccionada.

  • Desconectar. Controla si se ejecuta la tarea externa cuando un usuario se desconecta de una máquina en la que se ejecuta el agente. De forma predeterminada, la opción no está seleccionada.

  • Bloqueo. Controla si se ejecuta la tarea externa cuando un usuario bloquea una máquina en la que se ejecuta el agente. De forma predeterminada, la opción no está seleccionada.

  • Desbloquee. Controla si se ejecuta la tarea externa cuando un usuario desbloquea una máquina en la que se ejecuta el agente. De forma predeterminada, la opción no está seleccionada.

Al usar las opciones de desconexión, bloqueo y desbloqueo, tenga en cuenta las siguientes restricciones:

  • La implementación de estas opciones se basa en eventos de Windows. En algunos entornos, es posible que estas opciones no funcionen según lo esperado. Por ejemplo, en escritorios que se ejecutan en agentes VDA de sesión única con Windows 10 o Windows 11, la opción de desconexión no funciona. En su lugar, use la opción de bloqueo. (En este caso, la acción que recibimos es “bloquear”).

  • Le recomendamos que utilice estas opciones con el agente de interfaz de usuario. Dos razones:

    • Cuando utiliza las opciones con el agente CMD, el agente se inicia en el entorno de usuario cada vez que se produce el evento correspondiente, para comprobar si se ejecuta la tarea externa.
    • Es posible que el agente de CMD no funcione de manera óptima en casos de tareas simultáneas.

Desencadenadores de procesos de usuario. Esta función le permite configurar los procesos de usuario como activadores de tareas externas. Con esta función, puede definir tareas externas para suministrar recursos solo cuando se están ejecutando ciertos procesos y para revocar esos recursos cuando finalicen los procesos. El uso de procesos como desencadenantes para tareas externas le permite administrar sus entornos de usuario con mayor precisión en comparación con el procesamiento de tareas externas al iniciar o cerrar sesión.

  • Antes de utilizar esta función, compruebe que se cumplen los siguientes requisitos previos:

    • El agente de WEM se inicia y se ejecuta en modo UI.
    • Los procesos especificados se ejecutan en la misma sesión de usuario que el usuario que ha iniciado sesión.
    • Para mantener actualizadas las tareas externas configuradas, asegúrese de seleccionar Habilitar actualización automática en la ficha Configuración avanzada > Configuración > Opciones avanzadas.
  • Ejecute cuando comiencen los procesos. Controla si se ejecuta la tarea externa cuando se inician los procesos especificados.

  • Ejecute cuando finalicen los procesos. Controla si se ejecuta la tarea externa cuando finalizan los procesos especificados.

Solución de problemas

Después de habilitar la función, el agente de WEM crea un archivo de registros denominado Citrix WEM Agent Logoff.log la primera vez que un usuario cierra la sesión. El archivo de registros se encuentra en la carpeta raíz del perfil de un usuario. El agente de WEM escribe información en el archivo de registros cada vez que el usuario cierra la sesión. La información le ayuda a supervisar y solucionar problemas relacionados con tareas externas.

Ejemplos de tareas externas

Para un script (por ejemplo, script de PowerShell):

  • Si ni la ruta de la carpeta ni el nombre del script contienen espacios en blanco:
    • En el campo Ruta, escriba lo siguiente: C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe.
    • En el campo Argumentos, escriba lo siguiente: C:\<folder path>\<script name>.ps1.

    Como alternativa, puede escribir la ruta del archivo de script directamente en el campo Ruta. Por ejemplo: C:\<folder path>\<script name>.ps1. En el campo Argumentos, especifique argumentos si es necesario. Sin embargo, si el archivo de script se ejecuta o se abre con un programa diferente depende de las asociaciones de tipos de archivo configuradas en el entorno de usuario. Para obtener información sobre las asociaciones de tipos de archivo, consulte Asociaciones de archivos.

  • Si la ruta de acceso a la carpeta o el nombre del script contiene espacios en blanco:
    • En el campo Ruta, escriba lo siguiente: C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe.
    • En el campo Argumentos, escriba lo siguiente: -file C:\<folder path>\<script name>.ps1.

Para una aplicación (por ejemplo, iexplore.exe):

  • En el campo Ruta, escriba lo siguiente: C:\Program Files\"Internet Explorer"\iexplore.exe.
  • En el campo Argumentos, escriba la URL del sitio web que quiere abrir: https://docs.citrix.com/.
Tareas externas