Workspace Environment Management

Paramètres des tâches scriptées

Répertorie toutes les tâches scriptées disponibles sur la page Tâches par script . Les tâches scriptées s’exécutent au niveau du jeu de configuration. Vous pouvez configurer ici les tâches de script à activer pour le jeu de configuration actuel. Pour modifier vos tâches scriptées, accédez à Tâches scriptées.

Configurer une tâche basée sur un script

  1. Sur la page Paramètres de la tâche scriptée, recherchez la tâche de script, sélectionnez les points de suspension, puis Configurer.

  2. Dans l’Assistant Configurer la tâche de script, configurez les paramètres suivants, puis cliquez sur Enregistrer.

En général :

  • Activez cette tâche. Choisissez d’activer (Oui) ou de désactiver (Non) la tâche pour le jeu de configuration actuel. Si cette option est désactivée, l’agent ne traite pas la tâche.
  • Vérifiez la signature. Choisissez s’il faut vérifier la signature avant d’exécuter la tâche. La vérification de la signature est obligatoire lorsque la tâche scriptée bénéficie d’un accès complet.
  • Délai d’expiration de la tâche. Choisissez si vous souhaitez définir un délai d’expiration (en minutes) pour la tâche. Lorsque le délai d’expiration se produit, la tâche est forcée de se terminer. Valeurs prises en charge : 1 à 60. Nous recommandons de définir un délai d’expiration pour la tâche. Sinon, la tâche risque de rester en cours d’exécution, ce qui empêchera l’exécution d’autres tâches.

  • Filter. Choisissez si vous souhaitez contextualiser la tâche en sélectionnant un filtre. Lorsqu’un filtre est sélectionné, cette tâche ne s’exécute que lorsque toutes les conditions du filtre sont remplies. Lorsque vous sélectionnez un filtre, tenez compte des points suivants :

    • Si le filtre contient des conditions qui ne s’appliquent pas aux tâches scriptées, l’agent ignore ces conditions lors de l’évaluation du filtre avant d’exécuter la tâche. Pour obtenir la liste complète des conditions qui ne s’appliquent pas aux tâches scriptées, consultez la section Conditions non applicables aux paramètres de la machine.

Dans Triggers :

  • Configurez les déclencheurs pour la tâche. Vous pouvez effectuer les opérations suivantes :

    • Sélectionnez les déclencheurs que vous souhaitez associer à la tâche. Lorsqu’ils sont activés, ces déclencheurs démarrent la tâche dans l’environnement utilisateur.

    • Choisissez si vous souhaitez afficher uniquement les déclencheurs qui s’appliquent à cette tâche.

    • Créez un nouveau déclencheur. Consultez la section Créer un déclencheur.

    Remarque :

    Pour modifier les déclencheurs existants, accédez à Déclencheurs.

Dans Paramètres :

  • Transmettez les paramètres à la tâche scriptée. Indiquez si vous souhaitez transmettre des paramètres à la tâche scriptée. Lorsque cette option est activée, vous permet de fournir des entrées en tant que variables de paramètres dans la tâche scriptée lors de l’exécution. L’avantage est que vous pouvez contrôler le comportement de la tâche scriptée sans modifier le code sous-jacent. Les types de paramètres suivants sont disponibles :

    • Nombre entier. Exemple : 123.
    • Chaîne. Exemple : hello world.
    • Booléen. Vrai ou Faux.
    • Caractère. Exemple : c.
    • Switch(Switch) Vrai ou Faux.
    • Double. Exemple : 1.023.
    • Date et heure. Exemple : YYYY-MM-DD HH:mm:ss.
    • Chemin du fichier. Saisissez le chemin que vous souhaitez transmettre à la classe System.IO.FileInfo. Les variables d’environnement sont prises en charge Le chemin d’accès ne doit pas inclure les caractères suivants : * ? < >.

    Remarque :

    • Vous pouvez configurer jusqu’à 20 paramètres.
    • Le champ de nom est facultatif sauf pour les paramètres de type « commutateur ».
    • PowerShell prend en charge les noms de paramètres partiels Lorsque vous utilisez un nom de paramètre partiel, assurez-vous que le nom est unique et éliminez-le des noms de paramètres existants. Exemple : Les noms de paramètres suivants sont identiques pour PowerShell : -t, -ti, et -title. Dans ce cas, indiquez suffisamment de lettres pour le nom du paramètre pour le distinguer des autres paramètres.

En sortie :

  • Fichiers de sortie. Choisissez si vous souhaitez collecter les fichiers que la tâche génère. Si cette option est sélectionnée, inclut le contenu du fichier de sortie dans les rapports générés pour la tâche. Vous pouvez ensuite afficher le contenu du fichier de sortie dans les rapports sans avoir besoin d’accéder aux fichiers de sortie dans l’environnement utilisateur.

  • Points forts de sortie. Choisissez si vous souhaitez mettre en surbrillance certains contenus dans le contenu du fichier de sortie et dans la sortie de la console.

    • Mettez en évidence les mots-clés. Spécifiez les mots-clés que vous souhaitez mettre en surbrillance dans le rapport. Vous pouvez saisir plusieurs mots-clés, séparés par des virgules. Après avoir saisi un mot-clé, appuyez sur Entrée pour continuer. Si cela est spécifié, le contenu du rapport correspondant à vos mots-clés sera mis en surbrillance dans les sections Contenu du fichier de sortie et Sortie de la console des rapports générés.

    • Mettez en surbrillance les correspondancesd’ Entrez une expression régulière qui décrit le contenu que vous souhaitez mettre en surbrillance. L’expression régulière doit être conforme à la syntaxe de la bibliothèque d’expressions régulières .NET, qui est compatible PCRE. Pour de plus amples informations, consultez la documentation de Microsoft : https://docs.microsoft.com/en-us/dotnet/standard/base-types/regular-expression-language-quick-reference.

      • Expression régulière. Entrez une expression régulière qui décrit le contenu que vous souhaitez mettre en surbrillance.
      • Ignorerla casse Choisissez si le contenu doit correspondre exactement au cas.
      • Utilisez la correspondance multiligne. Choisissez d’utiliser la correspondance multiligne, où ^ et $ correspondent au début et à la fin de chaque ligne, au lieu du début et de la fin de l’ensemble du contenu de sortie.
      • Capturez uniquement les groupes nommés. Choisissez si vous souhaitez capturer uniquement les groupes nommés. Les groupes capturés sont définis à l’aide de parenthèses dans le modèle d’expression régulière. Les groupes nommés se voient attribuer explicitement un nom ou un numéro par la (?<name> subexpression) syntaxe.
      • Nombre de lignes à inclure en tant qu’indices contextuels. Spécifiez le nombre de lignes avant et après la correspondance que vous souhaitez inclure dans le surlignage en tant qu’indices contextuels. Valeurs prises en charge : 1 à 10.
      • Inclure uniquement les correspondances d’expressions régulières dans les rapports. Détermine s’il faut inclure l’intégralité du contenu de sortie dans les rapports ou uniquement le contenu qui correspond à l’expression régulière. L’activation de cette option réduit la quantité de données transmises à Citrix Cloud. Lorsque l’option est activée, la fonctionnalité Mettre en surbrillance les mots clés n’a aucun contenu à afficher, quels que soient les mots clés spécifiés.
  • Options avancées.

    • Collectez la sortie même si des erreurs d’exécution se produisent. Contrôle s’il faut collecter le contenu du fichier de sortie et la sortie de la console même en cas d’erreur lors de l’exécution de la tâche

Afficher les rapports d’une tâche basée sur un script

Sur la page Paramètres de la tâche scriptée, recherchez la tâche de script, sélectionnez les points de suspension, puis Afficher les rapports. Par conséquent, vous êtes redirigé vers la page Surveillance > Rapports, où vous pouvez voir les rapports (le cas échéant) liés à la tâche. Cliquez sur les points de suspension pour afficher des informations plus détaillées. Pour plus de détails, consultez la section Rapports.

Paramètres des tâches scriptées