Scripts para tareas con script
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 personalizadosScripts 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:
-
Crear contenido del scriptEscriba un script de PowerShell según sus requisitos.
-
Validar el contenido del scriptUtilice 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:
-
En la página Tareas con script, haga clic en la ficha Personalizado y, a continuación, en Agregar script personalizado.
-
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,
PSScriptRootse utiliza como carpeta de trabajo predeterminada. Para obtener más información sobrePSScriptRoot, 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:
-
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.
-
Haga clic en los puntos suspensivos del script y, a continuación, seleccione Editar script. Aparecerá el asistente Editar script.
-
En la ficha Información de la tarea, configure los ajustes según sea necesario.
-
En la ficha Archivo de script, vea el contenido del script.
-
Haga clic en Guardar.
Nota:
No se pueden editar los scripts integrados.
Eliminar un script
Para eliminar un script, siga estos pasos:
-
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.
-
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:
-
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.
-
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:
-
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.
-
Haga clic en los puntos suspensivos del script y, a continuación, seleccione Configurar tareas.
-
En el asistente Seleccionar conjunto de configuración, elija el conjunto de configuración donde quiera crear la tarea.
-
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:
-
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.
-
Haga clic en los puntos suspensivos del script y, a continuación, seleccione Crear tarea externa.
-
En el asistente Seleccionar conjunto de configuración, elija el conjunto de configuración donde quiera crear la tarea.
-
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:
|
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: