Contexte
La fonctionnalité des custom scripts vous permet d'utiliser l'un des 5 types de script pour exécuter des actions sur un agent ou un nœud que vous aurez préalablement sélectionné.
A noter : Si vous sélectionnez un nœud, tous les agents qui sont dans le nœud seront impactés par le script (modulo les critères d'éligibilité que vous aurez défini dans le script).
Vous pouvez facilement accéder à cette fonctionnalité dans la section "Actions" du menu principal
Les custom scripts
Les custom scripts représentent un ensemble de 5 grands types de script qui vous aideront à réaliser diverses opérations dans RG system.
Les 5 types de scripts sont :
- Exécuter une commande
- Requête SQL
- Requête WMI
- Registre Windows
- Fichier
Visualiser ses scripts
Une fois que vous aurez créé vos premiers scripts, vous les retrouverez dans une liste qui présente 2 vues, "Courant" et "Tous".
Ces 2 vues vous permettront de visualiser tous les scripts qui ont un impact sur l'agent ou les agents de votre contexte.
- Vue "Courant"
Retrouvez dans la liste des scripts, tous les scripts qui ont été créés et configurés spécifiquement sur le nœud ou l'agent sélectionné.
- La vue "Tous"
Cette vue vous permet de voir tous les scripts qui ont été exécutés sur l'agent ou les agents de votre contexte. Vous verrez donc des scripts définis sur des nœuds parents ou sur des nœuds enfants de votre contexte.
Actions de la liste des custom scripts
Plusieurs actions sont disponibles :
- La création
- L'édition,
- La désactivation (ou la mise en pause),
- La duplication,
- La suppression,
- La visualisation (dans le cadre de droits restreints)
Celles-ci vous permettront de facilement manager vos scripts sur l'agent ou le nœud sélectionné.
⚠ Attention : si le script sélectionné a déjà été exécuté au moins une fois, vous ne pourrez plus modifier la fréquence d'exécution. Nous vous conseillons de le dupliquer pour pouvoir ajuster ce paramètre.
Créer un script
L'interface de configuration des scripts s'adaptera en fonction du type de script que vous aurez choisi de créer.
En sélectionnant le choix "Exécuter un script", vous accèderez à l'éditeur de code qui vous permet de rédiger vos scripts dans le Dashboard en utilisant différents langages de programmation tels que PowerShell, Python, Batch, etc..
Les paramètres d'exécution quant à eux seront personnalisables via les sections :
- Paramétrage
- Paramétrage avancé
- Alerte(s)
- Test du script
Utilisez la Bibliothèque de Script
Pour simplifier le processus de création de nouveaux scripts, vous pouvez utiliser des templates prédéfinis disponibles dans la bibliothèque de scripts. Qu'il s'agisse de vos propres templates (Scripts préalablement enregistrés en tant que templates) ou de templates de scripts communautaires, un simple clic dans la bibliothèque vous permet de les utiliser comme point de départ pour créer des scripts.
Consulter les résultats
- Les résultats des Custom Scripts sont accessibles depuis le bouton "Résultats" de la liste.
La page des résultats vous permet de consulter les derniers résultats à l'instant T de chaque agent impacté par le script dans le nœud sélectionné.
Ces résultats peuvent être exportés depuis l'action associée en haut de la liste.
- Il est possible d'accéder aux détails des résultats d'un agent spécifique en cliquant sur le bouton "Détail".
La page des résultats d'un agent vous permet de consulter tous les résultats (jusqu'à un maximum de 1440 résultats glissant) du script sélectionné.
A noter : ceux-ci peuvent être présentés de différentes manières pour adapter l'analyse. Vous pouvez choisir d'afficher les résultats sous forme de tableau textuel pour une vue concise, ou sous forme de courbes pour une visualisation graphique plus détaillée. Ces présentations peuvent être personnalisées dans la configuration du script (onglet paramétrage).
Pour en savoir plus sur les 5 type de scripts, les paramètres, les alertes et le test, veuillez consulter les articles associés :