分发设置
0 min
使用分发 > 设置页面配置应用程序返回代码映射。 可执行文件和脚本程序包操作可能会在退出时返回正或负数字代码,指示各种结果。 这些返回代码会影响应用程序状态并决定操作是成功、失败还是需要重新启动。
使用自定义返回代码映射来自定义 EXE、MSI 和脚本操作的结果。 例如,Microsoft 的 Robocopy 实用程序有几个表示成功的返回代码。 默认情况下,非零的可执行返回代码表示失败。 您可以为 Robocopy 创建自定义返回代码映射,将这些非零返回代码映射到成功,从而让程序包处理继续。
返回代码作为每个分发的一部分存储在设备上的日志中。 有关日志以及如何访问日志的更多信息,请参阅检测规则和操作日志记录。
除了将数字返回代码存储在日志中之外,您还可以将这些返回代码映射到信息字符串。 这些描述返回代码的字符串也将出现在日志中。
返回码模板类型共有三种:
- 您创建的新模板。
- 现有模板的克隆副本。 要克隆现有模板,请使用该模板右侧的选项菜单 (
)。
- 您无法编辑或删除默认模板,只能将一个模板标记为默认模板。 您可以编辑克隆副本。
这些是默认的返回代码模板。 这些模板中未映射的返回代码的默认行为是失败。
- 系统模板 - 默认 MSI:包含标准化的 MSI 返回代码集。 这些都是为您预先配置的。
- 系统模板 - 默认 EXE:包含一个数字零(表示成功)的返回码映射。
- 系统模板 - 默认 PowerShell:包含两个返回码映射。 数字零表示成功,数字一表示失败。
可以将模板类型 MSI、EXE 和 PowerShell 中的一种标记为默认值。 返回代码映射列表有一列显示哪些模板是默认的。 要更改默认值,请编辑模板并选择该选项。
当您创建支持返回代码模板的程序包操作时,将为您预先选择默认值。 如果您不想使用默认值,可以从其他模板中为该操作类型进行选择。 您所做的模板更改将在下次分发引擎在客户端上运行时生效。
MSI 返回代码模板包括 3010“成功 - 需要重新启动”的返回代码映射。 此结果与成功相同,但在该分发的设备日志中注明,在某个时刻需要重新启动。 该程序包的部署状态还将显示“成功(需要重新启动)”。
创建或编辑返回代码模板
- 选择新建和所需的模板类型,或选择现有模板。 预配置的系统模板为只读。
- 输入模板名称和说明。
- 如果您希望此模板成为所选模板类型(例如 EXE 或 PowerShell)的默认模板,请在设为默认模板下,选择 True。
- 对于未映射的返回代码,选择默认结果。 默认值是失败。 您选择的结果是从返回代码列表中未列出的操作返回的任何返回代码将发生的结果。 例如,如果您选择失败(推荐),则所有不在列表中的返回代码都将导致操作返回失败。 如果您选择成功,则所有其他返回码将返回为成功。
- 指定为您选择的默认未映射返回代码结果显示的默认消息文本。
- 选择 + 添加返回代码。
- 输入整数格式的返回代码数字或数字范围(无小数)、结果(失败或成功),以及您想要与返回代码一起记录的消息文本。 要输入数字范围,请用两个句点分隔数字,例如 15..30。
- 选择保存。
- 对于您想要的每个返回代码,重复步骤 7 和 8。
- 完成后,关闭添加新映射面板并选择保存。
