Introduction
La bibliothèque de scripts est l'endroit où vous créez, organisez et gérez les scripts pouvant être utilisés dans les automatisations, les moniteurs de scripts et les exécutions ad hoc depuis la liste des appareils ou les détails d'un appareil. Les scripts sont enregistrés une seule fois et réutilisables dans tout votre environnement — modifiez un script dans la bibliothèque et la mise à jour est répercutée partout où il est référencé.
Scripts
Accédez à Scripts dans la barre latérale.
La barre latérale gauche comporte trois éléments fixes en haut :
Tous les scripts — affiche tous les scripts de votre bibliothèque, dans tous les groupes
Nouveau script — ouvre la boîte de dialogue Créer un script
Scripts non groupés — scripts non encore assignés à un groupe
En dessous, la section Groupes de scripts répertorie les groupes personnalisés que vous avez créés. Sélectionnez un groupe pour filtrer le tableau afin de n'afficher que les scripts de ce groupe.
Le tableau principal affiche tous les scripts correspondant à la sélection actuelle. Les colonnes comprennent Nom, Groupe, Description, Type (langage), et Créé. Cliquez sur le nom d'un script pour l'ouvrir dans l'éditeur.
Créer un script
Cliquez sur + Créer un script en haut à droite, ou Nouveau script dans la barre latérale. Une boîte de dialogue apparaît demandant un nom.
Saisissez un nom et cliquez sur Créer. L'éditeur de script s'ouvre immédiatement.
💡 CONSEIL : Nommez les scripts de façon précise — «Désactiver le compte invité - Windows» est plus facile à trouver et à réutiliser que «Script compte invité». Vous pouvez toujours le renommer ultérieurement.
Éditeur de script
Chaque script comporte quatre onglets dans le panneau gauche : Script, Variables, Automatisations liées, et Moniteurs liés.
Les champs configurables :
Nom du script — le nom affiché dans la bibliothèque et dans le sélecteur d'action Exécuter le script.
Description — facultatif. Affiché dans la liste des scripts. Utile à remplir pour les bibliothèques partagées.
Langage — le langage de script. Options prises 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 marquer l'exécution comme échouée. 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 en tant que compte SYSTEM — élevé, sans contexte utilisateur |
Utilisateur actuel | S'exécute en tant qu'utilisateur connecté — à utiliser pour les opérations dans le contexte utilisateur comme appliquer un fond d'écran ou configurer des paramètres par utilisateur |
L'éditeur de code occupe le côté droit de l'écran. Écrivez ou collez votre script directement. 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é en ligne.
Cliquez sur Enregistrer le script pour enregistrer. Les modifications ne prennent pas effet avant d'être enregistrées.
⚠️ AVERTISSEMENT : Les modifications non enregistrées sont perdues si vous quittez la page. Enregistrez avant de quitter l'éditeur.
Variables
L'onglet Variables affiche toutes les variables de script déclarées pour ce script. Les variables de script sont des emplacements de sortie nommés — le script y écrit une valeur lors de l'exécution, et vous pouvez mapper cette valeur à une variable d'automatisation dans la section Exécuter le script du panneau d'action pour le transmettre dans le pipeline.
Cliquez sur + Ajouter une nouvelle variable pour définir une nouvelle variable. Une fois définies, les variables apparaissent dans le sélecteur Variables de script de toute action Exécuter le script qui référence ce script.
ℹ️ REMARQUE : Les variables de script capturent la sortie d'un script. Pour transmettre des données dans un script — contexte de l'appareil, valeurs des champs personnalisés, informations système — utilisez le sélecteur {x} dans l'éditeur de code pour référencer des variables ou des champs personnalisés en ligne.
Pour la référence complète sur le mappage des variables de script aux variables d'automatisation et leur utilisation dans les actions suivantes, consultez Action Exécuter le script, Variables d'automatisation, et Variables système.
Automatisations liées
L'onglet Automatisations liées répertorie toutes les automatisations qui référencent ce script via une Exécuter le script action. Cliquez sur le nom d'une automatisation pour l'ouvrir.
ℹ️ REMARQUE : Un script ne peut pas être supprimé s'il est lié à des automatisations. Vous devez d'abord supprimer le script de chaque automatisation qui le référence, ou supprimer ces automatisations. L'onglet permet de voir clairement ce qui serait affecté.
Moniteurs liés
L'onglet Moniteurs liés répertorie tous les moniteurs de scripts utilisant ce script. La même règle de suppression s'applique : dissociez-le de tous les moniteurs avant de pouvoir supprimer un script.
Activité du script
L'onglet Activité enregistre chaque modification enregistrée du script, y compris le code. Accédez à Scripts → [script] → Activité.
Une entrée de modification résume ce qui a été enregistré, par exemple «2 modifications enregistrées dans Osquery Monitor - Uptime.» Développez-la pour voir chaque modification individuelle.
Pour une modification de code, la modification affiche le delta du nombre de lignes (par exemple «+3 −1») et un lien Voir les modifications lien.
Cliquez sur Voir les modifications pour ouvrir le panneau de diff : lignes supprimées en rouge, lignes ajoutées en vert, numéros de ligne, et un bouton Unifié / Fractionné bascule. L'en-tête indique le nom du script, le technicien et l'horodatage.
Pour la fonctionnalité complète et la page d'activité globale, consultez Activité.
💡 CONSEIL : Le panneau de diff constitue le journal d'audit des modifications de script. Utilisez-le pour confirmer exactement ce qui a changé avant qu'un moniteur ou une automatisation commence à se comporter différemment, sans avoir besoin de restaurer une ancienne version pour comparer visuellement.
Organisation avec les groupes de scripts
Les groupes de scripts vous permettent de catégoriser les scripts par plateforme, fonction, équipe ou selon ce qui convient à votre environnement. Les groupes apparaissent dans la barre latérale sous Groupes de scripts et en tant que colonne dans la liste des scripts.
Pour créer un groupe, cliquez sur l'icône + à côté de Groupes de scripts dans la barre latérale. Une boîte de dialogue apparaît demandant un nom de groupe.
Pour assigner un script à un groupe, ouvrez le menu Actions (en haut à droite) et sélectionnez Assigner au groupe.
💡 CONSEIL : Les groupes de scripts reflètent généralement la finalité ou le rôle — Sécurité, Logiciels, Moniteurs, Utilitaires — et non la structure de vos groupes d'appareils. Organiser par fonction permet à toute l'équipe de trouver plus facilement le bon script, quel que soit l'appareil sur lequel il s'exécute.
Supprimer un script
Ouvrez le menu Actions et sélectionnez Supprimer. Une boîte de dialogue de confirmation apparaît.
⚠️ AVERTISSEMENT : La suppression d'un script est irréversible. Si le script est lié à des automatisations ou des moniteurs, Level bloque la suppression — supprimez d'abord tous les liens à l'aide des onglets Automatisations liées et Moniteurs liés onglets.
Exécution des scripts
Les scripts peuvent être exécutés de plusieurs façons :
Dans une automatisation — via l'action Exécuter le script action. Le script s'exécute sur chaque appareil cible dans le cadre du pipeline d'automatisation. C'est la principale façon d'exécuter des scripts à grande échelle ou selon un calendrier. Consultez Action Exécuter le script pour la référence complète.
Ad hoc depuis la liste des appareils ou les détails d'un appareil — sélectionnez des appareils et ouvrez le menu Actions trois options liées aux scripts apparaissent :
Exécuter le script enregistré — choisissez un script dans votre bibliothèque. Level crée une nouvelle automatisation d'exécution de script avec deux actions : Attendre l'approbation et Exécuter le script.
Exécuter un nouveau script — écrivez un nouveau script sur le moment. Le script est enregistré dans votre bibliothèque et une automatisation d'exécution de script est créée pour celui-ci.
Ajouter à l'exécution de script récente — ajoutez les appareils sélectionnés à une automatisation d'exécution de script existante plutôt que d'en créer une nouvelle.
Dans un moniteur de script — un moniteur exécute un script selon un calendrier et évalue sa sortie pour déterminer l'état de santé de l'appareil. Consultez Moniteurs de scripts pour les détails de configuration.
ℹ️ REMARQUE : Les automatisations d'exécution de script sont réutilisables. Vous pouvez les renommer, les déplacer dans un groupe, ajouter d'autres actions ou ajuster leur déclencheur avant d'approuver. Le script ne s'exécutera pas tant que l'étape Attendre l'approbation est approuvée manuellement. Toutes les exécutions de scripts sont suivies sous Automatisations → Exécutions de scripts dans la barre latérale.
FAQ
Quelle est la différence entre Exécuter le script enregistré, Exécuter un nouveau script et Ajouter à l'exécution de script récente ? Les trois options se trouvent dans le menu Actions dans le menu Exécuter le script enregistré choisit un script existant dans la bibliothèque et crée une nouvelle automatisation d'exécution de script pour celui-ci. Exécuter un nouveau script vous permet d'écrire un nouveau script sur le moment — il est enregistré dans la bibliothèque et une automatisation d'exécution de script est créée. Ajouter à l'exécution de script récente ajoute les appareils sélectionnés à une automatisation d'exécution de script existante plutôt que d'en créer une nouvelle. Dans tous les cas, le script ne s'exécutera pas tant que l'action Attendre l'approbation est approuvée.
Quelle est la différence entre un script enregistré et une action Shell ? Un script enregistré réside dans la bibliothèque et est réutilisable — référencez-le depuis n'importe quelle automatisation, moniteur ou exécution ad hoc, et les modifications à un seul endroit mettent à jour toutes les références. L'action Shell exécute un script écrit directement dans l'automatisation, sans entrée dans la bibliothèque. Utilisez des scripts enregistrés pour tout ce que vous exécuterez plus d'une fois ou que vous souhaitez maintenir dans le temps.
Puis-je modifier un script sans casser les automatisations qui l'utilisent ? Oui. Les modifications apportées à un script enregistré prennent effet la prochaine fois que toute automatisation le référençant s'exécute — il n'est pas nécessaire de mettre à jour l'automatisation elle-même. L'onglet Automatisations liées affiche exactement quelles automatisations seront affectées.
Quels langages Level prend-il en charge ? Ansible, Bash, Go, osquery, PowerShell, Python et Zsh.
Un script peut-il transmettre sa sortie aux actions d'automatisation suivantes ? Oui — de deux façons. Définissez des variables de script dans l'onglet Variables et mappez-les à des variables d'automatisation dans le panneau Exécuter le script du panneau d'action. Ou utilisez Assigner la sortie de l'action à une variable dans les options supplémentaires de l'action pour capturer l'intégralité du stdout du script. Consultez Action Exécuter le script pour plus de détails.
Qui peut créer et modifier des scripts ? 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.
Que se passe-t-il avec les automatisations si je supprime un script ? Level bloque la suppression d'un script lié à des automatisations ou des moniteurs actifs. Utilisez les onglets Automatisations liées et Moniteurs liés pour voir ce qui doit être dissocié en premier.