Tareas generadas por script
Introducción
Sugerencia:
Las tareas programadas funcionan a nivel de máquina. Para ejecutar tareas a nivel de sesión de usuario, utilice en su lugar tareas externas .
Esta página le permite agregar tareas generadas por script que puede personalizar para que se adapten a sus necesidades únicas de administración del entorno. A continuación, puede automatizar esas tareas con Workspace Environment Management (WEM) configurándolas en el conjunto de configuraciones aplicable.
Actualmente, proporcionamos la siguiente tarea generada por script integrada para que la utilice:
- Comprobación de estado de Cloud
- Administración de servicios de Windows
- Reinicio del servidor
- Gestión de rastreo de CDF
Comprobación de estado de Cloud
Le permite ejecutar comprobaciones que evalúan el estado de Virtual Delivery Agents (VDA). Las comprobaciones de estado de los VDA identifican posibles causas de problemas comunes con el registro y el inicio de sesión de los VDA. Cloud Health Check se ejecuta en 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 el servicio de Windows, como iniciar, detener, reiniciar y configurar uno o más servicios de Windows.
Reiniciar el 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 forzoso, se reinicia para garantizar que funciona con la configuración más reciente o para recuperarse de un estado estancado.
Parámetros
| name | type | default | mandatory | Nota |
|---|---|---|---|---|
ServiceNames |
cadena | BrokerAgent | False | Especifica el nombre 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 recortarían todos los espacios. Por ejemplo, ServiceA, ServiceB. |
ForceStart |
booleano | true | False | Indica si se debe iniciar el servicio si se descubre que no se está ejecutando. No afecta a los servicios en ejecución; los servicios en ejecución siempre se reinician con fines de mantenimiento o recuperación. |
Detener el servicio de Windows
Este script detiene una lista de los servicios de Windows especificados. El script comprueba si cada servicio está instalado e intenta forzar la detención del servicio. A continuación, el script verifica si el servicio se ha detenido correctamente e informa del estado.
Parámetros
| name | type | default | mandatory | Nota |
|---|---|---|---|---|
ServiceNames |
cadena | BrokerAgent | False | Especifica el nombre 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 recortarían todos los espacios. Por ejemplo, ServiceA, ServiceB. |
Configurar el servicio de Windows
Este script ajusta las configuraciones de los servicios de Windows, incluidos el tipo de inicio y las acciones de recuperación.
Parámetros
| name | type | default | mandatory | Nota |
|---|---|---|---|---|
ServiceNames |
cadena | nulo | true | Especifica el nombre 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 recortarían todos los espacios. Por ejemplo, ServiceA, ServiceB. |
StartupType |
cadena | nulo | False | Establece el tipo de inicio del servicio. Las opciones válidas son Automático, Manual o Inhabilitado. |
FirstFailureAction |
cadena | nulo | False | Define la acción del primer fallo. Por ejemplo, reiniciar/ninguno. |
SecondFailureAction |
cadena | nulo | False | Define la acción para el segundo error consecutivo. |
SubsequentFailureAction |
cadena | nulo | False | Define la acción para todos los errores posteriores al segundo. |
Reinicio del servidor
Reiniciar máquina
Este script reinicia la máquina local con una opción opcional de demora y fuerza.
Parámetros
| name | type | default | mandatory | Nota |
|---|---|---|---|---|
Force |
booleano | true | False | Si se especifica, fuerza un reinicio inmediato, ignorando los datos no guardados o las sesiones de usuario activas. |
Delay |
int | 10 | False | Especifica la demora en segundos que transcurre antes de que se reinicie el equipo. Debe durar entre 3 y 30 segundos. El valor predeterminado es 10 segundos. |
Gestión de rastreo de CDF
Iniciar el rastreo de CDF
Este script toma un archivo CTL o una categoría predefinida de archivos CTL como entrada para iniciar el proceso de la herramienta CDF y comenzar a rastrear los modelos en los archivos CTL.
Parámetros
| name | type | default | mandatory | Nota |
|---|---|---|---|---|
traceOutputPath |
cadena | C:\ProgramData\Citrix\WEM\CDFLogs |
False | Especifica la ruta de salida de los informes CDF. |
category
|
cadena
|
10
|
False
|
Especifica las categorías predefinidas con las que iniciar el seguimiento. Los valores admitidos son
allalways on tracingdesktop Server os vdadelivery controllerfederated authentication serviceprovisioning serviceuniversal print servercitrix directorcitrix studiosession recording administrationsession recording playercitrix workspace app for windows |
ctlFilePath |
cadena | nulo | False | Especifica el archivo ctl con el que iniciar el rastreo. |
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 los archivos CDF del directorio dado.
| name | type | default | mandatory | Nota |
|---|---|---|---|---|
FileAgeDays |
int | 3 | False | Especifica el umbral de antigüedad en días. Se eliminan los archivos y carpetas anteriores a este valor. El valor predeterminado es de 3 días y este parámetro es opcional. Todos los archivos o directores se eliminan si FileAgeDays es menos de 1 día. |
Sugerencia:
- Puede diferenciar entre tareas generadas por script personalizadas e integradas: las tareas personalizadas se marcan con la etiqueta “CUSTOM” y las integradas con la etiqueta “CITRIX”.
- Las tareas integradas con guiones siempre aparecen por encima de las personalizadas. Las tareas generadas por script personalizadas se ordenan en orden descendente según la última vez que se modificaron.
Con esta función, puede ampliar las capacidades de WEM para sus necesidades de administración únicas. Por ejemplo, la tarea integrada con scripts Cloud Health Check le permite medir el estado de los VDA. La tarea se basa en scripts. Puede escribir su propio archivo de scripts. A continuación, agregue el archivo de script a WEM como una tarea generada por script para poder automatizar la tarea mediante WEM.
Cada vez que se ejecuta una tarea generada por script, se genera un informe correspondiente. El informe incluye información sobre cuándo se ejecuta la tarea, los resultados de la ejecución de la tarea y más, lo que le permite auditar las actividades relacionadas con la tarea.
Las tareas generadas por script funcionan a nivel de conjunto de configuraciones. A continuación se muestra un flujo de trabajo general para usar tareas generadas por script:
-
En la página Tareas generadas por script, agregue una tarea generada por script.
-
Navegue hasta el conjunto de configuraciones para el que quiere habilitar la tarea generada por script.
-
En la página Configuración de tareas generadas por script de ese conjunto de configuraciones, habilite la tarea generada por script. Consulte Configuración de tareas generadas por script.
-
Si lo quiere, puede ver los informes relacionados con la tarea generada por script. Hay dos maneras de hacerlo:
- Vaya a Supervisión > Informes y vea los informes allí.
- Vaya a Tareas generadas por script o a la página Configuración de tareas generadas por script de un conjunto de configuraciones. Busque la tarea con guión, seleccione los puntos suspensivos y, a continuación, seleccione Ver informes. A continuación, se le dirigirá a la página Supervisión > Informes, con los filtros relevantes aplicados automáticamente. A continuación, podrá ver los informes relacionados.
Para obtener información sobre los informes de tareas generadas por script, consulte Informes.
Agregar una tarea generada por script
Para agregar una tarea generada por script, lleve a cabo los siguientes pasos:
-
En la página Tarea generada por script, haga clic en Agregar tarea generada por script.
-
En el asistente Agregar tarea generada por script, configure los siguientes valores y, a continuación, haga clic en Guardar.
-
Nombre de la tarea. Especifique un nombre para la tarea.
-
Etiquetas. Seleccione una de 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 etiquetas. El uso de etiquetas le permite identificar sus tareas de nuevas maneras. Además, actúan como filtros, lo que le permite reorganizar la vista de las tareas en Tareas generadas por script en función de los criterios que son importantes para usted. Puede usar tantas etiquetas como quiera.
-
Descripción. Si lo quiere, especifique información adicional que le ayude a identificar la tarea.
-
Tipo de archivo. Seleccione un tipo de archivo para la tarea. 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 indique qué archivo se va a ejecutar al principio de la tarea con script. Tenga en cuenta que el archivo de punto de entrada no debe tener más de tres niveles de profundidad en la estructura de carpetas.
-
Cargue el archivo. Haga clic en Examinar, desplácese hasta el archivo, selecciónelo y, a continuación, haga clic en Abrir. Volverá al asistente para agregar tareas generadas por script.
-
Otorgue permisos. Especifique el nivel de acceso que desea conceder a la tarea programada. Asegúrese de entender los permisos asociados a cada opción.
- Acceso completo. Una tarea con guión a la que se ha asignado acceso completo tiene un amplio acceso local. Si se selecciona, a la tarea generada por script se le conceden permisos como si se ejecutara en la cuenta del sistema local.
- Acceso limitado (con acceso a la red). Una tarea con script a la que se asigna acceso limitado (con acceso a la red) no tiene un acceso local extenso, pero puede acceder a los recursos de la red. Si se selecciona, a la tarea generada por script se le conceden permisos como si se ejecutara en la cuenta de servicio de red.
- Acceso limitado (sin acceso a la red). Una tarea generada por script a la que se asigna acceso limitado (sin acceso a la red) no tiene acceso local extenso y no puede acceder a los recursos de la red Si se selecciona, a la tarea generada por script se le conceden permisos como si se ejecutara en la cuenta de servicio local.
For more information, see the Microsoft documentation https://docs.microsoft.com/en-us/windows/security/identity-protection/access-control/security-identifiers#well-known-sids.
-
-
Carpeta de trabajo. De manera opcional, escriba la ruta absoluta de la carpeta local en el sistema operativo del usuario final. La carpeta de trabajo es la carpeta actual del 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 por defecto. Para obtener más información acerca dePSScriptRoot, consulte la documentación de Microsoft https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_automatic_variables?view=powershell-7.1. -
Esta tarea genera archivos de salida. Elija si la tarea que agrega genera archivos de salida.
-
Ruta de salida. Escriba una ruta relativa a la carpeta en la que reside el archivo. La ruta debe contener el nombre del archivo y la extensión del nombre del archivo. Ejemplo:
output\report.txt.
Modificar una tarea generada por script
Para modificar una tarea generada por script, lleve a cabo los siguientes pasos:
-
En la página Tareas generadas por script, busque la tarea. Si es necesario, use el cuadro de búsqueda para buscar rápidamente la tarea.
-
Haga clic en los puntos suspensivos de la tarea y, a continuación, seleccione Modificar tarea. Aparece el asistente Modificar tareas generadas por script.
-
En la ficha Información de la tarea, configure los parámetros según sea necesario.
-
En la ficha Contenido del script, consulte el contenido del script.
-
Haga clic en Guardar.
Nota:
No puede modificar tareas generadas por script integradas.
Eliminar una tarea generada por script
Para eliminar una tarea generada por script, lleve a cabo los siguientes pasos:
-
En la página Tareas generadas por script, busque la tarea. Si es necesario, use el cuadro de búsqueda para buscar rápidamente la tarea.
-
Haga clic en los puntos suspensivos de la tarea y, a continuación, seleccione Eliminar tarea.
Importante:
- No puede eliminar tareas generadas por script integradas.
- Para eliminar una tarea generada por script que está habilitada actualmente para algunos conjuntos de configuraciones, primero inhabilítela en esos conjuntos de configuraciones.
Clonar una tarea generada por script
Para clonar una tarea con script, lleve a cabo los siguientes pasos:
-
En la página Tareas generadas por script, busque la tarea. Si es necesario, usa el cuadro de búsqueda o las etiquetas para encontrar rápidamente la tarea.
-
Haga clic en los puntos suspensivos de la tarea y, a continuación, seleccione Clone task
Nota:
Al clonar una tarea, se le pide que cambie el nombre para evitar nombres duplicados.
Opción de configurar los ajustes de la tarea
Para acceder rápidamente a la configuración de la tarea, lleve a cabo los siguientes pasos:
-
En la página Tareas generadas por script, busque la tarea. Si es necesario, usa el cuadro de búsqueda o las etiquetas para encontrar rápidamente la tarea.
-
Haga clic en los puntos suspensivos de la tarea y, a continuación, seleccione Configurar los ajustes de la tarea.
-
Elija un conjunto de configuraciones en el asistente de selección de conjuntos de configuraciones.
-
Haga clic en Ir para acceder a la tarea filtrada en la página Configuración de tareas con scripts, donde solo se filtra la tarea elegida.
Más información
Para ver ejemplos de cómo usar tareas con guiones, consulte: