# 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;


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.faronics.com/faronics-insight-docs/german/installation-and-verwaltung/installation/installation-unter-macos/insight-student-installieren/befehlszeilenprogramm.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.