Introduction
Exécutez un script enregistré sur un appareil dans le cadre d'une automatisation. Prend en charge PowerShell, Bash, Python et d'autres langages. Si votre script a besoin de données provenant de l'extérieur — comme la valeur d'un champ personnalisé ou une variable d'automatisation — vous pouvez les mapper sans modifier la logique du script.
⚙️ Prérequis
Un script enregistré doit exister dans votre bibliothèque de scripts, ou vous pouvez en créer un directement. Voir Scripts pour savoir comment créer et organiser des scripts.
Une automatisation doit exister avant d'ajouter des actions. Voir Premiers pas avec les automatisations si vous n'en avez pas encore configuré un.
Action : Exécuter un script
Si le canevas ne contient aucune action, sélectionnez Ajouter une action. Pour ajouter cette étape à un canevas qui contient déjà des actions, cliquez sur le bouton + à l'endroit souhaité et sélectionnez Ajouter une autre action. Choisissez ensuite Exécuter un script depuis Système.
Le panneau d'action s'ouvre et affiche le champ Script et deux boutons : une icône de lien externe pour parcourir vos scripts enregistrés, et Créer un script pour écrire un nouveau script directement.
Sélectionner un script
Cliquez sur l'icône de lien externe à côté du champ Script pour ouvrir le sélecteur de scripts enregistrés. Les scripts sont organisés en dossiers — développez un dossier pour en parcourir le contenu, ou utilisez le champ de recherche pour trouver un script par son nom.
Créer un script directement
Cliquez sur Créer un script pour écrire un nouveau script sans quitter l'éditeur d'automatisation. L'éditeur de script s'ouvre sous forme de panneau latéral.
Configurez les éléments suivants :
Nom du script Un nom descriptif pour le script. Il sera enregistré dans votre bibliothèque de scripts et disponible pour une utilisation dans d'autres automatisations.
Langage Le langage de script utilisé pour ce script.
Langages pris en charge : Ansible, Bash, Go, osquery, PowerShell, Python, Zsh.
Délai d'expiration (en secondes) Durée pendant laquelle Level attend que le script se termine avant de le marquer comme échoué. La valeur par défaut est 100 secondes.
Exécuter en tant que Le contexte de compte sous lequel le script s'exécute.
Option | Comportement |
Système local | S'exécute sous le compte SYSTEM — élevé, sans contexte utilisateur |
Utilisateur actuel | S'exécute en tant qu'utilisateur actuellement connecté — utile pour les opérations dans le contexte utilisateur, comme appliquer un fond d'écran, configurer les paramètres utilisateur, etc. |
Rédigez votre script dans l'éditeur de code. Cliquez sur {x} pour référencer des variables et des champs personnalisés directement dans le script. Une fois terminé, cliquez sur Créer un script pour l'enregistrer et l'associer à l'action.
Variables de script
Les variables de script sont des valeurs nommées définies dans l'onglet Variables onglet. Dans le Exécuter un script action, mapper une variable de script sur une variable d'automatisation permet au script enregistré de recevoir des entrées et de renvoyer une valeur mise à jour aux étapes d'automatisation ultérieures.
Avant l'exécution, Level substitue la valeur actuelle de la variable d'automatisation dans la variable de script mappée.
Pendant l'exécution, le script peut attribuer une nouvelle valeur à cette variable de script. Level écrit la nouvelle valeur dans la variable d'automatisation mappée.
ℹ️ REMARQUE : Vous pouvez également insérer des variables système de l'appareil ou des champs personnalisés directement via le sélecteur {x} dans l'éditeur de script. Utilisez une variable de script mappée lorsque la valeur provient d'une variable d'automatisation ou lorsque le script enregistré doit utiliser son propre nom de variable réutilisable.
Lorsqu'un script avec des variables définies est sélectionné, une section Variables de script apparaît dans le panneau d'action.
Pour mapper une variable de script sur une variable d'automatisation :
Dans la section Variables de script section, trouvez la variable de script que vous souhaitez mapper.
Ouvrez la liste déroulante Variables d'automatisation sur la même ligne.
Sélectionnez une variable d'automatisation existante, ou cliquez sur Créer une nouvelle variable.
Pour mapper les variables automatiquement : Cliquez sur Correspondance par nom dans la Variables de script dans la section. Level remplit uniquement les mappages vides et laisse les sélections existantes inchangées.
Une correspondance exacte du nom est préférée, y compris la casse.
En l'absence de correspondance exacte, Level utilise une correspondance insensible à la casse uniquement lorsqu'une seule variable d'automatisation correspond.
Si aucune variable ne correspond, ou si plusieurs variables ne correspondent qu'en ignorant la casse, le mappage reste vide. Sélectionnez manuellement une variable d'automatisation pour cette ligne.
Vérifiez les variables d'automatisation sélectionnées et utilisez les listes déroulantes pour remplir les mappages vides restants.
Au démarrage du script, la variable de script mappée reçoit la valeur actuelle de la variable d'automatisation. Référencez-la dans le script enregistré avec {{script_variable_name}}. Pour renvoyer une nouvelle valeur à l'automatisation, attribuez la variable de script avec {{script_variable_name=value_expression}}.
Voir Variables d'automatisation pour la référence complète sur la création et l'utilisation des variables d'automatisation.
ℹ️ REMARQUE : La section Variables de script n'apparaît que lorsque le script sélectionné possède au moins une variable définie dans son onglet Variables. Les scripts sans variables n'affichent pas cette section.
Gérer les variables de script
Les variables de script sont définies dans le script lui-même, et non dans le panneau d'action. Ouvrez l'éditeur de script et accédez à l'onglet Variables pour les ajouter, les modifier ou les supprimer.
Capturer la sortie du script
Il existe deux façons de capturer une valeur depuis un script et de la rendre disponible pour les actions suivantes dans le pipeline.
Attribuer une variable de script mappée
Utilisez {{script_variable_name=value_expression}} dans le script enregistré pour mettre à jour une variable d'automatisation mappée. Par exemple, si une variable de script PowerShell nommée local_ip est mappée sur une variable d'automatisation, utilisez {{local_ip=$ip}} après avoir calculé $ip.
Avant l'exécution, Level remplace l'affectation par la commande de définition de variable appropriée au shell du script. Elle n'est pas extraite de la sortie standard du script. La variable de script doit exister dans l'onglet Variables et être mappée dans l'action Exécuter un script action.
Utilisez cette option lorsque le script produit des journaux ou d'autres sorties et que vous n'avez besoin de transmettre qu'une valeur spécifique.
Attribuer la sortie complète à une variable
Dans Options supplémentaires, utilisez Attribuer la sortie de l'action à une variable pour capturer l'intégralité de la sortie stdout du script dans une variable d'automatisation. Cela fonctionne pour n'importe quel script sans nécessiter de modifications du script lui-même — mais capture tout ce que le script produit, pas seulement la valeur dont vous avez besoin.
💡 CONSEIL : Utilisez l'affectation d'une variable de script mappée lorsque le script produit d'autres sorties que vous ne souhaitez pas inclure dans la variable. Utilisez Attribuer la sortie de l'action à une variable lorsque la seule sortie du script est la valeur que vous souhaitez capturer.
Codes de sortie
Level utilise le code de sortie du script pour déterminer si l'action a réussi ou échoué.
Code de sortie | Résultat |
| Action marquée comme réussie |
Différent de zéro (p. ex. | Action marquée comme échouée |
Votre paramètre En cas d'échec de l'action dans les options supplémentaires contrôle ce qui se passe ensuite — si le pipeline s'arrête ou continue.
Assurez-vous que vos scripts se terminent explicitement avec le code approprié. Si un script se termine avec 0 après avoir rencontré une erreur qu'il n'a pas gérée, Level traitera l'action comme réussie.
Conditions
La section Conditions vous permet de restreindre l'exécution de cette action en fonction des attributs de l'appareil ou du résultat d'une action précédente.
Voir Conditions d'action pour la référence complète sur les types de conditions, les opérateurs et les valeurs.
Options supplémentaires
Développez Options supplémentaires pour le nom de l'action, le comportement en cas d'échec, l'attribution de la variable de sortie, les nouvelles tentatives et le bouton d'activation.
Voir Vue d'ensemble des actions pour la référence complète sur les options supplémentaires disponibles pour chaque action.
FAQ
Quelle est la différence entre Exécuter un script et Shell ? Exécuter un script exécute un script enregistré depuis votre bibliothèque — le script est versionné et réutilisable dans plusieurs automatisations. Shell exécute un script ad hoc écrit directement dans le panneau d'action. Utilisez Exécuter un script lorsque la même logique doit être partagée ou maintenue ; utilisez Shell pour des commandes ponctuelles.
Une variable d'automatisation peut-elle fournir des entrées à un script enregistré ? Oui. Définissez une variable de script dans l'onglet Variables mappez-la sur une variable d'automatisation dans l'action Exécuter un script action, et référencez la variable de script dans le script enregistré. Level substitue la valeur actuelle de la variable d'automatisation avant l'exécution.
Le script peut-il écrire des sorties lisibles par d'autres actions ? Oui. Attribuez une variable de script mappée avec
{{script_variable_name=value_expression}}pour écrire une valeur spécifique dans la variable d'automatisation mappée. Ou utilisez Attribuer la sortie de l'action à une variable dans les options supplémentaires pour capturer l'intégralité de la sortie stdout du script.Que se passe-t-il si le script dépasse le délai d'expiration ? L'action est marquée comme échouée. Le paramètre En cas d'échec de l'action dans les options supplémentaires contrôle si le pipeline s'arrête ou continue.
Qui peut ajouter ou modifier des actions Exécuter un script ? Les techniciens ayant l'autorisation de modifier les automatisations dans le groupe concerné. Voir Espace de travail → Autorisations pour la configuration du contrôle d'accès.






