# Utilitaire de ligne de commande

Les lignes de commande Insight Student Command Line offrent aux administrateurs une plus grande souplesse pour gérer les ordinateurs Insight. Ces commandes peuvent être exécutées avec des outils de gestion d’entreprise tiers et/ou des solutions de gestion centrale comme Apple Remote Desktop. Cela inclut l’exécution de commandes dans Terminal tout en étant connecté à un ordinateur distant via SSH.

| Commande                                              | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--help`                                              | Afficher cette aide                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `--password`                                          | <p>Permet au mot de passe de l’administrateur pour exécuter n’importe quelle commande, à l’exception de --aide.</p><p></p><p>Remarque : Le fait de fournir le mot de passe de l’administrateur limite l’exécution des commandes aux seuls utilisateurs autorisés.</p>                                                                                                                                                                                                                                                                                       |
| `--settings`                                          | Affiche les paramètres actuels enregistrés sur cet ordinateur.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `--uninstall`                                         | Désinstallez Insight Student de cet ordinateur.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `--securityToken`                                     | <p>Définissez le jeton de sécurité</p><p></p><p>Si elle est fournie, la valeur peut être transmise en tant que variable d'environnement en spécifiant --env à la fin.</p><p> </p><p>Exemple :</p><p><code>TOKEN="token" ADMINPSWD="password1" sudo insightstudent --securityToken --adminPassword --env</code></p>                                                                                                                                                                                                                                          |
| `--adminPassword`                                     | <p>Définissez le mot de passe administrateur pour Insight.</p><p></p><p>Si elle est fournie, la valeur peut être transmise en tant que variable d'environnement en spécifiant --env à la fin.</p><p> </p><p>Exemple :</p><p><code>TOKEN="token" ADMINPSWD="password1" sudo insightstudent --securityToken --adminPassword --env</code></p>                                                                                                                                                                                                                  |
| `--connectorAddress "value"`                          | La valeur peut être n'importe quelle adresse IP valide.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `--defaultClassId "Class ID"`                         | <p>Définissez l'identifiant de classe par défaut à la valeur spécifiée.</p><p></p><p>Remarque : Si l'identifiant de classe a un espace, l'identifiant de classe doit être mis entre guillemets.</p><p> </p><p>Exemple :</p><p><code>--defaultClassId "Home 100"</code></p>                                                                                                                                                                                                                                                                                  |
| `--menuBarIcon true \| false`                         | Afficher ou masquer l'icône Insight Student dans la barre de menu.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `--changeClassId true \| false`                       | Autoriser ou désactiver les étudiants à modifier l'identifiant de classe dans Insight.                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `--monitorKeystrokes true \| false`                   | Activer ou non la surveillance des frappes au clavier.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `--requirePermission true \| false`                   | <p>Quand cette valeur est fixée à true (vrai), l'enseignant demandera à l'élève la permission de permettre l'enregistrement de l'écran.</p><p></p><p>Ces paramètres peuvent être trouvés dans :</p><ul><li>Pour macOS Ventura ou plus récent : Réglages du système --> Confidentialité et sécurité</li><li>Pour macOS Monterey ou plus ancien : Préférences du système --> Sécurité et confidentialité --> Confidentialité</li></ul><p>Les paramètres peuvent être utilisés à l'aide de la solution MDM ou définis manuellement pour chaque ordinateur.</p> |
| `--webHistory true \| false`                          | <p>Autoriser ou non la surveillance de l'historique Web sur les élèves. </p><p></p><p>Remarque : Activer l'historique Web installera également l'extension pour le navigateur.</p>                                                                                                                                                                                                                                                                                                                                                                          |
| `--installBrowserExtension`                           | Configurer cette option permet d'installer les extensions du navigateur sur le système de vos élèves.                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `--restrictWiFi "value1,value2..." \| --allowAllWiFi` | Permettre à Insight de restreindre les réseaux sans fil auxquels le système peut se connecter.                                                                                                                                                                                                                                                                                                                                                                                                                                                              |

{% hint style="info" %}
À l'exception des commandes `--help`, `--settings`,  et`--uninstall`,  les autres commandes peuvent contenir plusieurs options en même temps.
{% endhint %}

Quand un mot de passe et/ou un jeton est spécifié, la commande demande le mot de passe et le confirme. Les caractères tapés pour le mot de passe et le mot de passe de confirmation ne seront pas répercutés sur le terminal.&#x20;

Si la ligne de commande est exécutée avec un outil de gestion tiers, le chemin complet `/usr/local/bin/insightstudent` doit être spécifié et la commande doit être exécutée en tant qu'utilisateur "root".&#x20;

Lorsque vous utilisez un outil de gestion tiers, le mot de passe et le jeton de sécurité doivent être transmis en tant que variable d'environnement en spécifiant `--env` à la fin, afin d'éviter d'avoir à saisir le mot de passe et le mot de passe de confirmation.“`sudo`” ne doit pas être utilisé car la commande est déjà exécutée en tant que "root".

Exemples de scénarios de ligne de commande :

<table data-full-width="false"><thead><tr><th>Terminal.app</th><th>Outil de gestion tiers (exécuté en tant qu'utilisateur "root")</th><th>Description</th></tr></thead><tbody><tr><td><code>sudo insightstudent --password "admin password" --settingsightstudent --settings</code></td><td><code>/usr/local/bin/insightstudent --password "admin password" --settings</code></td><td>Imprime les paramètres actuels.</td></tr><tr><td><code>sudo insightstudent --password "admin password" --adminPassword</code> </td><td><code>ADMINPSWD="new password" /usr/local/bin/insightstudent --password "admin password" --adminPassword --env</code></td><td>Définit le nouveau mot de passe administrateur et saisit le mot de passe et la confirmation à l’invite.</td></tr><tr><td><code>sudo insightstudent --password "admin password" --securityToken</code></td><td><code>TOKEN="token" /usr/local/bin/insightstudent --password "admin password" --securityToken --env</code></td><td>Définit le jeton de sécurité et saisit le jeton et la confirmation à l'invite.</td></tr><tr><td><code>sudo insightstudent --password "admin password" --adminPassword --defaultClassId "Home 100" --menuBarIcon false --changeClassId true --connectorAddress "192.168.0.1"</code></td><td><code>ADMINPSWD="new password" /usr/local/bin/insightstudent --password "admin password" --adminPassword --defaultClassId "Home 100" --menuBarIcon false --changeClassId true --connectorAddress "192.168.0.1" --env</code></td><td>Combine plusieurs options pour définir un nouveau mot de passe administrateur, un identifiant de classe par défaut, une icône de barre de menu et l'adresse IP d'Insight Connector.</td></tr><tr><td><code>sudo insightstudent --password "admin password" --uninstall</code></td><td><code>/usr/local/bin/insightstudent --password "admin password" --uninstall</code></td><td>Désinstalle Insight Student.</td></tr></tbody></table>

&#x20;