# Utilitário de linha de comando

A linha de comando do Insight Teacher proporciona aos administradores de rede maior flexibilidade ao gerenciar computadores Insight. Esses comandos podem ser executados com várias ferramentas de gerenciamento empresariais de outros fornecedores, como Apple Remote Desktop, e/ou soluções de gerenciamento central; isso inclui a execução de comandos em Terminal enquanto estiver conectado a um computador remoto via SSH.

| Comando                       | Descrição                                                                                                                                                                                                                                                                                                                   |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--help`                      | Exibir esta ajuda.                                                                                                                                                                                                                                                                                                          |
| `--password`                  | <p>Informe a senha de admin para executar qualquer comando, com exceção de --help.</p><p></p><p>Obs.: Informar a senha de administrador restringe a execução de comandos somente aos usuários autorizados.</p>                                                                                                              |
| `--settings`                  | Exibe as configurações atuais salvas no computador.                                                                                                                                                                                                                                                                         |
| `--uninstall`                 | Desinstalar o Insight Teacher deste computador.                                                                                                                                                                                                                                                                             |
| `--license`                   | Definir a chave de licença.                                                                                                                                                                                                                                                                                                 |
| `--securityToken`             | <p>Definir o token de segurança. </p><p>Se fornecido, o valor pode ser passado como uma variável de ambiente especificando '--env' no final.</p><p>Exemplo:</p><p><code>TOKEN="token" ADMINPSWD="password1" TEACHERPSWD="password2" insightteacher --securityToken --adminPassword --teacherPassword --env</code></p>       |
| `--adminPassword`             | <p>Definir a senha de admin do Insight.</p><p>Se fornecido, o valor pode ser passado como uma variável de ambiente especificando '--env' no final.</p><p>Exemplo:</p><p><code>TOKEN="token" ADMINPSWD="password1" TEACHERPSWD="password2" insightteacher --securityToken --adminPassword --teacherPassword --env</code></p> |
| `--teacherPassword`           | <p>Definir a senha de Professor.</p><p>Se fornecido, o valor pode ser passado como uma variável de ambiente especificando '--env' no final.</p><p>Exemplo:</p><p><code>TOKEN="token" ADMINPSWD="password1" TEACHERPSWD="password2" insightteacher --securityToken --adminPassword --teacherPassword --env</code></p>        |
| `--connectorAddress "value"`  | O valor pode ser qualquer endereço IP válido.                                                                                                                                                                                                                                                                               |
| `--defaultClassId "Class ID"` | <p>Definir o ID de Classe padrão com o valor especificado. </p><p>Obs.: Se incluir um espaço, o ID de Classe deverá ser colocado entre aspas.</p><p>Exemplo:</p><p><code>--defaultClassId "Home 100"</code></p>                                                                                                             |

{% hint style="info" %}
Com exceção dos comandos `--help`, `--settings`, `--uninstsall` e `--license`, os outros comandos podem conter várias opções simultaneamente.
{% endhint %}

Quando houver especificação de senha e/ou token, o comando solicitará a senha e a confirmação. Os caracteres digitados para a senha e a senha de confirmação não serão ecoados no Terminal.&#x20;

Se a linha de comando for executada com uma ferramenta de gerenciamento de terceiros, o caminho completo `/usr/local/bin/insightteacher` precisa ser especificado e o comando deve ser executado como usuário 'root'.&#x20;

Ao usar uma ferramenta de gerenciamento de terceiros, a senha e o token de segurança devem ser passados como variável de ambiente especificando `--env` no final, para evitar a necessidade de digitar a senha e a senha de confirmação. '`sudo`' não deve ser usado porque o comando já está sendo executado como 'root'.

Exemplos de cenários de linha de comando:

| Terminal.app                                                                                                                   | Ferramenta de gerenciamento de terceiros (executada como usuário 'root')                                                                                                | Descrição                                                                                                                                        |
| ------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `sudo insightteacher --password "admin password" --settings`                                                                   | `/usr/local/bin/insightteacher --password "admin password" --settings`                                                                                                  | Imprime as configurações atuais.                                                                                                                 |
| `sudo insightteacher --password "admin password" --license "ABCDEFGH-ABCDEFGH-ABCDEFGH-ABCDEFGH-ABCDEFGH"`                     | `/usr/local/bin/insightteacher --password "admin password" --license "ABCDEFGH-ABCDEFGH-ABCDEFGH-ABCDEFGH-ABCDEFGH"`                                                    | Define a chave de licença.                                                                                                                       |
| `sudo insightteacher --password "admin password" --adminPassword`                                                              | `ADMINPSWD="new password" /usr/local/bin/insightteacher --password "admin password" --adminPassword --env`                                                              | Defina a nova senha de administrador e informe a senha e a confirmação no prompt.                                                                |
| `sudo insightteacher --password "admin password" --securityToken`                                                              | `TOKEN="token" /usr/local/bin/insightteacher --password "admin password" --securityToken --env`                                                                         | Define o token de segurança e digita o token e a confirmação no prompt.                                                                          |
| `sudo insightteacher --password "admin password" --adminPassword --defaultClassId "Home 100" --connectorAddress "192.168.0.1"` | `ADMINPSWD="new password" /usr/local/bin/insightteacher --password "admin password" --adminPassword --defaultClassId "Home 100" --connectorAddress "192.168.0.1" --env` | Combina várias opções para definir nova senha de administrador, ID de classe padrão, ícone de barra de menus e endereço IP do Insight Connector. |
| `sudo insightteacher --password "admin password" --uninstall`                                                                  | `/usr/local/bin/insightteacher --password "admin password" --uninstall`                                                                                                 | Desinstala o Insight Teacher.                                                                                                                    |
