如何在Workflow Studio中访问Endpoint Central Spoke操作?

本指南为ServiceNow管理员提供了分步说明,指导如何在Workflow Studio中访问和使用Endpoint Central spoke操作。了解如何通过六个强大的集成操作自动化端点操作,包括软件部署、设备状态监控和加密密钥检索。每个操作包含详细的输入要求、输出变量和故障排除指南,帮助您构建可靠的自动化工作流。

前提条件

在Workflow Studio中使用Endpoint Central Spoke操作前,请确保以下事项:

  • 在ServiceNow中已安装并激活Endpoint Central App。请参考 文档 从ServiceNow商店安装Endpoint Central App。
  • 您的ServiceNow账户拥有以下角色以执行端点操作。
    • action_designer
    • flow_designer
    • flow_operator
    • x_manen_medc.DCIntegrationUser

步骤:

按照以下简单步骤查看并在您的ServiceNow Workflow Studio中使用Endpoint Central Spoke操作:

  1. 登录您的ServiceNow实例
  2. 导航至: AllProcess AutomationWorkflow Studio
  3. 切换到 Actions 选项卡
  4. Application列上创建筛选器:
    • 条件: contains
    • 值: Endpoint Central
  5. 列表将显示所有可用的Endpoint Central Spoke操作

一旦显示,这些操作可以直接拖动至您的流程和子流程中。

幻灯片 1/5
 

Endpoint Central Spoke操作

1. 查询设备在线状态

此操作检查目标设备当前是否在线且可访问,然后执行自动化任务。

注意
所有输入字段均为必填。

输入

字段类型描述
计算机名称字符串在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 - 设备状态为离线、未知或错误

2. 安装软件

此操作自动在目标端点安装所选软件包。

注意
所有输入字段均为必填。

输入

字段类型描述
计算机名称字符串在Endpoint Central Inventory中显示的计算机名称
域名字符串在Endpoint Central Inventory中显示的域名
Endpoint Central软件包记录列表来自表“x_manen_medc_dcsoftwarepackages”的软件包
这些记录通过计划任务“Sync Software details”自动同步
什么是“Sync Software details”计划任务?
使用Endpoint Central应用,ServiceNow按日程自动同步Endpoint Central的软件包详细信息。管理员可根据组织需要调整同步频率;建议同步周期最短间隔为3小时。

输出

输出变量类型描述可能的值
代码字符串操作状态代码0 - 成功
1 - 输入无效
2 - API错误
400 - API调用失败
消息字符串结果简要说明

代码 0: 成功
代码 1 (以下之一):

  • 未找到指定输入的设备。
  • 所选软件包不可用。

代码 2: Endpoint Central应用内部错误。请联系Endpoint Central支持并分享应用日志。
代码 400: API调用失败,状态码为 <code_value>。请联系Endpoint Central支持并分享应用日志。

集合ID字符串Endpoint Central为部署创建的唯一ID示例:76297000000703059

3. 卸载软件

此操作从目标端点移除所选软件包。

注意
所有输入字段均为必填。

输入

字段类型描述
计算机名称字符串在Endpoint Central Inventory中显示的计算机名称
域名字符串在Endpoint Central Inventory中显示的域名
Endpoint Central包记录列表来自表“x_manen_medc_dcsoftwarepackages”的软件包
这些记录通过计划任务“Sync Software details”自动同步

输出

输出变量类型描述可能的值
代码字符串操作状态代码0 - 成功
1 - 输入错误
2 - API错误
400 - API调用失败
消息字符串结果简要说明

代码 0: 成功
代码 1 (以下之一):

  • 未找到指定输入的设备。
  • 所选软件包不可用。

代码 2: Endpoint Central应用内部错误。请联系Endpoint Central支持并分享应用日志。
代码 400: API调用失败,状态码为 <code_value>。请联系Endpoint Central支持并分享应用日志。

集合ID字符串Endpoint Central为部署创建的唯一ID示例:76297000000703059

4. 查询部署状态

此操作检查软件安装或卸载任务的部署状态。

注意
所有输入字段均为必填。

输入

字段类型描述
集合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

配置状态值

状态描述
进行中软件正在安装或卸载中
失败安装或卸载过程失败
待应用配置已准备好,将在下次设备刷新周期执行

5. 查询Windows加密密钥

此操作检索Windows设备的BitLocker恢复密钥。

注意
所有输入字段均为必填。

输入

前提条件
  • The ServiceNow system property x_manen_medc.bitlocker must be enabled by your administrator.
  • “查询Windows加密密钥”spoke当前仅支持Windows机器。
字段类型描述
计算机名称字符串在Endpoint Central Inventory中显示的计算机名称
域名字符串在Endpoint Central Inventory中显示的域名
恢复密钥标识符字符串设备BitLocker恢复屏幕(BSOD)上显示的密钥标识符。此值必须由最终用户提供。
也可在Endpoint Central中通过导航至BitLocker Management > Managed Computers并点击设备名称获取。

输出

输出变量类型描述可能的值
代码字符串操作状态代码0 - 成功
1 - 输入错误
2 - API错误
400 - API调用失败
消息字符串结果简要说明

代码 0: 成功
代码 1 (以下之一):

  • 未找到指定输入的设备。
  • 此操作仅支持Windows设备。
  • 该设备无可用加密密钥。
  • ServiceNow system property x_manen_medc.bitlocker must be enabled by an administrator.

代码 2: Endpoint Central应用内部错误。请联系Endpoint Central支持并分享应用日志。
代码 400: API调用失败,状态码为 <code_value>。请联系Endpoint Central支持并分享应用日志。

加密密钥对象数组包含每个加密驱动器的加密密钥包含数组的JSON对象(可能为空或包含一个或多个密钥)

示例JSON对象

 
{
 "Encryption Keys": [
 {
 "drive_letter": "C",
 "recover_key": "xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx" 
 } ] }

6. 查询Mac FileVault密钥

此操作检索通过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

相关文档

信赖品牌