Einführung

Exécutez un script en ligne dans une automation — aucun script enregistré requis. Shell est le bon choix pour les commandes ponctuelles ou la logique légère qui n'a pas besoin de vivre dans votre bibliothèque de scripts.

Pour les scripts que vous envisagez de réutiliser dans plusieurs automations, voir l'action Exécuter un script à la place.

Configuration de l'action Shell

À partir du pipeline d'automation 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.

Langue

Sélectionnez le langage de script pour ce script.

Langues supportées : Ansible, Bash, Go, osquery, PowerShell, Python, Zsh.

Délai d'expiration (en secondes)

Combien de temps Level attend que le script se termine avant de le marquer comme échoué. La valeur par défaut est de 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 en tant que 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 de l'utilisateur, comme l'application des paramètres d'affichage ou la configuration des préférences de l'utilisateur

Éditeur de script

Écrivez 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 de champ personnalisé à la position du curseur.

La sélection d'un élément l'insère comme ##{{variable_name}} au curseur. Level résout la valeur au moment de l'exécution avant que le script ne s'exécute.

💡 TIPP: Les variables système comme Nom d'hôte de l'appareil et Surnom de l'appareil ne nécessitent aucune configuration — elles sont toujours disponibles. Les variables d'automation (répertoriées sous Variables) sont limitées à l'automation actuelle et doivent être créées en premier, soit à partir du menu Variables de l'automation, soit par une action antérieure. 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
Non-zéro (par exemple `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 0 après avoir rencontré une erreur qu'il n'a pas gérée, Level traitera l'action comme réussie.

Bedingungen

La section Bedingungen vous permet de restreindre le moment où cette action s'exécute en fonction des attributs de l'appareil ou du résultat d'une action antérieure.

Voir Aktionsbedingungen pour la référence complète sur les types de conditions, les opérateurs et les valeurs.

Zusätzliche Optionen

Développez Zusätzliche Optionen pour le nom de l'action, le comportement en cas d'échec, l'attribution de la variable de sortie, les tentatives et le basculement activé.

Voir Aktionen-Übersicht pour la référence complète sur les options supplémentaires disponibles sur chaque action.

Häufig gestellte Fragen

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 enregistré dans votre bibliothèque de scripts. Exécuter un script exécute un script enregistré qui peut être réutilisé dans plusieurs automations. Utilisez Shell pour les commandes ponctuelles rapides ; utilisez Exécuter un script quand 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'automation ? Oui — deux façons. Utilisez la syntaxe en ligne ##{{variable_name=value}} n'importe où dans votre sortie de script pour définir une variable de script ; cette variable de script doit ensuite être mappée à une variable d'automation dans le panneau d'action pour être disponible pour les actions subséquentes. Ou utilisez Assigner la sortie de l'action à une variable dans les Options supplémentaires pour capturer la stdout complète du script directement dans une variable d'automation sans aucun mappage supplémentaire. Voir Définir les variables directement à partir des scripts pour les détails de la syntaxe en ligne.
Qui peut ajouter ou modifier les actions Shell ? Les techniciens autorisés à éditer les automations dans le groupe pertinent. Voir Arbeitsbereich → Berechtigungen pour la configuration du contrôle d'accès.