命令行

Insight Student 命令行提高了网络管理员管理 Insight 计算机的灵活性。可使用多个不同的第三方企业管理工具（例如 Apple Remote Desktop）和/或中央管理解决方案运行这些命令；这包括在通过 SSH 连接到远程计算机时在终端执行命令。

命令	说明
--help	显示此帮助。
--password	提供管理员密码才能执行除 --help 以外的任何命令。 注意：提供管理员密码可限制仅授权用户才能执行命令。
--settings	显示保存在此计算机上的当前设置。
--uninstall	从该计算机卸载 Insight Student。
--securityToken	定义安全令牌。 如果提供了该值，则可以在末尾指定 '--env'，将其作为环境变量传递。 示例： TOKEN="token" ADMINPSWD="password1" sudo insightstudent --securityToken --adminPassword --env
--adminPassword	定义 Insight 管理员密码。 如果提供了该值，则可以在末尾指定 '--env'，将其作为环境变量传递。 示例： TOKEN="token" ADMINPSWD="password1" sudo insightstudent --securityToken --adminPassword --env
--connectorAddress "value"	该值可以是任何有效的 IP 地址。
--defaultClassId "Class ID"	将默认班级 ID 设置为指定值。 注意：如果班级 ID 有空格，则班级 ID 必须用引号括起来。 示例： --defaultClassId "Home 100"
--menuBarIcon true | false	在菜单栏中显示或隐藏 Insight Student 图标。
--changeClassId true | false	启用或禁用学生在 Insight 中更改班级 ID。
--monitorKeystrokes true | false	启用或禁用按键监控。
--requirePermission true | false	设置为 true 时，教师需要获得学生的许可才能进行屏幕录制。 这些设置可参见： 对于 macOS Ventura 或更新版本：系统设置 --> 隐私和安全性 对于 macOS Monterey 或更旧版本：系统偏好设置 --> 安全和隐私 --> 隐私 可以使用 MDM 解决方案进行设置，也可以为每台计算机手动设置。
--webHistory true | false	启用或禁用跟踪学生计算机上的网络历史记录。 注意：启用网络历史记录还将安装浏览器扩展程序。
--installBrowserExtension	设置此选项将在学生系统上安装浏览器扩展程序。
--restrictWiFi "value1,value2..." | --allowAllWiFi	启用 Insight 限制系统可连接的无线网络的功能。

除了 --help、--settings 和 --uninstall 命令外，其他命令可以同时包含多个选项。

指定密码和/或令牌后，命令将提示输入密码并确认。输入的密码字符和确认密码字符不会在终端上显示出来。

如果使用第三方管理工具运行命令行，则需要指定完整路径 /usr/local/bin/insightstudent，且须以 'root' 用户身份运行命令。

使用第三方管理工具时，应在末尾指定 --env，将密码和安全令牌作为环境变量传递，以避免输入密码和确认密码。不应使用 'sudo'，因为该命令已经以 'root' 身份运行。

命令行场景示例：

Terminal.app	第三方管理工具（以 'root' 用户身份执行）	说明
sudo insightstudent --password "admin password" --settings	/usr/local/bin/insightstudent --password "admin password" --settings	打印当前设置。
sudo insightstudent --password "admin password" --adminPassword	ADMINPSWD="new password" /usr/local/bin/insightstudent --password "admin password" --adminPassword --env	设置新的管理员密码，根据提示输入密码并确认。
sudo insightstudent --password "admin password" --securityToken	TOKEN="token" /usr/local/bin/insightstudent --password "admin password" --securityToken --env	设置安全令牌，根据提示输入令牌和确认信息。
sudo insightstudent --password "admin password" --adminPassword --defaultClassId "Home 100" --menuBarIcon false --changeClassId true --connectorAddress "192.168.0.1"	ADMINPSWD="new password" /usr/local/bin/insightstudent --password "admin password" --adminPassword --defaultClassId "Home 100" --menuBarIcon false --changeClassId true --connectorAddress "192.168.0.1" --env	结合多个选项设置新的管理员密码、默认班级 ID、菜单栏图标和 Insight Connector IP 地址。
sudo insightstudent --password "admin password" --uninstall	/usr/local/bin/insightstudent --password "admin password" --uninstall	卸载 Insight Student。