Documentación de productos
Workspace Environment Management
Service Current Release 2402 2311 2308 2305 2303 2212 2209 2206 2203
Ver PDF

Tareas generadas por script

December 11, 2024
Contribución de: 
C

Introducción

Consejo:

Las tareas programadas funcionan a nivel de máquina. Para ejecutar tareas a nivel de sesión de usuario, utilice Tareas externas en su lugar.

Esta página le permite agregar tareas programadas que pueda personalizar para adaptarlas a sus necesidades específicas de gestión del entorno. Luego, puede automatizar esas tareas con Workspace Environment Management (WEM) configurándolas en el conjunto de configuración correspondiente.

Actualmente, ofrecemos la siguiente tarea con script incorporado para que la utilice:

Comprobación del estado de la nube

Le permite ejecutar comprobaciones que miden el estado de los agentes de entrega virtuales (VDA). Los controles de estado de VDA identifican posibles causas de problemas comunes de registro de VDA y de inicio de sesión. 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 utilizadas frecuentemente con respecto al 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 forzado, se reinicia para garantizar que esté funcionando con la última configuración o para recuperarse de un estado estancado.

Parámetros

nombre tipo por defecto obligatorio Nota:
ServiceNames cadena Agente de corretaje FALSO Especifica el nombre de los servicios que se van a administrar. Si no se proporciona, el valor predeterminado es BrokerAgent. Si necesita ingresar más de un servicio, separe los nombres de los servicios con una coma. Se recortarían todos los espacios. Por ejemplo, ServicioA, ServicioB.
ForceStart booleano verdadero FALSO Indica si se debe iniciar el servicio si se detecta que no está en ejecución. No afecta a los servicios en ejecución; los servicios en ejecución siempre se reinician para fines de mantenimiento o recuperación.

Detener el servicio de Windows

Este script detiene una lista de servicios de Windows especificados. El script verifica si cada servicio está instalado e intenta detenerlo a la fuerza. Luego, el script verifica si el servicio se ha detenido correctamente e informa el estado.

Parámetros

nombre tipo por defecto obligatorio Nota:
ServiceNames cadena Agente de corretaje FALSO Especifica el nombre de los servicios que se van a administrar. Si no se proporciona, el valor predeterminado es BrokerAgent. Si necesita ingresar más de un servicio, separe los nombres de los servicios con una coma. Se recortarían todos los espacios. Por ejemplo, ServicioA, ServicioB.

Configurar el servicio de Windows

Este script ajusta las configuraciones del servicio de Windows, incluido el tipo de inicio y las acciones de recuperación.

Parámetros

nombre tipo por defecto obligatorio Nota:
ServiceNames cadena nulo verdadero Especifica el nombre de los servicios que se van a administrar. Si no se proporciona, el valor predeterminado es BrokerAgent. Si necesita ingresar más de un servicio, separe los nombres de los servicios con una coma. Se recortarían todos los espacios. Por ejemplo, ServicioA, ServicioB.
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 subsiguientes al segundo.

Reinicio del servidor

Reiniciar la máquina

Este script reinicia la máquina local con una opción de retraso y forzamiento.

Parámetros

nombre tipo por defecto obligatorio Nota:
Force booleano verdadero FALSO Si se especifica, fuerza un reinicio inmediato, ignorando cualquier dato no guardado o sesiones de usuario activas.
Delay int 10 FALSO Especifica el retraso en segundos antes de que se reinicie la computadora. 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 archivos CTL.

Parámetros

nombre tipo por defecto obligatorio Nota:
traceOutputPath cadena C:\ProgramData\Citrix\WEM\CDFLogs FALSO Especifica la ruta de salida de los informes CDF.
category











cadena











10











FALSO











Especifica las categorías predefinidas para iniciar el seguimiento. Los valores admitidos son
  • todos
  • siempre en seguimiento
  • sistema operativo del servidor de escritorio vda
  • controlador de entrega
  • servicio de autenticación federada
  • servicio de aprovisionamiento
  • servidor de impresión universal
  • director de citrix
  • estudio citrix
  • administración de grabación de sesión
  • reproductor de grabación de sesión
  • aplicación citrix workspace para windows
    		•
    ctlFilePath cadena nulo FALSO Especifica el archivo ctl con el que iniciar el seguimiento.

    Detener el rastreo de CDF

    Este script detiene el seguimiento de la herramienta CDF.

    Limpieza de registros de CDF

    Es útil limpiar los registros de seguimiento de CDF para ahorrar consumo de almacenamiento. Debería proporcionar una función para eliminar archivos CDF en el directorio indicado.

    nombre tipo por defecto obligatorio Nota:
    FileAgeDays int 3 FALSO Especifica el umbral de edad en días. Se eliminan los archivos y carpetas más antiguos que este valor. El valor predeterminado es 3 días y este parámetro es opcional. Todos los archivos o directores se eliminan si FileAgeDays es menor a 1 día.

    Consejo:

    • Puede diferenciar entre tareas programadas personalizadas e integradas: las tareas personalizadas están marcadas con la etiqueta “PERSONALIZADA” y las integradas con la etiqueta “CITRIX”.
    • Las tareas programadas integradas siempre aparecen encima de las personalizadas. Las tareas con scripts personalizados se ordenan en orden descendente según la hora de la última modificación.

    Con esta función, puede ampliar las capacidades de WEM para sus necesidades de gestión únicas. Por ejemplo, la tarea con script incorporado Cloud Health Check le permite evaluar el estado de los VDA. La tarea se basa en un script. Puedes escribir tu propio archivo de script. Luego, agrega el archivo de script a WEM como una tarea con script para poder automatizar la tarea usando WEM.

    Cada vez que se ejecuta una tarea programada, 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 brinda la posibilidad de auditar las actividades relacionadas con la tarea.

    Las tareas programadas funcionan a nivel de conjunto de configuración. Un flujo de trabajo general para utilizar tareas con script es el siguiente:

    1. En la página Tareas con script , agregue una tarea con script.

    2. Navegue hasta el conjunto de configuración para el cual desea habilitar la tarea con script.

    3. En la página Configuración de tarea con script de ese conjunto de configuración, habilite la tarea con script. Consulte Configuración de tareas con script.

    4. Opcionalmente, vea los informes relacionados con la tarea programada. Hay dos maneras de hacerlo:

      • Vaya a Monitoreo > Informes y vea los informes allí.
      • Vaya a la página Tareas con script o a la página Configuración de tareas con script de un conjunto de configuración. Localice la tarea programada, seleccione los puntos suspensivos y luego seleccione Ver informes. Luego serás llevado a la página Monitoreo > Informes , con los filtros relevantes aplicados automáticamente. Luego podrás ver los informes relacionados.

    Para obtener información sobre los informes de tareas con script, consulte Informes.

    Agregar una tarea generada por script

    Para agregar una tarea programada, realice los siguientes pasos:

    1. En la página Tarea con script , haga clic en Agregar tarea con script.

    2. En el asistente Agregar tarea con script , configure los siguientes ajustes y luego haga clic en Guardar.

      • Nombre de la tarea. Especifique un nombre para la tarea.

      • Etiquetas. Seleccione una de las etiquetas existentes o ingrese 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, permitiéndole reorganizar su vista de tareas en Tareas con script dependiendo de criterios que sean importantes para usted. Puedes utilizar tantas etiquetas como quieras.

      • Descripción. Opcionalmente, especifique información adicional para ayudarle a identificar la tarea.

      • Tipo de archivo. Seleccione un tipo de archivo para la tarea. Se admiten dos tipos de archivos:

        • Potencia Shell. Archivos de script de PowerShell individuales.
        • CÓDIGO POSTAL. 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, indicando qué archivo ejecutar al comienzo de la tarea programada. Tenga en cuenta que el archivo de punto de entrada no debe tener más de tres niveles de profundidad en la estructura de la carpeta.

      • Subir archivo. Haga clic en Explorar, navegue hasta el archivo, selecciónelo y luego haga clic en Abrir. Regresará al asistente para agregar tarea con script ** .

      • Otorgar permisos. Especifique el nivel de acceso que desea otorgar a la tarea programada. Asegúrese de comprender los permisos asociados con cada opción.

        • Acceso completo. Una tarea programada a la que se le asigna acceso completo tiene acceso local extenso. Si se selecciona, se otorgan permisos a la tarea programada como si se ejecutara bajo la cuenta del sistema local.
        • Acceso limitado (con acceso a la red). Una tarea con script asignado acceso limitado (con acceso a la red) no tiene acceso local extenso, pero puede acceder a recursos de la red. Si se selecciona, se otorgan permisos a la tarea programada como si se ejecutara bajo la cuenta de servicio de red.
        • Acceso limitado (sin acceso a la red). Una tarea con script a la que se le 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, se otorgan permisos a la tarea programada como si se ejecutara bajo la cuenta de servicio local.

        Para obtener más información, consulte la documentación de Microsoft https://docs.microsoft.com/en-us/windows/security/identity-protection/access-control/security-identifiers#well-known-sids.

    • Carpeta de trabajo. Opcionalmente, 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 construir la ruta con variables de entorno (por ejemplo, %ProgramFiles%). Si no se especifica, se utiliza PSScriptRoot como carpeta de trabajo predeterminada. Para obtener más información sobre PSScriptRoot, 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 donde reside el archivo. La ruta debe contener el nombre del archivo y la extensión del nombre del archivo. Ejemplo: salida\report.txt.

    Editar una tarea programada

    Para editar una tarea programada, realice los siguientes pasos:

    1. En la página Tareas con script , busque la tarea. Si es necesario, utilice el cuadro de búsqueda para buscar rápidamente la tarea.

    2. Haga clic en los puntos suspensivos de la tarea y luego seleccione Editar tarea. Aparece el asistente para editar tarea con script ** .

    3. En la pestaña Información de la tarea ** , configure los ajustes según sea necesario.

    4. En la pestaña Contenido del script ** , vea el contenido del script.

    5. Haga clic en Guardar.

    Nota:

    No es posible editar tareas con scripts integrados.

    Eliminar una tarea programada

    Para eliminar una tarea programada, realice los siguientes pasos:

    1. En la página Tareas con script , busque la tarea. Si es necesario, utilice el cuadro de búsqueda para buscar rápidamente la tarea.

    2. Haga clic en los puntos suspensivos de la tarea y luego seleccione Eliminar tarea.

    Importante:

    • No es posible eliminar tareas con scripts integrados.
    • Para eliminar una tarea programada que actualmente está habilitada para algunos conjuntos de configuración, primero deshabilítela en esos conjuntos de configuración.

    Clonar una tarea programada

    Para clonar una tarea con script, realice los siguientes pasos:

    1. En la página Tareas con script , busque la tarea. Si es necesario, utilice el cuadro de búsqueda o las etiquetas para encontrar rápidamente la tarea.

    2. Haga clic en los puntos suspensivos de la tarea y luego seleccione Clonar tarea.

    Nota:

    Al clonar una tarea, se le solicitará que cambie el nombre para evitar nombres duplicados.

    Opción de configuración de tareas

    Para llegar rápidamente a la configuración de la tarea, realice los siguientes pasos:

    1. En la página Tareas con script , busque la tarea. Si es necesario, utilice el cuadro de búsqueda o las etiquetas para encontrar rápidamente la tarea.

    2. Haga clic en los puntos suspensivos de la tarea y luego seleccione Configurar ajustes de la tarea.

    3. Seleccione un conjunto de configuración en el asistente Seleccionar conjunto de configuración ** .

    4. Haga clic en Ir para llegar a la tarea filtrada en la página Configuración de tareas programadas , donde solo se filtra la tarea elegida.

    Más información

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

    Tareas generadas por script
    December 11, 2024
    Contribución de: 
    C
    December 11, 2024
    Contribución de: 
    C

    En este artículo

    Comentarios sobre el sitio | Your privacy choices footer linkSus opciones de privacidad | Condiciones legales y de privacidad | Preferencias de cookies | Parámetros de consentimiento | docs.cloud.com
    © 1999- Cloud Software Group, Inc. All rights reserved.