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 associer sans modifier la logique du script.

Dans le pipeline d'automatisation en mode édition, cliquez sur + et sélectionnez Exécuter un script de la catégorie 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 en écrire un directement.

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 n'importe quel dossier pour parcourir son contenu, ou utilisez le champ de recherche pour trouver un script par son nom.

Cliquez sur Créer un script pour écrire un nouveau script sans quitter l'éditeur d'automatisation. L'éditeur de script s'ouvre en tant que 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.

Écrivez 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.

Les variables de script sont des valeurs nommées définies dans l'onglet Variables onglet. Dans la Exécuter un script action, associer une variable de script à une variable d'automatisation permet au script enregistré de recevoir des entrées et de renvoyer une valeur mise à jour aux étapes ultérieures de l'automatisation.

Lorsqu'un script avec des variables définies est sélectionné, une section Variables de script apparaît dans le panneau d'action.

Pour associer une variable de script à une variable d'automatisation :

Lorsque le script démarre, la variable de script associé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}}.

Consultez Variables d'automatisation pour la référence complète sur la création et l'utilisation des variables d'automatisation.

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.

Il existe deux façons de capturer une valeur à partir d'un script et de la rendre disponible pour les actions suivantes dans le pipeline.

Utilisez {{script_variable_name=value_expression}} dans le script enregistré pour mettre à jour une variable d'automatisation associée. Par exemple, si une variable de script PowerShell nommée local_ip est associé à une variable d'automatisation, utilisez {{local_ip=$ip}} après avoir calculé $ip.

Avant l'exécution, Level remplace l'attribution par la commande de définition de variable appropriée pour le shell du script. Elle n'est pas analysée depuis la sortie standard du script. La variable de script doit exister dans l'onglet Variables et être associé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 seule valeur spécifique.

Dans Options supplémentaires, utilisez Attribuer la sortie de l'action à une variable pour capturer l'intégralité de la sortie standard du script dans une variable d'automatisation. Cela fonctionne pour n'importe quel script sans nécessiter de modifications — mais capture tout ce que le script produit en sortie, et pas seulement la valeur dont vous avez besoin.

Level utilise le code de sortie du script pour déterminer si l'action a réussi ou échoué.

Votre paramètre En cas d'échec de l'action dans les options supplémentaires détermine 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.

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.

Consultez Conditions d'action pour la référence complète sur les types de conditions, les opérateurs et les valeurs.

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.

Consultez Présentation des actions pour la référence complète sur les options supplémentaires disponibles pour chaque action.