Introduction

Exécutez un script en ligne dans le cadre d'une automatisation — aucun script sauvegardé n'est nécessaire. Shell est le bon choix pour les commandes ponctuelles ou la logique légère qui n'a pas besoin de figurer dans votre bibliothèque de scripts.

Pour les scripts que vous prévoyez de réutiliser dans plusieurs automatisations, consultez Exécuter un script à la place.

Configuration de l'action Shell

Depuis le pipeline d'automatisation en mode édition, cliquez sur + et sélectionnez Shell dans la catégorie Système.

Le panneau d'action s'ouvre avec les champs de configuration du script.

Langage

Sélectionnez le langage de script 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 sous l'utilisateur actuellement connecté — utile pour les opérations dans le contexte utilisateur, comme l'application des paramètres d'affichage ou la configuration des préférences utilisateur

Éditeur de script

Rédigez votre script dans l'éditeur de code. Cliquez sur (x) dans le coin inférieur droit de l'éditeur pour insérer une variable, une variable système ou une référence à un champ personnalisé à la position du curseur.

La sélection d'un élément l'insère sous la forme {{variable_name}} à la position du curseur. Level résout la valeur au moment de l'exécution, avant l'exécution du script.

💡 CONSEIL : Les variables système telles que le nom d'hôte de l'appareil et le surnom de l'appareil ne nécessitent aucune configuration — elles sont toujours disponibles. Les variables d'automatisation (répertoriées sous Variables) sont limités à l'automatisation en cours et doivent d'abord être créés, soit depuis le menu Variables ou par une action précédente. Les champs personnalisés que vous avez définis dans votre organisation apparaissent également dans le sélecteur et se résolvent à la valeur du champ de cet appareil au moment de l'exécution.

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
`0`	Action marquée comme réussie
Différent de zéro (ex. `1`)	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.

Consultez 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'assignation de variable de sortie, les nouvelles tentatives et le bouton d'activation.

Consultez 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 Shell et Exécuter un script ? Shell écrit le script directement dans le panneau d'action — il n'est pas sauvegardé dans votre bibliothèque de scripts. Exécuter un script lance un script sauvegardé qui peut être réutilisé dans plusieurs automatisations. Utilisez Shell pour les commandes ponctuelles rapides ; utilisez Exécuter un script lorsque la même logique doit être maintenue ou partagée.
Que se passe-t-il si le script expire ? 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.
Un script Shell peut-il définir une variable d'automatisation ? Oui — de deux façons. Utilisez la syntaxe en ligne {{variable_name=value}} n'importe où dans la sortie de votre script pour définir une variable de script ; cette variable de script doit ensuite être mappée à une variable d'automatisation dans le panneau d'action pour être disponible pour les actions suivantes. Ou utilisez Assigner la sortie de l'action à une variable dans les Options supplémentaires pour capturer la sortie stdout complète du script directement dans une variable d'automatisation sans aucun mappage supplémentaire. Consultez Définir des variables directement depuis les scripts pour les détails de la syntaxe en ligne.
Qui peut ajouter ou modifier des actions Shell ? Les techniciens ayant la permission de modifier les automatisations dans le groupe concerné. Consultez Espace de travail → Autorisations pour la configuration du contrôle d'accès.

Action Shell