所有脚本
适用于:macOS 和 Windows 设备
在管理 > 脚本和文件 > 所有脚本页面中,Ivanti Neurons for MDM 允许具有系统管理角色的用户创建或上传和管理可用于配置并分发到设备的脚本。 您可以将自定义属性与脚本关联,并将结果值分配到配置的设备。 使用审计跟踪查看脚本更改的日志,使用设备详细信息页面查看执行结果。
您可以写入配置设备中任何设置的脚本。 例如,您可以运行脚本:
- 强制设备用户每月更改密码
- 在闲置时间达到 5 分钟后锁定屏幕
- 配置安全 Wi-Fi 网络。
本部分包含以下主题:
- 添加脚本
- 修改脚本
- 测试脚本
添加脚本
您可以创建或上传 bash 脚本(适用于 macOS)和 ps1 脚本(适用于 Windows)的存储库。 此存储库可以在配置中使用,以选择脚本并分发,从而按照配置中的指定计划在设备上执行。
例如,您可以创建要在设备上执行的 Shell 脚本。 如果必要,您可以使用封装程序。 不支持从 Shell 脚本执行二进制文件。
Ivanti 强烈建议您在设备上运行之前测试 Shell 脚本,以确保鲁棒性和质量。 本地运行脚本,并修复产生的任何错误。
程序
- 转到管理员 > 脚本 > 所有脚本。
- 单击 +添加
- 输入脚本的名称和说明。
- 在平台类型下,选择 macOS 或 Windows。
- 选择以下脚本类型之一:
- bash
- zsh
- python
- swift
- ps1
- 选择以 root 身份运行选项,以在设备上以 root 身份运行脚本。 默认情况下,此选项被清除。
- 在脚本编辑器中,您可以在文本框中键入、拖放或复制并粘贴脚本。
- 或者,单击从脚本导入代码,以拖放现有脚本文件,或单击“选择文件”,以浏览并选择要上传到 Ivanti Neurons for MDM 的脚本文件。 这将替换脚本编辑器中的任何现有脚本。 此操作无法撤消。 单击导入。 已上传脚本中的代码将显示在脚本编辑器中。
- (可选)在可用自定义属性部分中,选择一个或多个显示的设备自定义属性,以将其与脚本关联。 自定义属性可用于将结果脚本执行值分配到已配置设备的设备自定义属性。 单击自定义属性的示例代码,以使用脚本中的自定义属性查看示例代码。
- 单击保存。
脚本中的自定义属性名称应小写。 如果在任何脚本中引用自定义属性,该属性无法移除。 在您修改自定义属性(例如名称)时且如果与脚本关联,您应对关联脚本实施相应的更改。
修改脚本
编辑或移除脚本:
- 转到管理员 > 脚本 > 所有脚本。
- 在脚本的操作列中,单击编辑或删除操作的相应图标。
- 请按照屏幕中的指示,以完成操作。
在脚本(内容、名称、描述)更改时,与该脚本关联的所有配置会再分发到设备。
使用脚本变量(适用于 Windows 和 macOS)
在脚本存储库中定义和存储脚本输入,例如环境和替换变量。 在 Mobile@Work for macOS 脚本配置或 Ivanti Bridge for Windows 脚本和操作配置中,根据链接的脚本,相关脚本变量将根据需要可供使用。 对于 macOS,此功能需要 Mobile@Work for macOS 1.71.0 到 Ivanti Neurons for MDM 支持的最新版本。 对于 Windows,此功能需要 Ivanti Bridge。
每次运行脚本时,使用变量以不同的值运行脚本。 例如,管理员可以创建一个脚本,使用 $ 环境变量作为脚本变量,并将其与 Mobile@Work for macOS 脚本配置或 Windows 配置相关联。 当配置已分发并安装在每个用户设备上时,Ivanti Neurons for MDM 会为每个设备发送不同的注册用户电子邮件地址,以采取特定措施。 Ivanti Neurons for MDM 管理门户支持自定义变量。
若要添加脚本变量:
- 转到管理员 > 脚本 > 所有脚本。
- 在脚本输入部分,单击 + 添加。
- 在“添加脚本输入 - 环境变量”弹出页面中,输入以下详细信息:
- 要显示的标签 - 此文本将作为标签显示在 Mobile@Work for macOS 脚本配置页面中。 例如,输入 OS 文件夹,输入 Apache 编号等。
- 环境变量名称 - 例如,JAVA_HOME、OS_VERSION 等。 在将配置详细信息发送到目标设备时,Ivanti Neurons for MDM 会使用值替代脚本变量,因为这些值会保存在数据库中。
- 环境变量默认值 - 例如,1024、bin/java、$ 等。 输入变量将在管理员上传或编辑的脚本中使用。 另请参见以下备注。
在预览区域,查看环境变量的值将如何在配置页面中显示为脚本输入。
- 单击保存。
这样,只有标签和默认值可用于配置,而不是环境变量名称,从而提供抽象层。
- 字母数字值(例如 1024、bin/java、root@localhost)或系统属性(例如 $)可以作为环境变量的值。
- 在部署期间,环境变量的值可在配置页面上修改或删除。
- 如果未提供环境变量的值,请确保在脚本部署期间提供值。 否则,空值将传递到脚本。
- 在设备上分发并安装脚本配置后,在管理 > 脚本和文件 > 所有脚本页面中编辑环境变量不会影响与脚本关联的现有配置。 另请参见 Mobile@Work for macOS 脚本配置。 对于 Windows,请参阅 Ivanti Bridge for Windows 脚本和操作配置。
编辑脚本变量
要修改脚本变量,请单击变量旁边的编辑(铅笔)图标并保存更改。
如果脚本配置引用具有脚本变量的脚本,编辑现有脚本变量的标签也将反映在脚本配置中。 但是:
- 脚本变量默认值的更改不会反映在现有配置中。
- 对于脚本变量默认值的更改,将反映在使用先前脚本创建的任何新配置中。
删除脚本变量
要删除脚本变量,请单击该变量旁边的删除(减号)图标并确认。
新创建的脚本变量或删除现有的脚本变量甚至会反映在现有的配置中。
测试脚本
在设备上测试脚本之前,在调试工具中快速测试运行脚本,无需保存脚本。
先决条件
- 对于 macOS,此功能需要 Mobile@Work for macOS 1.67 到 Ivanti Neurons for MDM 支持的最新发布的版本。
- 对于 Windows,此功能需要 Ivanti Bridge for Windows 脚本和操作配置。
程序
- 转到管理员 > 脚本 > 所有脚本。
- 在脚本编辑器中,添加或导入脚本。
- 如果租户拥有多个空间,选择空间。
- 在测试脚本部分,选择 macOS 或 Windows 作为平台。
- 在查找设备文本字段中,查找并选择测试脚本的设备。 设备可以按序列号、用户名、设备名称和 OS 版本搜索。
- 单击立即测试。 这样,对于环境变量可以进行添加、编辑和删除,并且可在该状态下测试脚本(甚至不保存所做的更改)。 对于 Windows 脚本,屏幕上会出现一个弹出窗口,脚本执行将开始,您可以在一段时间后从设备详细信息日志选项卡中查看状态。
- 单击保存。
- 对于 macOS,等待脚本推送并在设备上执行。
- 在脚本输入(包含环境变量详细信息)、脚本输出和自定义属性部分中,查看已发布的测试结果。 还会显示环境变量的默认值。
验证脚本执行结果
查看脚本执行结果的日志:
- 转到设备。
- 单击设备的名称。
- 单击日志选项卡。
- 在显示脚本执行操作的行中,您可以验证以下信息:
- 详细信息列中的脚本名称。
- 状态列中的脚本执行状态。
- 日期列中的脚本执行日期和时间。
- 脚本执行日志(设备日志 plist)(通过单击操作列中的眼睛图标)。
使用筛选器,以显示脚本执行行。 这些行中的日志包含标准输出的输出 (plist) 和脚本的标准错误。
- 使用筛选器,以显示脚本执行结果处理行。 这些行中的日志包含结果处理方式的详细信息 (plist)。
- 如果脚本没有与其关联的任何自定义属性,没有要处理的任何结果。 已筛选行的列表不显示此类脚本。
- 如果脚本包含与其关联的自定义属性,且如果为预期格式,将映射结果中的自定义属性,状态显示为成功。 在属性选项卡中,您可以验证映射的自定义属性及其值。
- 如果脚本包含与其关联的自定义属性,且如果不是预期格式,将不映射结果中的自定义属性,状态显示为错误。
- 如果结果格式正确,但并非所有关联的自定义属性会在结果中发送,状态将显示为错误。
- 如果脚本变量随脚本一起发送,脚本执行结果处理日志将包括脚本变量的详细信息 (plist)。
相关主题:
