# コマンドラインユーティリティ

Insight Studentコマンドラインは、ネットワーク管理者によるInsightコンピュータの管理をより柔軟性のあるものにしてくれます。これらのコマンドはApple Remote Desktopなどといった他社製エンタープライズ管理ツールや中央管理ソリューションなどいくつかのツールやソリューションと組み合わせて実行することができます。これにはたとえば、SSH経由によるリモートコンピュータとの接続中に使用できるターミナルでの実行コマンドなどがあります。

| コマンド                                                  | 説明                                                                                                                                                                                                                                                          |
| ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--help`                                              | このアプリを表示します。                                                                                                                                                                                                                                                |
| `--password`                                          | <p>help以外のコマンドを実行するには、管理者パスワードを入力してください。</p><p></p><p>注記：管理者パスワードを提供することで、コマンドの実行を許可されたユーザーのみに制限することができます。</p>                                                                                                                                              |
| `--settings`                                          | このコンピュータに保存されている現在の設定を表示します。                                                                                                                                                                                                                                |
| `--uninstall`                                         | このコンピュータからInsight Studentをアンインストールします。                                                                                                                                                                                                                      |
| `--securityToken`                                     | <p>セキュリティトークン を定義します。</p><p></p><p>提供された場合、値は「--env」と最後に指定することで環境変数として引き渡されます。</p><p> </p><p>例：</p><p><code>TOKEN="token" ADMINPSWD="password1" sudo insightstudent --securityToken --adminPassword --env</code></p>                                        |
| `--adminPassword`                                     | <p>Insight管理者パスワードを定義します。</p><p></p><p>提供された場合、値は「--env」と最後に指定することで環境変数として引き渡されます。</p><p> </p><p>例：</p><p><code>TOKEN="token" ADMINPSWD="password1" sudo insightstudent --securityToken --adminPassword --env</code></p>                                    |
| `--connectorAddress "value"`                          | 値は任意の有効なIPアドレスを使用できます。                                                                                                                                                                                                                                      |
| `--defaultClassId "Class ID"`                         | <p>指定された値に対してデフォルトのクラスIDを設定してください。</p><p></p><p>注記：クラスIDにスペースがある場合、クラスIDを引用符で囲う必要があります。</p><p> </p><p>例：</p><p><code>--defaultClassId "Home 100"</code></p>                                                                                                 |
| `--menuBarIcon true \| false`                         | メニューバーのInsight Studentアイコンを表示または非表示します。                                                                                                                                                                                                                     |
| `--changeClassId true \| false`                       | 生徒がInsightでクラスIDを変更することを有効または無効にします。                                                                                                                                                                                                                        |
| `--monitorKeystrokes true \| false`                   | モニタリングキーストロークを有効または無効にします。                                                                                                                                                                                                                                  |
| `--requirePermission true \| false`                   | <p>TRUEで設定された場合、画面録画の際にTeacherはStudentからの許可を得る必要があります。</p><p></p><p>これらの設定は次から確認できます：</p><ul><li>macOS Ventura以降：システム設定→プライバシーとセキュリティ</li><li>macOS Monterey以降：システム環境設定→セキュリティーとプライバシ→プライバシー</li></ul><p>MDMソリューションを使用して設定する、または各コンピュータで手動で設定することができます。</p> |
| `--webHistory true \| false`                          | <p>Student機のウェブ履歴の追跡を有効または無効にします。 </p><p></p><p>注記：ウェブ履歴を有効にすることでブラウザ拡張機能がインストールされます。</p>                                                                                                                                                                   |
| `--installBrowserExtension`                           | このオプションを設定することでStudentのシステムにブラウザ拡張機能がインストールされます。                                                                                                                                                                                                            |
| `--restrictWiFi "value1,value2..." \| --allowAllWiFi` | Insightのアビリティを有効にしてシステムが接続可能なワイヤレスネットワークを制限します。                                                                                                                                                                                                             |

{% hint style="info" %}
`--help`、`--settings`、`--uninstall`のコマンドを除き、その他のコマンドは同時に複数のオプションを持つ場合があります。
{% endhint %}

パスワード及び/またはトークンが指定されると、コマンドがパスワードの入力を促しますのでそれを確定します。パスワード及び確認用パスワードで入力された文字列は端末でエコーされることはありません。&#x20;

コマンドラインがサードパーティの管理ツールで実行された場合、完全パス`/usr/local/bin/insightstudent`を指定して［root］ユーザーとしてコマンドが実行される必要があります。&#x20;

サードパーティー管理ツールを使用する場合、パスワード及び確認用パスワードの入力を避けるために`--env`を末尾に指定して環境変数としてパスワードとセキュリティトークン を引き渡す必要があります。コマンドはすでに［root］として実行されていますので［sudo］は使用しないでください。

サンプルコマンドラインのシナリオ例：

<table data-full-width="false"><thead><tr><th>Terminal.app</th><th>サードパーティ管理ツール（[root]ユーザーとして実行）</th><th>説明</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>現在の設定を印刷します。</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>新しいadminパスワードを設定し、プロンプトでパスワードと確認を入力してください。</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>セキュリティトークンを設定し、トークンと確認用トークンを入力します。</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>新しい管理者パスワード、デフォルトのクラス ID、メニューバーアイコン、Insight Connector IP アドレスを設定する複数のオプションを組み合わせます。</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>Insight Student をアンインストールします。</td></tr></tbody></table>
