Introduction
La bibliothèque de scripts est l'endroit où vous créez, organisez et entretenez les scripts qui peuvent ê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 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
Go to Scripts in the sidebar.
La barre latérale gauche a trois éléments fixes en haut :
All scripts— affiche chaque script dans votre bibliothèque, dans tous les groupes
New script— ouvre la boîte de dialogue Créer un script
Scripts non groupés— scripts pas encore assignés à un groupe
Ci-dessous, leScript groupsLa section répertorie tous les groupes personnalisés que vous avez créés. Sélectionnez un groupe pour filtrer le tableau des scripts uniquement dans ce groupe.
Le tableau principal affiche tous les scripts correspondant à la sélection actuelle. Les colonnes incluentName, Group, Description, Type (language), and Created. Cliquez sur n'importe quel nom de script pour l'ouvrir dans l'éditeur.
Création d'un script
Click + Create scripten haut à droite, ouNew scriptdans la barre latérale. Une boîte de dialogue vous demande un nom.
Entrez un nom et cliquez surCreate. L'éditeur de script s'ouvre immédiatement.
💡 TIP:Nommez les scripts spécifiquement — « Désactiver le compte invité - Windows » est plus facile à trouver et à réutiliser que « Script de compte invité ». Vous pouvez toujours renommer ultérieurement.
Script Editor
Chaque script a quatre onglets dans le panneau gauche :Script, Variables, Automatisations liées, and Linked monitors.
Les champs configurables :
Script name— le nom affiché dans la bibliothèque et dans le sélecteur d'action Exécuter le script.
Description— en option. Affiché dans la liste des scripts. Vaut la peine de remplir pour les bibliothèques partagées.
Language— le langage de programmation. Options supportées :
Ansible
Bash
Go
osquery
PowerShell
Python
Zsh
Délai d'expiration (en secondes)— combien de temps Level attend la fin du script avant de marquer l'exécution comme échouée. La valeur par défaut est de 100 secondes.
Run as— le contexte de compte dans lequel le script s'exécute :
Option | Behavior |
Local system | S'exécute en tant que compte SYSTEM — surélevé, sans contexte utilisateur |
Current user | S'exécute en tant qu'utilisateur connecté — utilisez-le pour les opérations de contexte utilisateur comme l'application de papier peint 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 référence de variable, de variable système ou de champ personnalisé en ligne.
Click Save scriptpour enregistrer. Les modifications ne prennent effet qu'une fois enregistrées.
⚠️ WARNING:Les modifications non enregistrées sont perdues si vous quittez l'éditeur. Enregistrez avant de quitter.
Variables
Le VariablesL'onglet affiche tous 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 pour eux lors de l'exécution, et vous pouvez mapper cette valeur à une variable d'automatisation dans leRun Scriptpanneau d'action pour la transmettre à travers la canalisation.
Click + Ajouter une nouvelle variablepour définir une nouvelle variable. Une fois définis, les variables apparaissent dans laVariables de script section of any Run Scriptaction qui référence ce script.
ℹ️ REMARQUE :Les variables de script capturent la sortie d'un script. Pour transmettre des donnéesintoun script — contexte de l'appareil, valeurs de champs personnalisés, informations système — utilisez le{x}sélecteur 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 ultérieures, voirAction Exécuter le script, Variables d'automatisation, and Variables système.
Automatisations liées
Le L'onglet Automatisations liéesrépertorie chaque automatisation qui référence ce script via uneRun Scriptaction. Cliquez sur n'importe quel nom d'automatisation pour l'ouvrir.
ℹ️ REMARQUE :Un script ne peut pas être supprimé tant qu'il a des automatisations liées. Vous devrez d'abord supprimer le script de chaque automatisation de référence, ou supprimer ces automatisations. L'onglet permet de voir facilement exactement ce qui serait affecté.
Linked Monitors
Le Linked monitorsL'onglet répertorie tous les moniteurs de script utilisant ce script. La même règle de suppression s'applique : dissociez-vous de tous les moniteurs avant qu'un script ne 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 tout ce qui a du sens pour votre environnement. Les groupes apparaissent dans la barre latérale sousScript groupset en tant que colonne dans la liste des scripts.
Pour créer un groupe, cliquez sur la+ icon next to Script groupsdans la barre latérale. Une boîte de dialogue vous demande un nom de groupe.
Pour assigner un script à un groupe, ouvrez le scriptActionsmenu (en haut à droite) et sélectionnezAssign to group.
💡 TIP:Les groupes de scripts reflètent généralement la finalité ou le rôle — Sécurité, Logiciel, Moniteurs, Utilitaires — pas la structure de vos groupes d'appareils. L'organisation par fonction facilite la recherche du bon script par toute l'équipe, quel que soit le dispositif sur lequel il s'exécute.
Suppression d'un script
Ouvrez le scriptActions menu and select Delete. Une boîte de dialogue de confirmation apparaît.
⚠️ WARNING:La suppression d'un script ne peut pas être annulée. Si le script a des automatisations ou moniteurs liés, Level bloque la suppression — supprimez tous les liens d'abord en utilisant leAutomatisations liées et Linked monitors tabs.
Running Scripts
Les scripts peuvent être exécutés de plusieurs façons :
Dans une automatisation — via the Run Scriptaction. Le script s'exécute sur chaque appareil cible dans le cadre de la canalisation d'automatisation. C'est la façon principale d'exécuter les scripts à grande échelle ou selon un calendrier. VoirAction Exécuter le scriptpour la référence complète.
Ad-hoc depuis la liste des appareils ou les détails de l'appareil— sélectionnez les appareils et ouvrez leActionsmenu. Trois options liées aux scripts apparaissent :
Exécuter un script enregistré— choisissez un script dans votre bibliothèque. Level crée une nouvelle automatisation d'exécution de script avec deux actions :Attendre approbation et Run script.
Run new script— écrivez un nouveau script immédiatement. Le script est enregistré dans votre bibliothèque et une automatisation d'exécution de script est créée pour celui-ci.
Ajouter à la récente exécution de script— ajoutez les appareils sélectionnés à une automatisation d'exécution de script existante plutôt que de 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. VoirScript Monitorspour 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 d'autres actions ou ajuster leur déclencheur avant approbation. Le script ne s'exécutera pas jusqu'à ce que leAttendre approbationl'étape est manuellement approuvée. Tous les exécutions de script sont suivies sousAutomatisations → Exécutions de script in the sidebar.
FAQ
Quelle est la différence entre Exécuter un script enregistré, Exécuter un nouveau script et Ajouter à la récente exécution de script ?Les trois sont dans leActionsmenu 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 pour celui-ci.Run new scriptvous permet d'écrire un nouveau script immédiatement — il est enregistré dans la bibliothèque et une automatisation d'exécution de script est créée.Ajouter à la récente exécution de scriptajoute 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 leAttendre approbationl'action est 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 — référencez-le à partir de n'importe quelle automatisation, moniteur ou exécution ad-hoc, et les modifications à un endroit mettent à jour toutes les références. LeShellaction 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 souhaitez maintenir au fil du 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 l'automatisation de référence s'exécute — il n'est pas nécessaire de mettre à jour l'automatisation elle-même. LeAutomatisations liéesL'onglet affiche 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 une sortie aux actions d'automatisation ultérieures ?Oui — deux façons. Définissez les variables de script dans leVariablesonglet et mappez-les à des variables d'automatisation dans leRun Scriptpanneau d'action. Ou utiliserAttribuer la sortie de l'action à une variabledans les Options supplémentaires pour capturer la sortie standard complète du script. VoirAction 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 pertinent. VoirEspace de travail → Permissionspour 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 lié aux automatisations ou moniteurs actifs. Utilisez leAutomatisations liées et Linked monitorsonglets pour voir ce qui doit d'abord être dissocié.