Paramètres des tâches scriptées

Configurer une tâche scriptée

1. Sur la page Paramètres des tâches scriptées, recherchez la tâche scriptée, sélectionnez les points de suspension, puis sélectionnez Configurer.
2. Dans l'assistant Configurer la tâche scriptée, configurez les paramètres suivants, puis cliquez sur Enregistrer.

• Activer cette tâche. Choisissez d'activer (Oui) ou de désactiver (Non) la tâche pour l'ensemble de configurations actuel. Si elle est désactivée, l'agent ne traite pas la tâche.
• Vérifier la signature. Choisissez de 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 de définir un délai d'expiration (en minutes) pour la tâche. Lorsque le délai d'expiration est atteint, la tâche est forcée de se terminer. Valeurs prises en charge : 1 à 60. Nous vous recommandons de définir un délai d'expiration pour la tâche. Dans le cas contraire, la tâche pourrait rester en cours d'exécution, empêchant d'autres tâches de s'exécuter.
• Filtre. Choisissez de 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. Lors de la sélection d'un filtre, tenez compte des éléments 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 une liste complète des conditions qui ne s'appliquent pas aux tâches scriptées, consultez Conditions non applicables aux paramètres de la machine.

• 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 d'afficher uniquement les déclencheurs qui s'appliquent à cette tâche.
  • Créez un nouveau déclencheur. Voir Créer un déclencheur.
  Remarque :
  Pour modifier les déclencheurs existants, accédez à Déclencheurs.

• Transmettre des paramètres à la tâche scriptée. Choisissez si vous souhaitez transmettre des paramètres à la tâche scriptée. Lorsqu'elle est activée, cette option vous permet de fournir des entrées sous forme de variables de paramètre dans la tâche scriptée au moment 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 :
  • Entier. Exemple : 123.
  • Chaîne de caractères. Exemple : hello world.
  • Booléen. Vrai ou Faux.
  • Caractère. Exemple : c.
  • Commutateur. Vrai ou Faux.
  • Double. Exemple : 1.023.
  • Date et heure. Exemple : YYYY-MM-DD HH:mm:ss.
  • Chemin de fichier. Entrez un chemin que vous souhaitez transmettre à la classe System.IO.FileInfo. Les variables d'environnement sont prises en charge. Le chemin ne doit pas inclure les caractères suivants : * ? < >.
  Remarque :
  • Vous pouvez configurer jusqu'à 20 paramètres.
  • Le champ nom est facultatif, sauf pour les paramètres de type « switch ».
  • 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 — distinguez-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, fournissez suffisamment de lettres du nom du paramètre pour le distinguer des autres paramètres.

• Fichiers de sortie. Choisissez si vous souhaitez collecter les fichiers générés par la tâche. Si cette option est sélectionnée, le contenu des fichiers de sortie est inclus dans les rapports générés pour la tâche. Vous pouvez ensuite afficher le contenu des fichiers de sortie dans les rapports sans avoir à accéder aux fichiers de sortie dans l'environnement utilisateur.
• Mises en évidence de la sortie. Choisissez si vous souhaitez mettre en évidence certains contenus dans le contenu du fichier de sortie et la sortie de la console.
  • Mots-clés à mettre en évidence. Spécifiez les mots-clés que vous souhaitez que le rapport mette en évidence. Vous pouvez taper plusieurs mots-clés, séparés par des virgules. Après avoir tapé un mot-clé, appuyez sur Entrée pour continuer. Si spécifié, le contenu du rapport qui correspond à vos mots-clés sera mis en évidence dans les sections Contenu du fichier de sortie et Sortie de la console des rapports générés.
  • Mettre en évidence les correspondances d'expressions régulières. Saisissez une expression régulière qui décrit le contenu que vous souhaitez mettre en évidence. 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 plus d'informations, consultez la documentation Microsoft : <https://docs.microsoft.com/fr-fr/dotnet/standard/base-types/regular-expression-language-quick-reference>.
    • Expression régulière. Saisissez une expression régulière qui décrit le contenu que vous souhaitez mettre en évidence.
    • Ignorer la casse. Choisissez si le contenu doit correspondre exactement à la casse.
    • Utiliser 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.
    • Capturer uniquement les groupes nommés. Choisissez de capturer uniquement les groupes nommés. Les groupes capturés sont définis en utilisant des 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 syntaxe (?<name> subexpression).
    • Nombre de lignes à inclure comme indices contextuels. Spécifiez le nombre de lignes avant et après la correspondance que vous souhaitez inclure dans la mise en évidence comme indices contextuels. Valeurs prises en charge : 1 à 10.
    • Inclure uniquement les correspondances d'expressions régulières dans les rapports. Contrôle 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 cette option est activée, la fonction Mots-clés à mettre en évidence n'affiche aucun contenu, quels que soient les mots-clés spécifiés.
• Options avancées.
  • Collecter la sortie même en cas d'erreurs d'exécution. Contrôle s'il faut collecter le contenu du fichier de sortie et la sortie de la console même si des erreurs se produisent lors de l'exécution de la tâche.

Afficher les rapports pour une tâche scriptée