TaskRunner 自定程序 - 呼叫FastDesk主动远程控制

1. 说明

1. 任务运行器 TaskRunner 通过自定程序，呼叫远程控制工具 FastDesk ，通过本机远程控制目标主机。
2. 自定程序的运行依赖于远程控制工具 FastDesk ，控制端与被控端都需要安装这个工具。请先下载 FastDesk 客户端，建议将 FastDesk 客户端放置于 D:\FastDesk 目录下，再执行后续的操作。

2. 设计程序

  TaskRunner 的初始示例已包含 呼叫 FastDesk 主动远程控制 自定程序。下面介绍创建自定程序的流程。

1. 点击 自定程序 选项卡，在自定程序界面中点击 新建 按钮，打开新建程序界面。
2. 在新建程序界面，填写要设计的自定程序的基本信息。如下图所示。填写完成点击 保存 按钮。

3. 返回自定程序列表界面，选择刚才创建的 JS005 自定程序，点击菜单栏中的 设计 按钮，打开程序设计器界面。
4. 在程序设计器界面中输入自定程序代码，代码示例如下。完成后，点击 保存 按钮。

{
  var remote;
  remote = UGParams.Values["remote"];
  //结束FastDesk进程
  UGCM.KillTask("FastDesk.exe");
  //发起远程控制，请指定远程控制信息
  if (remote!="")
    ShellExecute("D:\\FastDesk\\FastDesk.exe","Remote="+remote,0)
  else
    ShellExecute("D:\\FastDesk\\FastDesk.exe","Remote=100000006;Z5P8ZD",0);
}

5. 如需要测试效果，可在程序设计器界面中点击 运行 按钮进行测试。可直接控制本机识别码为 100000006 的主机。

  程序中定义的参数说明如下：

名称	说明	是否必填	默认值
remote	要执行远程控制的主机识别码与验证码，中间使用 ; 分隔	是	100000006;Z5P8ZD

3. 调用执行

  设计完成的自定程序可使用以下方式来调用执行。

3.1. RestAPI

  使用浏览器或RestAPI 客户端，访问以下地址，执行自定程序调用。请将 {ip} 修改为运行 TaskRunner 主机的IP地址，{port} 修改为 TaskRunner WebSocket 服务端监听的地址。

http://{ip}:{port}?restapi=script&taskname=JS005

  如需要自行指定其他主机识别码与验证码，参照以下方式执行。请将 {remote} 替换为要邀请远程控制的主机识别码与验证码，主机识别码与验证码之间请使用 ; 分隔。

http://{ip}:{port}?restapi=script&taskname=JS005&remote={remote}

3.2. WebSocket

  使用WebSocket客户端，连接至 TaskRunner 中的 WebSocket 服务端。向 WebSocket 服务端发送以下文本实现自定程序的调用。

{"action":"script","taskname":"JS005"}

  如需要自行指定其他主机识别码与验证码，请在发送的内容中指定 remote 参数，参数格式请参照以下内容。请将 {remote} 替换为要邀请远程控制的主机识别码与验证码，主机识别码与验证码之间请使用 ; 分隔。

{"action":"script","taskname":"JS005","params":[{"name":"remote","value":"{remote}"}]}

3.3. MQTT

  使用 MQTT 客户端，连接至 TaskRunner 连接的 MQTT 服务器。MQTT 客户端向 TaskRunner 订阅的主题发送以下文本实现自定程序的调用。

{"action":"script","taskname":"JS005"}

如需要自行指定其他主机识别码与验证码，请在发送的内容中指定 remote 参数，参数格式请参照以下内容。请将 {remote} 替换为要邀请远程控制的主机识别码与验证码，主机识别码与验证码之间请使用 ; 分隔。

{"action":"script","taskname":"JS005","params":[{"name":"remote","value":"{remote}"}]}