本指南为ServiceNow管理员提供了分步说明,指导如何在Workflow Studio中访问和使用Endpoint Central spoke操作。了解如何通过六个强大的集成操作自动化端点操作,包括软件部署、设备状态监控和加密密钥检索。每个操作包含详细的输入要求、输出变量和故障排除指南,帮助您构建可靠的自动化工作流。
在Workflow Studio中使用Endpoint Central Spoke操作前,请确保以下事项:
按照以下简单步骤查看并在您的ServiceNow Workflow Studio中使用Endpoint Central Spoke操作:
一旦显示,这些操作可以直接拖动至您的流程和子流程中。
此操作检查目标设备当前是否在线且可访问,然后执行自动化任务。
| 字段 | 类型 | 描述 |
|---|---|---|
| 计算机名称 | 字符串 | 在Endpoint Central Inventory中显示的计算机名称 |
| 域名 | 字符串 | 在Endpoint Central Inventory中显示的域名 |
| 输出变量 | 类型 | 描述 | 可能的值 |
|---|---|---|---|
| 代码 | 字符串 | 操作状态代码 | 0 - 成功 1 - 输入无效 2 - API错误 400 - API调用失败 |
| 消息 | 字符串 | 结果简要说明 | 代码 0: 成功 代码 1: 未找到指定输入的设备。 代码 2: Endpoint Central应用内部错误。请联系Endpoint Central支持并分享应用日志。 代码 400: API调用失败,状态码为 <code_value>。请联系Endpoint Central支持并分享应用日志。 |
| 在线状态 | 字符串 | 设备当前状态 | 在线、离线、未知或错误 |
| 是否在线 | 布尔值 | 简单的真/假状态 | true - 设备在线 false - 设备状态为离线、未知或错误 |
此操作自动在目标端点安装所选软件包。
| 字段 | 类型 | 描述 |
|---|---|---|
| 计算机名称 | 字符串 | 在Endpoint Central Inventory中显示的计算机名称 |
| 域名 | 字符串 | 在Endpoint Central Inventory中显示的域名 |
| Endpoint Central软件包 | 记录列表 | 来自表“x_manen_medc_dcsoftwarepackages”的软件包 这些记录通过计划任务“Sync Software details”自动同步 |
| 输出变量 | 类型 | 描述 | 可能的值 |
|---|---|---|---|
| 代码 | 字符串 | 操作状态代码 | 0 - 成功 1 - 输入无效 2 - API错误 400 - API调用失败 |
| 消息 | 字符串 | 结果简要说明 | 代码 0: 成功
代码 2: Endpoint Central应用内部错误。请联系Endpoint Central支持并分享应用日志。 |
| 集合ID | 字符串 | Endpoint Central为部署创建的唯一ID | 示例:76297000000703059 |
此操作从目标端点移除所选软件包。
| 字段 | 类型 | 描述 |
|---|---|---|
| 计算机名称 | 字符串 | 在Endpoint Central Inventory中显示的计算机名称 |
| 域名 | 字符串 | 在Endpoint Central Inventory中显示的域名 |
| Endpoint Central包 | 记录列表 | 来自表“x_manen_medc_dcsoftwarepackages”的软件包 这些记录通过计划任务“Sync Software details”自动同步 |
| 输出变量 | 类型 | 描述 | 可能的值 |
|---|---|---|---|
| 代码 | 字符串 | 操作状态代码 | 0 - 成功 1 - 输入错误 2 - API错误 400 - API调用失败 |
| 消息 | 字符串 | 结果简要说明 | 代码 0: 成功
代码 2: Endpoint Central应用内部错误。请联系Endpoint Central支持并分享应用日志。 |
| 集合ID | 字符串 | Endpoint Central为部署创建的唯一ID | 示例:76297000000703059 |
此操作检查软件安装或卸载任务的部署状态。
| 字段 | 类型 | 描述 |
|---|---|---|
| 集合ID | 字符串 | 来自“安装软件”或“卸载软件”操作返回的集合ID |
| 输出变量 | 类型 | 描述 | 可能的值 |
|---|---|---|---|
| 代码 | 字符串 | 操作状态代码 | 0 - “成功”或“进行中”或“失败”或“待应用” (详情见下表各状态说明) 1 - 输入无效 2 - API错误 400 - API调用失败 |
| 消息 | 字符串 | 结果简要说明 | 代码 0: 部署成功完成。 代码 1: 未找到指定集合ID的部署。 代码 2: Endpoint Central应用内部错误。请联系Endpoint Central支持并分享应用日志。 代码 400: API调用失败,状态码为 <code_value>。请联系Endpoint Central支持并分享应用日志。 |
| 备注 | 字符串 | 配置状态的附加详情 | 此字段可为空或包含如“参数不正确”的消息。 |
| URL | 字符串 | Endpoint Central控制台中配置的直接链接 | 仅当代码为0时有效 示例:https://endpointcentral.manageengine.in/webclient#/uems/configuration/109832 |
| 状态 | 描述 |
|---|---|
| 进行中 | 软件正在安装或卸载中 |
| 失败 | 安装或卸载过程失败 |
| 待应用 | 配置已准备好,将在下次设备刷新周期执行 |
此操作检索Windows设备的BitLocker恢复密钥。
x_manen_medc.bitlocker must be enabled by your administrator.| 字段 | 类型 | 描述 |
|---|---|---|
| 计算机名称 | 字符串 | 在Endpoint Central Inventory中显示的计算机名称 |
| 域名 | 字符串 | 在Endpoint Central Inventory中显示的域名 |
| 恢复密钥标识符 | 字符串 | 设备BitLocker恢复屏幕(BSOD)上显示的密钥标识符。此值必须由最终用户提供。 也可在Endpoint Central中通过导航至BitLocker Management > Managed Computers并点击设备名称获取。 |
| 输出变量 | 类型 | 描述 | 可能的值 |
|---|---|---|---|
| 代码 | 字符串 | 操作状态代码 | 0 - 成功 1 - 输入错误 2 - API错误 400 - API调用失败 |
| 消息 | 字符串 | 结果简要说明 | 代码 0: 成功
代码 2: Endpoint Central应用内部错误。请联系Endpoint Central支持并分享应用日志。 |
| 加密密钥 | 对象数组 | 包含每个加密驱动器的加密密钥 | 包含数组的JSON对象(可能为空或包含一个或多个密钥) |
示例JSON对象
{
"Encryption Keys": [
{
"drive_letter": "C",
"recover_key": "xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx"
} ] }此操作检索通过MDM管理的macOS设备的FileVault恢复密钥。
The ServiceNow system property x_manen_medc.bitlocker must be enabled by your administrator.
| 字段 | 类型 | 描述 |
|---|---|---|
| 序列号 | 字符串 | 通过MDM管理的macOS设备的序列号 |
| 输出变量 | 类型 | 描述 | 可能的值 |
|---|---|---|---|
| 代码 | 字符串 | 操作状态代码 | 0 - 成功 1 - 输入错误 2 - API错误 400 - API调用失败 |
| 消息 | 字符串 | 结果简要说明 | 代码 0: 成功 代码 1: ServiceNow系统属性 x_manen_medc.bitlocker 必须由管理员启用。 代码 2: Endpoint Central应用内部错误。请联系Endpoint Central支持并分享应用日志。 代码 400: API调用失败,状态码为 <code_value>。请联系Endpoint Central支持并分享应用日志。 |
| RecoveryKey | 字符串 | 实际的 FileVault 恢复密钥 | 格式:A1B2-C3D4-E5F6-G7H8-I9J0-K1L2 |