Scripts para tareas con script

Last published : Nov 13, 2026

Introducción

Esta página le permite administrar scripts que puede automatizar o ejecutar en sus agentes WEM. Los scripts se organizan en las siguientes categorías:
  • Scripts listos para usar para las necesidades comunes de administración y solución de problemas de VDA.
  • Scripts personalizados
    Scripts creados por el administrador para la automatización específica del entorno y los requisitos operativos.
Nota:
Para configurar tareas automatizadas a partir de un script, vaya a Tareas con script en un conjunto de configuración.

Agregar un script personalizado

La página Tareas con script enumera todos los scripts integrados y cualquier script personalizado creado por usted u otros administradores. Puede agregar scripts personalizados adicionales según sea necesario para satisfacer sus requisitos.

Antes de empezar

Antes de crear un script personalizado en la consola web de WEM:
  1. Crear contenido del script
    Escriba un script de PowerShell según sus requisitos.
  2. Validar el contenido del script
    Utilice la herramienta Citrix Environment Tool Hub > Scripted Task Validator para ejecutar el script y revisar los resultados de la ejecución. Si es necesario, puede exportar el script para importarlo posteriormente a la consola web de WEM.
    Para obtener más información, consulte Validar y exportar una tarea con script.

Flujo de trabajo

Para añadir un script personalizado, realice los siguientes pasos:
  1. En la página Tareas con script, haga clic en la ficha Personalizado y, a continuación, en Agregar script personalizado.
  2. En el asistente Agregar script personalizado, configure los siguientes ajustes y, a continuación, haga clic en Guardar.
    • Nombre del script. Especifique un nombre para el script.
    • Descripción. Opcionalmente, especifique información adicional para ayudarle a identificar el script.
    • Ámbito (opcional). Especifique el ámbito al que pertenece este script. Solo los administradores autorizados para ese ámbito pueden acceder a este script. Si no especifica un ámbito, solo los administradores completos de WEM pueden acceder a este script.
    • Etiquetas. Seleccione entre las etiquetas existentes o introduzca etiquetas separadas por comas. Una etiqueta no debe tener más de 20 caracteres. Las etiquetas son como palabras clave o rótulos. El uso de etiquetas le permite identificar sus scripts de nuevas maneras. Además, actúan como filtros, lo que le permite reorganizar la vista de los scripts en función de los criterios que le interesen. Puede usar tantas etiquetas como desee.
    • Tipo de archivo. Seleccione un tipo de archivo para el script. Se admiten dos tipos de archivos:
      • PowerShell. Archivos de script de PowerShell individuales.
      • ZIP. Varios archivos agrupados en un único archivo zip. No se admiten archivos zip de más de 10 MB. Después de cargar un archivo zip, especifique un punto de entrada, que indica qué archivo se debe ejecutar al principio del script. Tenga en cuenta que el archivo de punto de entrada no debe estar a más de tres niveles de profundidad en la estructura de carpetas.
    • Cargar archivo. Haga clic en Examinar, vaya al archivo, selecciónelo y, a continuación, haga clic en Abrir. Volverá al asistente Agregar script personalizado.
      Sugerencia:
      Puede cargar un script de dos maneras:
      • Seleccione un archivo .zip que ya haya colocado en la máquina de la consola web.
      • Después de exportar un script con la herramienta Scripted Task Validator, el contenido se copia automáticamente en el portapapeles. En la página Agregar script personalizado, pegue el contenido directamente desde el portapapeles (<Ctrl+V>). Este método evita la necesidad de almacenar un archivo .zip en la máquina de la consola web.
    • Conceder permisos. Especifique el nivel de acceso que desea conceder al script. Asegúrese de comprender los permisos asociados a cada opción.
      • Acceso total. Un script al que se le asigna Acceso total tiene un amplio acceso local. Si se selecciona, al script se le conceden permisos como si se ejecutara bajo la cuenta del sistema local.
      • Acceso limitado (con acceso a la red). Un script al que se le asigna Acceso limitado (con acceso a la red) no tiene un amplio acceso local, pero puede acceder a los recursos de red. Si se selecciona, al script se le conceden permisos como si se ejecutara bajo la cuenta de servicio de red.
      • Acceso limitado (sin acceso a la red). Un script al que se le asigna Acceso limitado (sin acceso a la red) no tiene un amplio acceso local y no puede acceder a los recursos de red. Si se selecciona, al script se le conceden permisos como si se ejecutara bajo la cuenta de servicio local.
      • Ejecutar como usuario con sesión iniciada. Si se selecciona, el script se ejecuta en el contexto de la sesión de un usuario con sesión iniciada y se le conceden los mismos permisos, independientemente de si la sesión de usuario está activa o desconectada.
      Para obtener más información, consulte la documentación de Microsoft <https://docs.microsoft.com/es-es/windows/security/identity-protection/access-control/security-identifiers#well-known-sids>.
    • Carpeta de trabajo. Opcionalmente, escriba la ruta de acceso absoluta de la carpeta local en el sistema operativo del usuario final. La carpeta de trabajo es la carpeta actual para el archivo cuando se inicia. Puede crear la ruta con variables de entorno (por ejemplo, %ProgramFiles%). Si no se especifica, PSScriptRoot se utiliza como carpeta de trabajo predeterminada. Para obtener más información sobre PSScriptRoot, consulte la documentación de Microsoft <https://docs.microsoft.com/es-es/powershell/module/microsoft.powershell.core/about/about_automatic_variables?view=powershell-7.1>.
    • ¿Esta tarea genera archivos de salida?. Elija si el script que agrega genera archivos de salida.
    • Ruta de salida. Escriba una ruta de acceso relativa a la carpeta donde reside el archivo. La ruta debe contener el nombre del archivo y la extensión del archivo. Ejemplo: output\report.txt.

Administrar scripts

Puede administrar scripts para satisfacer sus necesidades. Las acciones disponibles incluyen:

Editar un script

Para editar un script, siga estos pasos:
  1. En la página Tareas con scripts, localice el script. Utilice el cuadro de búsqueda o las etiquetas para encontrarlo rápidamente si es necesario.
  2. Haga clic en los puntos suspensivos del script y, a continuación, seleccione Editar script. Aparecerá el asistente Editar script.
  3. En la ficha Información de la tarea, configure los ajustes según sea necesario.
  4. En la ficha Archivo de script, vea el contenido del script.
  5. Haga clic en Guardar.
Nota:
No se pueden editar los scripts integrados.

Eliminar un script

Para eliminar un script, siga estos pasos:
  1. En la página Tareas con scripts, localice el script. Utilice el cuadro de búsqueda o las etiquetas para encontrarlo rápidamente si es necesario.
  2. Haga clic en los puntos suspensivos del script y, a continuación, seleccione Eliminar script.
Importante:
No se pueden eliminar los scripts integrados.

Clonar un script

Para clonar un script, siga estos pasos:
  1. En la página Tareas con scripts, localice el script. Utilice el cuadro de búsqueda o las etiquetas para encontrarlo rápidamente si es necesario.
  2. Haga clic en los puntos suspensivos del script y, a continuación, seleccione Clonar script.
Nota:
Al clonar un script, se le pedirá que cambie el nombre para evitar nombres duplicados.

Configurar tareas con script

Para configurar y automatizar tareas con script, siga estos pasos:
  1. En la página Tareas con script, busque el script. Utilice el cuadro de búsqueda o las etiquetas para encontrarlo rápidamente si es necesario.
  2. Haga clic en los puntos suspensivos del script y, a continuación, seleccione Configurar tareas.
  3. En el asistente Seleccionar conjunto de configuración, elija el conjunto de configuración donde quiera crear la tarea.
  4. Siga los pasos de Crear una tarea con script para completar la configuración.

Crear una tarea externa a partir de un script

Utilice esta acción para crear una tarea externa directamente a partir de un script existente.
Sugerencia:
Las tareas con script funcionan a nivel de máquina. Para ejecutar tareas a nivel de sesión de usuario, cree tareas externas en su lugar.
Para crear una tarea externa a partir de un script, siga estos pasos:
  1. En la página Tareas con script, busque el script. Utilice el cuadro de búsqueda o las etiquetas para encontrarlo rápidamente si es necesario.
  2. Haga clic en los puntos suspensivos del script y, a continuación, seleccione Crear tarea externa.
  3. En el asistente Seleccionar conjunto de configuración, elija el conjunto de configuración donde quiera crear la tarea.
  4. Siga los pasos de Crear una tarea externa para completar la configuración.

Scripts integrados

Actualmente, ofrecemos los siguientes scripts integrados para su uso:

Comprobación de estado de la nube

Le permite ejecutar comprobaciones que evalúan el estado de los Virtual Delivery Agents (VDA). Las comprobaciones de estado de VDA identifican posibles causas de problemas comunes de registro de VDA e inicio de sesión. Cloud Health Check se ejecuta bajo la cuenta del sistema local en el host del agente.

Administración de servicios de Windows

La administración de servicios de Windows proporciona funciones de uso frecuente relacionadas con los servicios de Windows, como iniciar, detener, reiniciar y configurar uno o varios servicios de Windows.

Reiniciar servicio de Windows

Este script comprueba el estado de un servicio de Windows. Si el servicio no se está ejecutando actualmente y se especifica el parámetro ForceStart, el script inicia el servicio. Independientemente del estado actual, si el servicio se está ejecutando y no requiere un inicio forzado, se reinicia para garantizar que funcione con la configuración más reciente o para recuperarse de un estado bloqueado.
Parámetros
nombre tipo predeterminado obligatorio Nota
ServiceNames cadena BrokerAgent Falso Especifica los nombres de los servicios que se van a administrar. Si no se proporciona, el valor predeterminado es BrokerAgent. Si necesita introducir más de un servicio, separe los nombres de los servicios con una coma. Se eliminarán todos los espacios. Por ejemplo, ServicioA, ServicioB.
ForceStart booleano verdadero Falso Indica si se debe iniciar el servicio si se detecta que no se está ejecutando. No afecta a los servicios en ejecución. Los servicios en ejecución siempre se reinician para fines de mantenimiento o recuperación.

Detener servicio de Windows

Este script detiene una lista de servicios de Windows especificados. El script comprueba si cada servicio está instalado e intenta detenerlo forzosamente. A continuación, el script verifica si el servicio se ha detenido correctamente e informa del estado.
Parámetros
nombre tipo predeterminado obligatorio Nota
ServiceNames cadena BrokerAgent Falso Especifica los nombres de los servicios que se van a administrar. Si no se proporciona, el valor predeterminado es BrokerAgent. Si necesita introducir más de un servicio, separe los nombres de los servicios con una coma. Se eliminarán todos los espacios. Por ejemplo, ServiceA, ServiceB.

Configurar servicio de Windows

Este script ajusta las configuraciones de los servicios de Windows, incluido el tipo de inicio y las acciones de recuperación.
Parámetros
nombre tipo predeterminado obligatorio Nota
ServiceNames cadena BrokerAgent Falso Especifica los nombres de los servicios que se van a administrar. Si no se proporciona, el valor predeterminado es BrokerAgent. Si necesita introducir más de un servicio, separe los nombres de los servicios con una coma. Se eliminarán todos los espacios. Por ejemplo, ServiceA, ServiceB.
StartupType cadena nulo Falso Establece el tipo de inicio del servicio. Las opciones válidas son Automático, Manual o Deshabilitado.
FirstFailureAction cadena nulo Falso Define la acción para el primer fallo. Por ejemplo, reiniciar/ninguno.
SecondFailureAction cadena nulo Falso Define la acción para el segundo fallo consecutivo.
SubsequentFailureAction cadena nulo Falso Define la acción para todos los fallos posteriores al segundo.

Reinicio del servidor

Reiniciar máquina

Este script reinicia la máquina local con una opción de retardo y forzado opcional.
Parámetros
nombre tipo predeterminado obligatorio Nota
Force booleano verdadero Falso Si se especifica, fuerza un reinicio inmediato, ignorando cualquier dato no guardado o sesión de usuario activa.
Delay entero 10 Falso Especifica el retardo en segundos antes de que se reinicie el equipo. Debe estar entre 3 y 30 segundos. El valor predeterminado es 10 segundos.

Administración de seguimiento CDF

Iniciar seguimiento CDF

Este script inicia el proceso de rastreo CDF utilizando como entrada un único archivo CTL o una categoría de archivo CTL predefinida. Rastrea los módulos definidos en los archivos CTL seleccionados y se detiene automáticamente cdfcontrol.exe después de la duración especificada por el parámetro RunMinutes.
Parámetros
Nombre Tipo Predeterminado Obligatorio Nota
traceOutputPath cadena C:\ProgramData\Citrix\WEM\CDFLogs Falso Especifica la ruta de salida de los informes CDF.
category cadena all Falso
Especifica las categorías predefinidas para iniciar el rastreo. Los valores admitidos son:
  • all
  • always on tracing
  • desktop Server os vda
  • delivery controller
  • federated authentication service
  • provisioning service
  • universal print server
  • citrix director
  • citrix studio
  • session recording administration
  • session recording player
  • citrix workspace app for windows
ctlFilePath cadena nulo Falso Especifica el archivo ctl con el que iniciar el seguimiento.
RunMinutes Entero 30 Falso Especifica cuánto tiempo se ejecuta cdfcontrol.exe antes de que se detenga y salga automáticamente.

Detener el rastreo de CDF

Este script detiene el rastreo de la herramienta CDF.

Limpieza de registros de CDF

Es útil limpiar los registros de rastreo de CDF para ahorrar consumo de almacenamiento. Debería proporcionar una función para eliminar archivos CDF del directorio dado.
nombre tipo predeterminado obligatorio Nota
FileAgeDays entero 3 Falso Especifica el umbral de antigüedad en días. Los archivos y carpetas más antiguos que este valor se eliminan. El valor predeterminado es de 3 días y este parámetro es opcional. Todos los archivos o directorios se eliminan si el FileAgeDays es inferior a 1 día.

Recopilar registros de fallos de Citrix AOT

Este script es una herramienta de automatización integral diseñada para recopilar y procesar registros de Citrix AOT. Se integra con Citrix CDFControl para configurar la recopilación de rastreos, aplicar filtros (predeterminado: Level=1, Class=Failure) y convertir archivos ETL (Event Trace Log) a un formato CSV legible para su análisis.
Nombre Tipo Predeterminado Obligatorio Nota
StartTime [DateTime] EndTime - 30 minutes Falso Especifica la hora de inicio para el filtrado de registros
EndTime [DateTime] Fecha y hora actuales Falso Especifica la hora de finalización para el filtrado de registros

Comprobar la configuración de DNS

Este script es una herramienta completa de comprobación del estado de DNS diseñada para entornos Citrix VDA. Valida la configuración de DNS y realiza la resolución de problemas para identificar posibles problemas relacionados con DNS que puedan afectar a los servicios de Citrix.
Nombre Tipo Predeterminado Obligatorio Nota
DomainName [string] No aplicable Falso Especifica el nombre de dominio para probar la resolución de DNS (habilita la prueba de resolución de nombres DNS)
FlushDNS [switch] Falso Falso Especifica si se debe vaciar la caché DNS como una acción independiente

Comprobar licencia RDS

Este script es una herramienta completa de validación de licencias de Servicios de Escritorio remoto (RDS) diseñada para comprobar la configuración y el estado de las licencias RDS en equipos locales. Es particularmente útil en entornos Citrix VDA, donde el cumplimiento de las licencias RDS es esencial para un funcionamiento adecuado. Utilice este script para garantizar el cumplimiento de las licencias y mantener un acceso de usuario multisecuencia ininterrumpido.
Nombre Tipo Predeterminado Obligatorio Nota
DomainName [string] No aplicable Falso Especifica el nombre de dominio para probar la resolución DNS (habilita la prueba de resolución de nombres DNS)
FlushDNS [switch] Falso Falso Especifica si se debe vaciar la caché DNS como una acción independiente

Diagnosticar la anulación del registro de VDA

Este script es una herramienta de diagnóstico completa diseñada para solucionar problemas de anulación del registro de Citrix Virtual Delivery Agent (VDA). Realiza múltiples comprobaciones de estado y procedimientos de diagnóstico para identificar las posibles causas de los problemas de anulación del registro de VDA en entornos Citrix.
Nombre Tipo Predeterminado Obligatorio Nota
StartTime [DateTime] EndTime - 30 minutes Falso Especifica la hora de inicio para el filtrado de registros
EndTime [DateTime] Fecha y hora actuales Falso Especifica la hora de finalización para el filtrado de registros

Ejecutar comprobación de estado de Profile Management

Este script realiza una comprobación de estado exhaustiva de su implementación de Citrix Profile Management. Escanea las configuraciones en busca de posibles problemas y analiza los registros para detectar problemas críticos, como errores de perfil temporal y brechas de tiempo significativas durante los inicios de sesión.
Nombre Tipo Predeterminado Obligatorio Nota
CtxSessionKey [string] nulo Falso Especifica la clave de sesión de Citrix utilizada para buscar registros de sesión específicos. Si no se especifica, el script analiza las sesiones de las últimas 24 horas.
LogonTime [string] nulo Falso Especifica la hora de inicio de sesión para filtrar las búsquedas de registros de eventos. Acepta varios formatos de fecha y hora. Si no se especifica, el script filtra los registros de eventos de las últimas 24 horas.
StructuredOutputOnly [switch] True Falso Especifica si se deben generar datos JSON estructurados sin registro en la consola.
Parallel [switch] True Falso Especifica si se debe usar procesamiento paralelo para las operaciones de análisis de registros para mejorar el rendimiento.

Establecer desencadenador de restablecimiento de perfil

Este script establece un desencadenador para restablecer el perfil de un usuario. Durante el siguiente inicio de sesión del usuario, se realiza una copia de seguridad del perfil existente y se crea una nueva carpeta de perfil limpia.
Nombre Tipo Predeterminado Obligatorio Nota
CtxSessionKey [string] nulo True Especifica la clave de sesión de Citrix utilizada para activar un restablecimiento de perfil para el siguiente inicio de sesión del usuario.
FoldersToRestore [string] nulo Falso Especifica las carpetas que se restaurarán después de un restablecimiento de perfil. Si no se especifica, las carpetas conocidas como Descargas, Escritorio e Imágenes se restauran de forma predeterminada.
BackupNameSuffix [string] nulo Falso Especifica el sufijo para el nombre de la carpeta de copia de seguridad durante un restablecimiento de perfil. Si no se especifica, el sufijo predeterminado es upm_%CurrentTimeStamp%.

Diagnosticar problemas de Citrix AOT

Este script valida la configuración de Citrix Always On Tracing (AOT), diagnostica problemas comunes y genera un informe de diagnóstico de AOT para facilitar la solución de problemas. Al establecer el parámetro StructuredOutputOnly en true, los resultados se muestran en una vista de interfaz de usuario estructurada para una revisión más sencilla.
Nombre Tipo Predeterminado Obligatorio Nota
StructuredOutputOnly [boolean] falso Falso Si se especifica, el script solo genera el informe de diagnóstico JSON sin procesar en lugar del texto formateado legible por humanos.

Recopilar registros de diagnóstico de Citrix

Este script recopila registros de Citrix Always On Tracing (AOT) y registros de eventos de Windows del VDA y los guarda como un archivo ZIP con marca de tiempo.
Nombre Tipo Predeterminado Obligatorio Nota
LogType [string] No aplicable Falso Controla qué registros recopilar. AOTLog recopila solo archivos ETL de AOT, EventLog recopila solo registros de eventos de Windows. Deje vacío para recopilar ambos.
RestartTelemetryService [boolean] verdadero Falso Si se debe detener y reiniciar CitrixTelemetryService antes de recopilar los registros AOT, lo que libera los bloqueos de archivos en los archivos ETL. Acepta true o false. El valor predeterminado es true.
StartTime [DateTime] Hace 24 horas Falso Especifica la hora de inicio para la recopilación de registros. El valor predeterminado es hace 24 horas. Ejemplo: 2025-08-01 10:57:15
EndTime [DateTime] Hora actual Falso Especifica la hora de finalización para la recopilación de registros. El valor predeterminado es la hora actual. Debe ser posterior a StartTime. Ejemplo: 2025-08-14 11:57:15
OutputPath [string] C:\ProgramData\Citrix\WEM\CitrixLogs Falso Directorio donde escribir el archivo zip de salida. El valor predeterminado es C:\ProgramData\Citrix\WEM\CitrixLogs.

Recopilar registros de eventos de Windows

Este script recopila registros de eventos de Windows del Virtual Delivery Agent (VDA) y los guarda como un archivo ZIP con marca de tiempo.
Nombre Tipo Predeterminado Obligatorio Nota
LogChannelPrefixes [string] No aplicable Falso Prefijos separados por comas para hacer coincidir con los nombres de los canales ETW. Cuando se proporciona, anula la recopilación predeterminada de cuatro registros. Ejemplo: Citrix-HostCore,Microsoft-Windows-AppLocker.
ProviderPrefixes [string] No aplicable Falso Prefijos separados por comas para hacer coincidir los nombres de los proveedores/fuentes de eventos. El script descubre automáticamente a qué canales de registro escribe cada proveedor a través de sus LogLinks, por lo que funciona tanto con registros clásicos (Aplicación, Sistema) como con canales ETW personalizados. Cuando se proporciona, anula la recopilación predeterminada de cuatro registros. Ejemplo: WEM Agent Service,Norskale Agent Service.
StartTime [DateTime] Hace 24 horas Falso Especifica la hora de inicio para la recopilación de registros de eventos. El valor predeterminado es 24 horas antes. Ejemplo: 2025-08-01 10:57:15
EndTime [DateTime] Hora actual Falso Especifica la hora de finalización para la recopilación de registros de eventos. El valor predeterminado es la hora actual. Debe ser posterior a StartTime. Ejemplo: 2025-08-14 11:57:15
OutputPath [string] C:\ProgramData\Citrix\WEM\CitrixEventLogs Falso Directorio donde escribir el archivo zip de salida. El valor predeterminado es C:\ProgramData\Citrix\WEM\CitrixEventLogs.

Recopilar diagnósticos de Citrix Scout

Este script ejecuta ScoutCLI.exe para recopilar datos de diagnóstico de Citrix del VDA y guarda la salida como un archivo ZIP con marca de tiempo. Opcionalmente, puede excluir recopiladores específicos, como MSI o localdata.
Nombre Tipo Predeterminado Obligatorio Nota
OutputPath [string] C:\ProgramData\Citrix\WEM\CitrixScoutCliLogs Falso Directorio donde escribir el archivo zip de salida de Scout. El valor predeterminado es C:\ProgramData\Citrix\WEM\CitrixScoutCliLogs.
Exclude [string] No aplicable Falso Lista de recopiladores separados por comas para excluir de la recopilación de Scout. Valores admitidos: msi, localdata. Deje vacío para incluir todos los recopiladores.

Más información

Para ver ejemplos de cómo usar tareas con script, consulte: