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}"}]}