> For the complete documentation index, see [llms.txt](https://docs.faronics.com/faronics-insight-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.faronics.com/faronics-insight-docs/german/installation-and-verwaltung/installation/installation-unter-macos/insight-student-installieren/befehlszeilenprogramm.md).

# Befehlszeilenprogramm

Die Insight Student-Befehlszeile erhöht die Flexibilität von Netzwerkadministratoren bei der Verwaltung von Insight-Computern. Diese Befehle können mit mehreren unterschiedlichen Enterprise-Management-Tools Dritter (wie z. B. Apple Remote Desktop) und/oder zentralen Management-Lösungen ausgeführt werden; dies umfasst die Ausführung von Befehlen auf Terminals, während eine Verbindung zu einem Remote-Computer über SSH besteht.

| Befehl                                                                                                          | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| --------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--help`                                                                                                        | Diese Hilfe anzeigen.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `--password`                                                                                                    | <p>Geben Sie das Administratorpasswort ein, um einen beliebigen Befehl außer „--help“ auszuführen.</p><p></p><p>Hinweis: Durch die Angabe des Administratorpassworts wird die Ausführung von Befehlen auf autorisierte Benutzer beschränkt.</p>                                                                                                                                                                                                                                                                                  |
| `--settings`                                                                                                    | Die aktuell auf diesem Computer gespeicherten Einstellungen anzeigen.                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `--uninstall`                                                                                                   | Insight Student von diesem Computer deinstallieren.                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `--securityToken`                                                                                               | <p>Das Zugriffstoken definieren.</p><p></p><p>Falls angegeben, kann der Wert als Umgebungsvariable übergeben werden, indem „--env“ am Ende angegeben wird.</p><p> </p><p>Beispiel:</p><p><code>TOKEN="token" ADMINPSWD="password1" sudo insightstudent --securityToken --adminPassword --env</code></p>                                                                                                                                                                                                                          |
| `--adminPassword`                                                                                               | <p>Das Administratorpasswort für Insight festlegen.</p><p></p><p>Falls angegeben, kann der Wert als Umgebungsvariable übergeben werden, indem „--env“ am Ende angegeben wird.</p><p> </p><p>Beispiel:</p><p><code>TOKEN="token" ADMINPSWD="password1" sudo insightstudent --securityToken --adminPassword --env</code></p>                                                                                                                                                                                                       |
| `--connectorAddress "value"`                                                                                    | Bei dem Wert kann es sich um eine beliebige gültige IP-Adresse handeln.                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `--defaultClassId "Class ID"`                                                                                   | <p>Standardmäßige Klassen-ID auf den angegebenen Wert einstellen.</p><p></p><p>Hinweis: Wenn die Klassen-ID ein Leerzeichen enthält, muss die Klassen-ID in Anführungszeichen gesetzt werden.</p><p> </p><p>Beispiel:</p><p><code>--defaultClassId "Home 100"</code></p>                                                                                                                                                                                                                                                         |
| `--menuBarIcon true \| false`                                                                                   | Das Insight Student-Symbol in der Menüleiste ein- oder ausblenden.                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `--changeClassId true \| false`                                                                                 | Aktivieren oder deaktivieren, ob Schüler die Klassen-ID in Insight ändern können.                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `--monitorKeystrokes true \| false`                                                                             | Die Überwachung der Tastenanschläge aktivieren oder deaktivieren.                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `--requirePermission true \| false`                                                                             | <p>Wenn diese Option auf „true“ gesetzt ist, benötigt der Lehrer die Erlaubnis des Schülers, um die Bildschirmaufnahme zu erlauben.</p><p></p><p>Diese Einstellungen finden Sie unter:</p><ul><li>Für macOS Ventura oder neuere Versionen: Systemeinstellungen --> Datenschutz & Sicherheit</li><li>Für macOS Monterey oder ältere Versionen: Systemeinstellungen --> Sicherheit & Datenschutz --> Datenschutz</li></ul><p>Die Einstellungen können mit einer MDM-Lösung oder manuell für jeden Computer vorgenommen werden.</p> |
| `--webHistory true \| false`                                                                                    | <p>Die Verfolgung des Webverlaufs auf Schülerrechnern aktivieren oder deaktivieren.</p><p></p><p>Hinweis: Durch die Aktivierung des Webverlaufs wird auch die Browsererweiterung installiert.</p>                                                                                                                                                                                                                                                                                                                                |
| `--installBrowserExtension`                                                                                     | Wenn Sie diese Option aktivieren, werden die Browsererweiterungen auf dem System des Schülers installiert.                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `--restrictWiFi "value1,value2..." \| --allowAllWiFi`                                                           | Die Möglichkeit für Insight aktivieren, einzuschränken, mit welchen drahtlosen Netzwerken sich das System verbinden kann.                                                                                                                                                                                                                                                                                                                                                                                                        |
| `--classAutoExit 0 \| 30 \| 45 \| 60 \| 75 \| 90`                                                               | <p>Die Möglichkeit für Insight aktivieren, dem Schüler zu erlauben, die Klasse nach einer bestimmten Zeit automatisch zu verlassen. Gültige Werte: 30, 45, 60, 75, 90 Minuten.</p><p>                                                                                                                                                                                                                                                                                                                                            |
| <br>Hinweis: Durch die Angabe von 0 wird die Möglichkeit, die Klasse automatisch zu verlassen, deaktiviert.</p> |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `--allowToExtendClass true \| false`                                                                            | Die Möglichkeit für Insight aktivieren, dem Schüler zu erlauben, die Klasse in 30-Minuten-Intervallen zu verlängern.                                                                                                                                                                                                                                                                                                                                                                                                             |
| `--requireStudentApproval true \| false`                                                                        | Die Möglichkeit für Insight aktivieren, zu erfordern, dass der Schüler seine Zustimmung gibt, wenn der Lehrer eine Anfrage zum Beitritt des Schülers zu einer Klasse sendet.                                                                                                                                                                                                                                                                                                                                                     |
| `--requirePrivacySettings "accessibility,microphone,screenrecording" \| false`                                  | Die Möglichkeit für Insight aktivieren, zu erfordern, dass der Schüler Genehmigungen für Datenschutzeinstellungen aktiviert, wenn der Lehrer eine Anfrage zum Beitritt des Schülers zu einer Klasse sendet.                                                                                                                                                                                                                                                                                                                      |

{% hint style="info" %}
Mit Ausnahme der Befehle `--help`, `--settings` und `--uninstall` können die übrigen Befehle mehrere Optionen gleichzeitig enthalten.
{% endhint %}

Wenn ein Passwort und/oder ein Token angegeben wird, fragt der Befehl nach dem Passwort und bestätigt es. Die für das Passwort und das Bestätigungspasswort eingegebenen Zeichen werden auf dem Terminal nicht angezeigt.&#x20;

Wenn die Befehlszeile mit einem Verwaltungstool eines Drittanbieters ausgeführt wird, muss der vollständige Pfad `/usr/local/bin/insightstudent` angegeben werden und der Befehl muss als „root“-Benutzer ausgeführt werden.&#x20;

Bei Verwendung eines Verwaltungstools eines Drittanbieters sollten Passwort und Zugriffstoken als Umgebungsvariable übergeben werden, indem `--env` am Ende angegeben wird, um die Eingabe des Passworts und des Bestätigungspassworts zu vermeiden. „`sudo`“ sollte nicht verwendet werden, da der Befehl bereits als „root“ ausgeführt wird.

Beispielhafte Befehlszeilenszenarien:

<table data-full-width="false"><thead><tr><th>Terminal.app</th><th>Verwaltungstool eines Drittanbieters (ausgeführt als „root“-Benutzer)</th><th>Beschreibung</th></tr></thead><tbody><tr><td><code>sudo insightstudent --password "admin password" --settings</code></td><td><code>/usr/local/bin/insightstudent --password "admin password" --settings</code></td><td>Druckt die aktuellen Einstellungen.</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>Legt das neue Administratorpasswort fest und gibt das Passwort und die Bestätigung an der Eingabeaufforderung ein.</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>Legt das Zugriffstoken fest und gibt das Token und die Bestätigung an der Eingabeaufforderung ein.</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>Kombiniert mehrere Optionen zum Festlegen des neuen Administratorpassworts, der Standardklassen-ID, des Menüleistensymbols und der IP-Adresse von 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>Deinstalliert Insight Student.</td></tr></tbody></table>

&#x20;