La bibliothèque de scripts est l'endroit où vous créez, organisez et maintenez les scripts qui peuvent être utilisés dans les automatisations, les moniteurs de scripts et les exécutions ad-hoc à partir de la liste des appareils ou des détails de l'appareil. Les scripts sont enregistrés une fois et réutilisables dans tout votre environnement — modifiez un script dans la bibliothèque et la mise à jour est reflétée partout où il est référencé.
Scripts
Allez à Scripts dans la barre latérale.
La barre latérale gauche a 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 attribués à un groupe
Au-dessous, la section Groupes de scripts répertorie tous les groupes personnalisés que vous avez créés. Sélectionnez un groupe pour filtrer le tableau pour afficher uniquement les scripts de ce groupe.
Le tableau principal affiche tous les scripts correspondant à la sélection actuelle. Les colonnes incluent Nom, Groupe, Description, Type (langage) et Créé. Cliquez sur n'importe quel nom de script pour l'ouvrir dans l'éditeur.
Créer un Script
Cliquez sur + Créer un script en haut à droite, ou sur Nouveau script dans la barre latérale. Une boîte de dialogue apparaît demandant un nom.
Entrez un nom et cliquez sur Créer. L'éditeur de script s'ouvre immédiatement.
💡 CONSEIL : Nommez les scripts de manière spécifique — « Désactiver le compte invité - Windows » est plus facile à trouver et à réutiliser que « Script de compte invité ». Vous pouvez toujours renommer plus tard.
Éditeur de Scripts
Chaque script a quatre onglets dans le panneau de 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 — optionnel. Affiché dans la liste des scripts. Utile de le remplir pour les bibliothèques partagées.
Langage — le langage de script. Options supportées :
Ansible
Bash
Go
osquery
PowerShell
Python
Zsh
Délai d'attente (en secondes) — combien de temps 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 dans 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é — utilisez-le pour les opérations en contexte utilisateur comme l'application d'un fond d'écran ou la configuration 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 de champ personnalisé en ligne.
Cliquez sur Enregistrer le script pour enregistrer. Les modifications ne prennent effet qu'après avoir été enregistrées.
⚠️ AVERTISSEMENT : Les modifications non enregistrées sont perdues si vous vous éloignez. 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 écrit une valeur lors de son exécution, et vous pouvez mapper cette valeur à une variable d'automatisation dans le panneau d'action Exécuter le script pour la transmettre dans le pipeline.
Cliquez sur + Ajouter une nouvelle variable pour définir une nouvelle variable. Une fois définie, les variables apparaissent dans la section 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 passer des données dans un script — contexte d'appareil, valeurs de champ personnalisé, informations système — utilisez le sélecteur {x} dans l'éditeur de code pour référencer les variables ou les champs personnalisés en ligne.
Pour la référence complète sur le mappage des variables de script à des 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 action Exécuter le script. Cliquez sur n'importe quel nom d'automatisation pour l'ouvrir.
ℹ️ REMARQUE : Un script ne peut pas être supprimé s'il a des automatisations liées. Vous devrez d'abord supprimer le script de chaque automatisation le référençant, ou supprimer ces automatisations. L'onglet facilite la visualisation exacte de 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 de tous les moniteurs avant qu'un script puisse être supprimé.
Organisation avec des Groupes de Scripts
Les groupes de scripts vous permettent de catégoriser les scripts par plateforme, fonction, équipe ou selon ce qui a du sens pour 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 du script (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. L'organisation par fonction facilite la recherche du bon script par toute l'équipe, quel que soit l'appareil sur lequel il s'exécute.
Suppression d'un Script
Ouvrez le menu Actions du script et sélectionnez Supprimer. Une boîte de dialogue de confirmation apparaît.
⚠️ AVERTISSEMENT : La suppression de script ne peut pas être annulée. Si le script a des automatisations ou des moniteurs liés, Level bloque la suppression — supprimez d'abord tous les liens en utilisant les onglets Automatisations liées et Moniteurs liés.
Exécution de Scripts
Les scripts peuvent être exécutés de plusieurs façons :
Dans une automatisation — via l'action Exécuter le script. Le script s'exécute sur chaque appareil cible dans le cadre du pipeline d'automatisation. C'est le principal moyen d'exécuter les scripts à grande échelle ou selon un calendrier. Consultez Action Exécuter le Script pour la référence complète.
Ad-hoc à partir de la liste des appareils ou des détails de l'appareil — sélectionnez les appareils et ouvrez le menu Actions. Trois options liées aux scripts apparaissent :
Exécuter un script enregistré — choisissez un script de 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 spot. Le script est enregistré dans votre bibliothèque et une automatisation d'exécution de script est créée pour lui.
Ajouter à une 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 démarrer une nouvelle.
Dans un moniteur de script — un moniteur exécute un script selon un calendrier et évalue sa sortie pour déterminer la 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 vers un groupe, ajouter plus d'actions ou ajuster leur déclencheur avant approbation. Le script ne s'exécutera pas jusqu'à ce que l'étape Attendre l'approbation soit manuellement approuvée. 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 un script enregistré, Exécuter un nouveau script et Ajouter à une exécution de script récente ? Les trois se trouvent dans le menu Actions sur la liste des appareils et les détails de l'appareil. Exécuter un script enregistré choisit un script de bibliothèque existant et crée une nouvelle automatisation d'exécution de script. Exécuter un nouveau script vous permet d'écrire un nouveau script sur le spot — il est enregistré dans la bibliothèque et une automatisation d'exécution de script est créée. Ajouter à une exécution de script récente ajoute les appareils sélectionnés à une automatisation d'exécution de script existante plutôt que de démarrer une nouvelle. Dans tous les cas, le script ne s'exécutera pas jusqu'à ce que l'action Attendre l'approbation soit approuvée.
Quelle est la différence entre un script enregistré et une action Shell ? Un script enregistré vit dans la bibliothèque et est réutilisable — le référencer de n'importe quelle automatisation, moniteur ou exécution ad-hoc, et les modifications en un seul endroit mettent à jour toutes les références. L'action Shell exécute un script écrit en ligne dans l'automatisation, sans entrée de bibliothèque. Utilisez les scripts enregistrés pour tout ce que vous exécuterez plus d'une fois ou que vous voudrez 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 montre exactement quelles automatisations seront affectées.
Quels langages Level supporte-t-il ? Ansible, Bash, Go, osquery, PowerShell, Python et Zsh.
Un script peut-il passer sa sortie à des actions d'automatisation ultérieures ? Oui — deux façons. Définissez les variables de script dans l'onglet Variables et mappez-les à des variables d'automatisation dans le panneau d'action Exécuter le script. Ou utilisez Assigner la sortie d'action à une variable dans les options supplémentaires de l'action pour capturer la stdout complète du script. Consultez Action Exécuter le Script pour les détails.
Qui peut créer et modifier des scripts ? Les techniciens avec la permission de modifier les automatisations dans le groupe pertinent. Consultez Espace de travail → Autorisations pour la configuration du contrôle d'accès.
Que se passe-t-il pour les automatisations si je supprime un script ? Level bloque la suppression d'un script qui est lié aux automatisations ou moniteurs actifs. Utilisez les onglets Automatisations liées et Moniteurs liés pour voir ce qui doit être déassocié d'abord.