Sujet
Cet article explique comment se lancer dans la création de scripts d'automatisation dans la bibliothèque d'automatisation NinjaOne.
Environnement
NinjaOne Endpoint Management
Description
NinjaOne fournit plusieurs scripts natifs prêts à l'emploi, mais vous pouvez également créer et modifier des scripts personnalisés ou installer et exécuter des automatisations d'applications. Lorsque vous exécutez des scripts personnalisés sur des appareils, NinjaOne vous invite à spécifier des paramètres facultatifs et à indiquer si vous souhaitez exécuter les scripts en tant que Système, Utilisateur actuel ou avec les identifiants de votre magasin d'identifiants.
Consultez d'autres tutoriels dans notre vidéothèque.
Sélectionnez un sujet pour en savoir plus :
- Considérations relatives aux scripts
- Ajouter de nouveaux scripts
- Importer de nouveaux scripts
- Trier et filtrer les scripts d'automatisation dans la bibliothèque d'automatisation
- Modifier, copier ou supprimer des scripts ou des applications existants
- Automatisations en cours de révision
- Bibliothèque de modèles
- Ressources supplémentaires
Considérations relatives aux scripts
Tenez compte des éléments suivants lors de la planification de vos scripts :
- L'agent NinjaOne ne fournit pas d'assistance au dépannage pour les scripts de redémarrage personnalisés. Pour lancer un redémarrage, nous vous recommandons d'utiliser le script de redémarrage natif de NinjaOne afin de garantir que l'agent puisse gérer correctement l'action.
- Les automatisations marquées comme « All » pour le paramètre Architecture s'exécutent en fonction de l'architecture native de l'appareil (32 ou 64 bits).
- Vous ne pouvez pas utiliser les caractères spéciaux suivants dans les paramètres :
&|;$><`!. - Vous pouvez attribuer des scripts à une catégorie (ou à plusieurs catégories) afin d'organiser davantage la bibliothèque d'automatisations. Pour créer de nouvelles catégories ou modifier ou supprimer des catégories existantes, cliquez sur l'onglet « Categories » dans Administration → Library → Automation.
- NinjaOne n'accepte que les paramètres de type chaîne de caractères. Cela inclut les chaînes de caractères, les nombres entiers décimaux et les options de case à cocher.
Langages de script pris en charge
NinjaOne prend en charge les langages de script suivants :
- JavaScript
- PowerShell
- Batch
- ShellScript
- VBS Script
Applications automatisées
Les administrateurs peuvent configurer des scripts pour exécuter ou installer une application. Les options d'automatisation « Exécuter » et « Installer » vous permettent de créer une bibliothèque de scripts d'applications installées et en cours d'exécution à ajouter à une stratégie ou à une tâche planifiée, ou à exécuter à la demande. Par exemple, si vous exécutez CCleaner sur des terminaux, vous pouvez utiliser NinjaOne pour l'appeler.
Une fois qu'une application est installée dans la bibliothèque d'automatisation, vous pouvez l'utiliser plusieurs fois sur différentes organisations et différents appareils. Consultez NinjaOne Endpoint Management : Exécuter ou installer des automatisations d'applications pour en savoir plus.
Ajouter de nouveaux scripts
Pour ajouter de nouveaux scripts, procédez comme suit :
Configurer les paramètres de script
- Accédez à Administration → Bibliothèque → Automatisation, puis cliquez sur Ajouter une automatisation → Nouveau script.
- La page Créer un script s'ouvre. Configurez les paramètres suivants en fonction des exigences linguistiques de chaque script :
| Paramètre | Description |
|---|---|
| Nom | Donnez à votre script un nom descriptif. |
| Description | Ajoutez une description facultative expliquant la fonction du script. |
| Catégories | Choisissez les catégories de la bibliothèque d'automatisation dans lesquelles vous souhaitez classer votre script. Vous pouvez sélectionner une ou plusieurs catégories. |
| Langage | Sélectionnez la langue dans laquelle vous allez écrire votre script. Le formatage des commandes changera automatiquement en fonction de la langue sélectionnée. |
| Système d'exploitation | Sélectionnez le système d'exploitation adapté à votre script. Cette option sera grisée tant que vous n'aurez pas sélectionné de langue. |
| Architecture | Sélectionnez une architecture 32 bits ou 64 bits. |
| Exécuter en tant que | Spécifiez le rôle sous lequel le script s'exécutera. Ces options varient en fonction du système d'exploitation que vous sélectionnez. |
| Variables de script | Cliquez sur Ajouter pour choisir des variables de script dans le menu déroulant. Pour plus d'informations sur les variables de script, consultez NinjaOne Endpoint Management : Utilisation des variables dans les scripts d'automatisation. |
| Paramètres | Définissez les paramètres qui utiliseront les arguments des appels comme valeurs de paramètres. Pour plus d'informations sur les paramètres, consultez NinjaOne Endpoint Management : Paramètres d'automatisation. |
Écrivez et implémentez votre script
Saisissez le script dans le volet d'édition. Si vous souhaitez que votre script interagisse avec les données des champs personnalisés, appuyez sur Ctrl+Espace. Tapez Get ou Set pour accéder aux extraits de code, qui sont des éléments de base que vous pouvez utiliser pour lire ou écrire dans des scripts personnalisés spécifiques. Pour plus d'informations, consultez la section Lecture ou écriture dans les champs personnalisés dans les scripts. Une fois terminé, cliquez sur Enregistrer pour enregistrer votre script.
Le script est désormais disponible pour être utilisé dans l'automatisation planifiée en tant que tâche planifiée ou en tant qu'exécution manuelle. Pour en savoir plus, consultez les ressources suivantes :
- Politiques NinjaOne : automatisations planifiées
- Gestion des terminaux NinjaOne : tâches planifiées
- Gestion des terminaux NinjaOne : Exécution de scripts d'automatisation et d'applications à la demande
Importer de nouveaux scripts
Pour importer de nouveaux scripts ou fichiers dans NinjaOne, procédez comme suit :
- Accédez à Administration → Bibliothèque → Automatisation, puis cliquez sur Ajouter une automatisation → Importer à partir d'un fichier ou Importer à partir d'un modèle.
- Sélectionnez le fichier du script que vous souhaitez importer. Si vous choisissez d'importer à partir d'un modèle, NinjaOne vous redirigera vers l'onglet Bibliothèque de modèles, où vous pourrez sélectionner l'un des scripts natifs proposés par NinjaOne. Pour en savoir plus sur les scripts hébergés dans la Bibliothèque de modèles, consultez NinjaOne Endpoint Management : Scripts d'automatisation natifs.
Trier et filtrer les scripts d'automatisation dans la bibliothèque d'automatisation
Vous pouvez modifier vos paramètres de tri dans les paramètres du tableau de la bibliothèque d'automatisation en suivant les étapes suivantes :
- Dans la bibliothèque d'automatisation, cliquez sur l'icône en forme d'engrenage.
- Sélectionnez vos critères de tri. Vous pouvez trier, ajouter, supprimer et réorganiser l'affichage des colonnes. Pour réorganiser les colonnes affichées sur la page, cliquez sur le nom de la colonne et maintenez-le enfoncé, puis faites-le glisser vers le haut ou vers le bas. Une fois terminé, cliquez sur Enregistrer.
Modifier, copier ou supprimer des scripts ou des applications existants
Lorsque vous travaillez avec des scripts existants, gardez à l'esprit les considérations suivantes :
- Vous ne pouvez modifier, copier ou supprimer que les scripts et applications personnalisés.
- Vous ne pouvez pas supprimer les scripts natifs de NinjaOne, mais vous pouvez modifier leurs catégories.
- Vous pouvez supprimer ou modifier les applications Exécuter et Installer, mais vous ne pouvez pas les copier.
- Vous pouvez uniquement supprimer ou afficher les programmes d'installation hérités.
Procédure
Accédez à Administration → Bibliothèque → Automatisation et placez votre curseur sur un script ou une application. Cliquez sur l'icône représentant trois points pour afficher les options du menu.
- Cliquez sur Modifier pour ouvrir l'éditeur de script et apporter des modifications. Cliquez sur Enregistrer pour finaliser le nouveau script.
- Cliquez sur Supprimer pour retirer le script ou l'application de votre bibliothèque. Si vous supprimez une catégorie, NinjaOne la classera dans la catégorie Non classé.
- Sélectionnez Copier pour créer un nouveau script identique au script d'origine. NinjaOne vous demandera de nommer le nouveau script. Une fois terminé, cliquez sur Enregistrer.
Automatisations en cours de révision
Lorsque vous ajoutez une application d'installation à la bibliothèque d'automatisations, celle-ci apparaît dans l'onglet En cours de révision avant d'être déplacée vers l'onglet Automatisations.
Pendant que les automatisations sont en cours de vérification, NinjaOne valide les fichiers principaux et auxiliaires pour s'assurer qu'ils ne contiennent pas de logiciels malveillants, de virus ou de problèmes d'URL d'installation susceptibles de provoquer des erreurs d'application.
Bibliothèque de modèles
La bibliothèque de modèles est une collection de scripts écrits par l'équipe interne de développement de scripts de NinjaOne, compilés à partir des demandes les plus fréquentes de la communauté NinjaOne. NinjaOne fournit ces scripts « tels quels », et il vous incombe de les tester et de les évaluer avant leur mise en œuvre.
Pour en savoir plus sur les scripts hébergés dans la bibliothèque de modèles, consultez NinjaOne Endpoint Management : Scripts d'automatisation natifs.
Ressources supplémentaires
Pour consulter la liste des questions fréquemment posées concernant la bibliothèque d'automatisation, consultez Bibliothèque d'automatisation : FAQ.
Consultez la section Scripting, automatisation, CLI : catalogue de ressources pour en savoir plus sur l'automatisation dans NinjaOne.