# Utilidad de línea de comandos

La línea de comandos de Insight Student brinda a los administradores de red una mayor flexibilidad para gestionar los equipos con Insight. Estos comandos se pueden ejecutar con diferentes herramientas de gestión empresarial de terceros, como Apple Remote Desktop, y/o soluciones de gestión centralizadas; esto incluye la ejecución de comandos en Terminal mientras se está conectado a un equipo remoto a través de SSH.

| Comando                                               | Descripción                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `--help`                                              | Muestra esta ayuda.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `--password`                                          | <p>Proporcione la contraseña de administrador para ejecutar cualquier comando, excepto --help.</p><p></p><p>Nota: Si se proporciona la contraseña de administrador, la ejecución de comandos se restringirá a los usuarios autorizados.</p>                                                                                                                                                                                                                                                                        |
| `--settings`                                          | Muestra la configuración actual guardada en este equipo.                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `--uninstall`                                         | Desinstale Insight Student de este equipo.                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `--securityToken`                                     | <p>Defina el token de seguridad.</p><p></p><p>Si se suministra, el valor puede pasarse como una variable de entorno especificando '--env' al final.</p><p> </p><p>Ejemplo:</p><p><code>TOKEN="token" ADMINPSWD="password1" sudo insightstudent --securityToken --adminPassword --env</code></p>                                                                                                                                                                                                                    |
| `--adminPassword`                                     | <p>Defina la contraseña de administrador de Insight.</p><p></p><p>Si se suministra, el valor puede pasarse como una variable de entorno especificando '--env' al final.</p><p> </p><p>Ejemplo:</p><p><code>TOKEN="token" ADMINPSWD="password1" sudo insightstudent --securityToken --adminPassword --env</code></p>                                                                                                                                                                                                |
| `--connectorAddress "value"`                          | El valor puede ser cualquier dirección IP válida.                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `--defaultClassId "Class ID"`                         | <p>Establezca el ID de clase predeterminado al valor especificado.</p><p></p><p>Nota: Si el ID de clase contiene un espacio, debe ir entre comillas.</p><p> </p><p>Ejemplo:</p><p><code>--defaultClassId "Home 100"</code></p>                                                                                                                                                                                                                                                                                     |
| `--menuBarIcon true \| false`                         | Muestra u oculta el icono de Insight Student en la barra de menús.                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `--changeClassId true \| false`                       | Habilite o deshabilite la posibilidad de que los estudiantes cambien el ID de clase en Insight.                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `--monitorKeystrokes true \| false`                   | Habilite o deshabilite el control de las pulsaciones de teclas.                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `--requirePermission true \| false`                   | <p>Si se establece en verdadero, el profesor necesitará el permiso del estudiante para permitir la grabación de pantalla.</p><p></p><p>Estos ajustes se pueden encontrar en:</p><ul><li>macOS Ventura o versiones posteriores: Ajustes del sistema --> Privacidad y seguridad</li><li>macOS Monterey o versiones anteriores: Preferencias del sistema --> Seguridad y privacidad y  --> Privacidad</li></ul><p>Estos ajustes se pueden establecer mediante la solución MDM o de forma manual para cada equipo.</p> |
| `--webHistory true \| false`                          | <p>Habilite o deshabilite el seguimiento del historial web en los equipos de estudiante.</p><p></p><p>Nota: Si se habilita el historial web, también se instalará la extensión del navegador.</p>                                                                                                                                                                                                                                                                                                                  |
| `--installBrowserExtension`                           | Al configurar esta opción, se instalarán las extensiones del navegador en los sistemas de los estudiantes.                                                                                                                                                                                                                                                                                                                                                                                                         |
| `--restrictWiFi "value1,value2..." \| --allowAllWiFi` | Habilite la capacidad de Insight de restringir las redes inalámbricas a las que puede conectarse el sistema.                                                                                                                                                                                                                                                                                                                                                                                                       |

{% hint style="info" %}
Excepto los comandos `--help`, `--settings` y `--uninstall`, los demás comandos pueden contener varias opciones simultáneamente.
{% endhint %}

Cuando se especifica la contraseña y/o el token, el comando pedirá la contraseña y la confirmará. Los caracteres introducidos para la contraseña y la confirmación de contraseña no se mostrarán en el terminal.

En el caso de que la línea de comandos se ejecute con una herramienta de gestión de terceros, se deberá especificar la ruta completa `/usr/local/bin/insightstudent` y ejecutar el comando como usuario 'root'.&#x20;

Cuando se utilice una herramienta de gestión de terceros, se deberá pasar la contraseña y el token de seguridad como una variable de entorno especificando `--env` al final, para evitar tener que introducir la contraseña y confirmación de contraseña. No se debe utilizar '`sudo`' porque el comando ya se ejecuta como 'root'.

Ejemplo de escenarios de la línea de comandos:

<table data-full-width="false"><thead><tr><th>Terminal.app</th><th>Herramienta de gestión de terceros (ejecutada como usuario 'root')</th><th>Descripción</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>Imprime la configuración actual.</td></tr><tr><td><code>sudo insightstudent --password "admin password" --adminPassword dent --adminPassword</code></td><td><code>ADMINPSWD="new password" /usr/local/bin/insightstudent --password "admin password" --adminPassword --env</code></td><td>Establece la nueva contraseña de administrador e introduce la contraseña y la confirmación cuando se soliciten.</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>Establece el token de seguridad e introduce el token y la confirmación cuando se soliciten.</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>Combina varias opciones para establecer la contraseña de administrador, el ID de clase predeterminado, el icono de la barra de menús y la dirección IP de 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>Desinstala Insight Student.</td></tr></tbody></table>

&#x20;