La bibliothèque de scripts est l'endroit où vous conservez les scripts que vous exécutez sur vos appareils. Téléchargez un script .sh, .py ou .ps1 une fois et exécutez-le sur n'importe quel appareil compatible.
Présentation
Types de scripts pris en charge :
| Extension | Plateformes | Remarques |
|---|---|---|
.sh |
macOS, Linux | Doit s'exécuter sous /bin/sh, /bin/bash ou /bin/zsh. |
.py |
macOS, Linux | Doit commencer par un shebang incluant python (par exemple, #!/usr/bin/env python3). |
.ps1 |
Windows | S'exécute dans PowerShell. |
Chaque script est limité à 1 MiB.
Comment utiliser
Ouvrir la bibliothèque de scripts
- Dans la console IT Factorial, ouvrez Gestion des appareils.
- Sélectionnez l'onglet Scripts.
- Sélectionnez le sous-onglet Bibliothèque de scripts. Chaque ligne affiche le nom, le type et les actions d'un script.
Ajouter un script
- Cliquez sur Ajouter un script.
- Fournissez le script de deux manières :
-
Faites glisser et déposez un fichier
.sh,.pyou.ps1dans la zone de téléchargement. Le nom, la plateforme et le contenu sont remplis pour vous. - Remplissez les champs manuellement : choisissez une plateforme, tapez un nom se terminant par la bonne extension et collez le script dans l'éditeur.
-
Faites glisser et déposez un fichier
- Cliquez sur Enregistrer.
Le sélecteur Plateforme contrôle l'extension. Changer la plateforme réécrit l'extension dans le nom. Taper un nom se terminant par une extension correspondante change la plateforme. Les deux champs peuvent être modifiés librement ; ils restent liés uniquement lorsque l'autre ne laisse aucun doute.
Modifier un script
- Dans la ligne du script, ouvrez le menu d'actions et sélectionnez Modifier.
- Modifiez le script dans l'éditeur.
- Cliquez sur Enregistrer. Le bouton reste désactivé jusqu'à ce que vous changiez quelque chose.
Seuls les contenus peuvent être modifiés. Le nom et la plateforme sont verrouillés, car renommer changerait le type de script. Pour renommer un script ou changer son type, supprimez-le et créez-en un nouveau.
Télécharger un script
Dans la ligne du script, ouvrez le menu d'actions et sélectionnez Télécharger. Le fichier conserve son nom et son extension d'origine.
Supprimer un script
- Dans la ligne du script, ouvrez le menu d'actions et sélectionnez Supprimer.
- Confirmez dans la boîte de dialogue.
Les exécutions antérieures restent dans l'historique des scripts de chaque appareil, car Factorial IT conserve le nom et le contenu utilisés à l'époque. Les exécutions qui n'avaient pas encore été terminées sont marquées annulées.
Règles de validation
Avant d'enregistrer, Factorial IT vérifie que :
- Le nom se termine par
.sh,.pyou.ps1. - Le contenu fait 1 MiB ou moins.
- Un script
.pycommence par un shebangpython, par exemple :#!/usr/bin/env python3 print("Hello from Factorial IT") - Un script
.shqui déclare un shebang utilise un interpréteur pris en charge, tel que#!/bin/bashou#!/usr/bin/env bash.
Si une vérification échoue, Enregistrer reste désactivé et le champ en faute explique pourquoi.
Permissions
| Action | Permission requise |
|---|---|
| Voir la bibliothèque, télécharger un script | MDM_READ |
| Ajouter, modifier ou supprimer un script | MDM_WRITE |
Sans la bonne permission, l'action est toujours affichée mais désactivée, et un tooltip vous explique pourquoi.
Conseils et meilleures pratiques
- Faites glisser et déposez le fichier. Cela remplit le nom, la plateforme et le contenu pour vous et évite les erreurs d'extension.
-
Ajoutez toujours un shebang aux scripts Python. Sans
#!/usr/bin/env python3ou similaire, le script ne peut pas être enregistré. - Téléchargez avant de supprimer. La suppression ne peut pas être annulée, et vous pourriez vouloir le fichier plus tard.
- Supprimez et recréez pour changer de type. Le nom et la plateforme sont verrouillés une fois qu'un script est enregistré.
Dépannage et FAQ
Dépannage
Enregistrer est désactivé lors de l'ajout d'un script. Une règle de validation a échoué. Lisez le message sous le champ : généralement une mauvaise extension, un shebang python manquant, un shell non pris en charge ou un fichier de plus de 1 MiB.
Enregistrer est désactivé lors de la modification d'un script. Vous n'avez pas encore changé le contenu.
Je ne peux pas renommer un script. Le nom et la plateforme sont verrouillés. Supprimez le script et ajoutez-le à nouveau avec le nouveau nom.
Une action est grisée. Vous manquez MDM_READ ou MDM_WRITE. Survolez-le pour voir lequel.
FAQ
-
Quelles plateformes peuvent exécuter des scripts de la bibliothèque ?
macOS et Linux avec.shet.py, et Windows avec.ps1.
-
Que se passe-t-il avec les exécutions passées lorsque je supprime un script ?
Ils restent dans l'historique des scripts de chaque appareil avec le nom et le contenu utilisés à l'époque. Les exécutions qui n'avaient pas terminé sont annulées.
-
Quelle taille peut avoir un script ?
Jusqu'à 1 MiB.
-
Puis-je changer la plateforme d'un script après l'avoir enregistré ?
Non. Supprimez-le et créez-en un nouveau.