Retour

Bibliothèque de scripts

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

  1. Dans la console IT Factorial, ouvrez Gestion des appareils.
  2. Sélectionnez l'onglet Scripts.
  3. 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

  1. Cliquez sur Ajouter un script.
  2. Fournissez le script de deux manières :
    • Faites glisser et déposez un fichier .sh, .py ou .ps1 dans 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.
  3. 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

  1. Dans la ligne du script, ouvrez le menu d'actions et sélectionnez Modifier.
  2. Modifiez le script dans l'éditeur.
  3. 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

  1. Dans la ligne du script, ouvrez le menu d'actions et sélectionnez Supprimer.
  2. 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, .py ou .ps1.
  • Le contenu fait 1 MiB ou moins.
  • Un script .py commence par un shebang python, par exemple :
    #!/usr/bin/env python3
    print("Hello from Factorial IT")
  • Un script .sh qui déclare un shebang utilise un interpréteur pris en charge, tel que #!/bin/bash ou #!/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 python3 ou 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

  1. Quelles plateformes peuvent exécuter des scripts de la bibliothèque ?
    macOS et Linux avec .sh et .py, et Windows avec .ps1.
     
  2. 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.
     
  3. Quelle taille peut avoir un script ?
    Jusqu'à 1 MiB.
     
  4. Puis-je changer la plateforme d'un script après l'avoir enregistré ?
    Non. Supprimez-le et créez-en un nouveau.

Cet article vous a-t-il aidé ?

Give feedback about this article

Vous ne trouvez pas ce que vous cherchez ?

Notre équipe de service client est là pour vous.

Nous contacter

Knowledge Base Software powered by Helpjuice