rdp-cli · 0.3.1

rdp-cli 在線命令參考

109 個命令,涵蓋遠端桌面、Linux 應用程式和 Android:連線、觀察、操作、交換檔案及交接控制。

依任務尋找指令

第一次使用 rdp-cli?從安裝和首次連線開始。 →

connect
連線至持續存在的 RDP、VNC 或 Android ADB 工作階段。
screenshot
獲取一致的 PNG 截圖與觀察權杖
click
點擊遠端坐標
type
不改寫剪貼簿直接輸入;Android 支援可列印 ASCII、換行與定位字元,Unicode 貼上請用 android text。
files upload
上傳至工作階段檔案根目錄,並核對完成的傳輸。
files download
從 RDP 交換磁碟或穩定的 Android 檔案快照下載。
watch
打開或激活人類查看器
list
列出可見會話

命令目錄已依 Windows、macOS 和 Linux 的 2026110701 組建核對。請用 --version 和 --help-json 核對已安裝檔案。

觀察、操作、驗證

USER、SESSION、OBSERVATION、X 和 Y 均為佔位符。通過標準輸入提供密碼後關閉輸入流;--password-stdin 不會顯示交互式密碼提示。保存 data.session,讀取 before.png,從圖中選取坐標,再檢查 after.png。輸入已發送不等於任務已完成。

rdp-cli connect --host desktop.example.net --user USER --password-stdin
rdp-cli screenshot --session SESSION --out before.png
rdp-cli click --session SESSION --desktop --x X --y Y --observation OBSERVATION
rdp-cli screenshot --session SESSION --out after.png

--version 顯示版本與構建能力;--help-json 返回機器可讀目錄;COMMAND --help 可離線查看該命令的完整參數說明,不會啓動會話。

rdp-cli --version
rdp-cli --help-json
rdp-cli connect --help

JSON 與通用參數

普通命令在 stdout 輸出一個 UTF-8 JSON 對象:成功為 ok: true 與 data,失敗為 ok: false 與 error。stderr 僅供診斷;退出碼 0 表示成功,1 表示運行失敗,2 表示命令或參數錯誤。

幫助輸出純文本。events --follow 流式輸出 NDJSON;普通 events 返回一個 JSON 結果,其中含 data.events 與 data.ndjson。 Windows PowerShell 5.1 處理非 ASCII 文本時,應將 [Console]::OutputEncoding 與 $OutputEncoding 都設為 UTF-8。

data.session
保存 connect 返回的會話 ID,後續命令使用同一值。
data.observation
輸入須使用截圖返回的觀察權杖;重連、控制權或佈局變化後重新截圖。
data.capabilities
先檢查協商能力,再決定是否使用檔案、音訊、剪貼簿或顯示器操作。
data.state / data.remote_outcome
queued、sent、partial、unknown、cancelled、failed 表示輸入進度。remote_outcome: not_confirmed 仍需查看遠端結果。
data.transfer_id
把傳輸 ID 交給 files status 或 files cancel;等待終態並檢查已完成檔案的摘要。
error.code / error.message / error.retryable
使用穩定錯誤碼決策,消息提供上下文;retryable 只是提示,不能據此盲目重復操作。
data.activity
目前或最近的活動、Agent/人工來源、經過時間與傳輸進度。不含輸入或剪貼簿內容,也不代表遠端工作已完成。

所有命令支持 --request-id 與 --timeout-ms。只有在保留窗口內,以完全相同的命令和參數重試時才復用請求 ID。本地超時不能證明輸入未發送,應先查詢 operations status。

--request-id ID · --timeout-ms MILLISECONDS

會話

RDP/VNC 的 connect 需要 --host,RDP 還需要 --user;預設連接埠分別為 3389 和 5900。需要驗證時選擇一種密碼來源;--vnc-security none 不使用密碼。ADB 改用 --device 和 --transport,Wi-Fi 可明確指定位址與連線連接埠。--domain、--size 和 --layout 僅用於 RDP。reconnect 後維持暫停;disconnect 不登出遠端使用者。

rdp-cli connect#

連線至持續存在的 RDP、VNC 或 Android ADB 工作階段。

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--profile

已儲存的連線設定

文本可選
--host

RDP/VNC 位址,或明確指定的 Android Wi-Fi 端點。

文本可選
--protocol

協定為 RDP、VNC、ADB 或 X11;各自使用明確目標及驗證規則。

枚舉
rdp | vnc | adb | x11
預設值: rdp
可選
--mode

X11 模式:既有桌面或轉發應用程式。

枚舉
desktop | application
可選
--display

既有且獲授權的 X11 display,僅限桌面模式。

文本可選
--xauthority

既有遠端 Xauthority 檔案的絕對路徑,僅限桌面模式。

文本可選
--ssh-known-hosts

本機 OpenSSH 格式的已知主機檔案,不需要外部 SSH 程式。

路徑可選
--ssh-key

本機 SSH 私鑰;密碼輸入用於提供其口令。

路徑可選
--ssh-host-key

獨立核實的 SSH SHA256 指紋。

文本可選
--linux-file-root

獲授權的 SFTP 絕對目錄;預設於 SSH 使用者家目錄建立私有工作階段目錄。

文本可選
--application

已安裝遠端 X11 應用程式的絕對路徑。

文本可選
--app-args

JSON 格式的字面參數陣列,不經 shell 解譯。

文本可選
--device

android devices 傳回的明確裝置 ID;ADB 必填。

文本可選
--transport

明確選擇 USB 或 Wi-Fi;ADB 必填。

枚舉
usb | wifi
可選
--device-auth-ref

重用明確儲存在系統憑證庫中的身分。

文本可選
--save-device-auth

明確將獲授權身分儲存至此本機參照。

文本可選
--device-file-root

獲授權的 Android 目錄,預設 /sdcard/Download/rdp-cli/<session-id>。

路徑可選
--android-display

手機主螢幕或工作階段專用虛擬螢幕

枚舉
main | virtual
可選
--android-virtual-size

虛擬螢幕尺寸,寬x高

文本可選
--android-virtual-dpi

虛擬螢幕 DPI

正整數可選
--android-start-app

在新虛擬螢幕啟動的已安裝應用程式

文本可選
--vnc-security

VNC 認證方式;無認證需顯式選擇 none

枚舉
vnc-auth | none | x509-plain | ard
可選
--vnc-tls-pin

VNC X509Plain 已核實的葉憑證 SHA256 指紋。

文本可選
--port

TCP 連接埠:RDP 為 3389,VNC 為 5900。android pair 使用手機顯示的配對連接埠;ADB connect 使用獨立的連線連接埠。

正整數
預設值: RDP 3389 · VNC 5900
可選
--user

本地或域賬號;RDP 必填

文本可選
--domain

Windows 域

文本可選
--password

密碼;經典 VNC 只用前 8 個 UTF-8 位元組

文本可選
--password-stdin

從標準輸入讀取密碼直到 EOF

開關可選
--cert-policy

RDP 伺服器證書策略,與 Web HTTPS 無關

枚舉
ignore | strict
預設值: ignore
可選
--tls-profile

modern 要求 TLS 1.2 和現代密碼演算法;legacy 僅為本工作階段允許舊簽章/演算法(包括 TLS 1.2 的 SHA-1)及 TLS 1.0,不強制降級

枚舉
modern | legacy
預設值: modern
可選
--credential-ref

已有的平台憑據存儲引用

文本可選
--audio-mode

RDP 聲音去向:檢視器(client)、受控電腦(host)或關閉(off)

枚舉
client | host | off
預設值: client
可選
--microphone-mode

RDP 麥克風來源:已授權檢視器(client)、受控電腦上相符的輔助程式(host)或關閉(off)

枚舉
client | host | off
預設值: client
可選
--save-credential

成功連接後以此引用保存密碼

文本可選
--name

可讀的會話名稱

文本可選
--size

桌面尺寸 WIDTHxHEIGHT

文本可選
--layout

顯示器佈局 JSON 或 @file

文本可選
--connect-timeout-ms

連接截止時間,單位毫秒

正整數可選
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli connect --help

rdp-cli list#

列出可見會話

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli list --help

rdp-cli status#

查詢一致的會話狀態

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli status --help

rdp-cli reconnect#

重連未關閉的會話並保持暫停

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli reconnect --help

rdp-cli disconnect#

關閉遠端工作階段;RDP 不會登出 Windows 使用者。

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli disconnect --help

查看器與桌面狀態

watch 為人打開只讀查看器,Agent 命令無需先打開窗口。--viewer 可選 window 或 web。presence show/hide 控制本機狀態入口;--floating 添加懸浮控件,--panel 打開 macOS 或 Linux 會話面板。關閉只讀窗口不會斷開連接。

rdp-cli watch#

打開或激活人類查看器

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--viewer

查看器實現

枚舉
window | web
預設值: window
可選
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli watch --help

rdp-cli presence show#

顯示桌面會話狀態入口

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--floating

同時顯示可選的懸浮會話控件

開關可選
--panel

同時打開 macOS 或 Linux 會話面板

開關可選
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli presence show --help

rdp-cli presence hide#

隱藏狀態入口但保留會話

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli presence hide --help

控制與交接

pause 指定 --session 或 --all,並撤銷人類控制;resume 將暫停會話交回 Agent。control take 需要已連接的 viewer ID;release 可指定該查看者或目標 Agent。尊重人類暫停,交還後重新截圖。

rdp-cli pause#

暫停普通輸入並撤銷人類控制

必須二選一:--session SESSION 或 --all。

命令參數
參數格式與取值要求
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli pause --help

rdp-cli resume#

將暫停會話交還 Agent

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli resume --help

rdp-cli control take#

把控制權交給已連接的查看器

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--viewer-id

已連接查看器 ID;適用時必須是控制租約持有者

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli control take --help

rdp-cli control release#

將控制權交還 Agent

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--viewer-id

已連接查看器 ID;適用時必須是控制租約持有者

文本可選
--agent-id

接收控制的 Agent

文本可選
--to-agent

目標 Agent 身分

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli control release --help

截圖、輸入與剪貼簿

screenshot 通過 --out 保存 PNG,可用 --monitor 選屏。坐標輸入需要 observation,使用屏內坐標或 --desktop 桌面坐標,不能混用。drag 使用起止坐標及可選螢幕 ID。type 的 --text 與 --text-stdin 二選一;--sensitive 只改變提示,不遮擋截圖。key 使用 --keys 或 --key 配合 --state。剪貼簿寫入會明確替換遠端文本。

rdp-cli screenshot#

獲取一致的 PNG 截圖與觀察權杖

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--monitor

顯示器 ID;screenshot 還可使用 all

文本
預設值: all
可選
--region

遠端像素區域 x,y,width,height

文本可選
--max-width

影像最大寬度,不改變輸入座標

正整數可選
--since

先前截圖的比較參照

文本可選
--out

目標 PNG 檔案

路徑可選
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli screenshot --help

rdp-cli move#

移動遠端指針

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--x

遠端 x 坐標

整數必填
--y

遠端 y 坐標

整數必填
--monitor

顯示器 ID;screenshot 還可使用 all

文本可選
--desktop

使用桌面坐標而非顯示器內部坐標

開關可選
--observation

最新截圖返回的觀察權杖

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli move --help

rdp-cli click#

點擊遠端坐標

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--x

遠端 x 坐標

整數必填
--y

遠端 y 坐標

整數必填
--button

滑鼠按鍵

枚舉
left | right | middle
預設值: left
可選
--count

點擊次數

正整數可選
--monitor

顯示器 ID;screenshot 還可使用 all

文本可選
--desktop

使用桌面坐標而非顯示器內部坐標

開關可選
--observation

最新截圖返回的觀察權杖

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli click --help

rdp-cli scroll#

在遠端坐標滾動

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--x

遠端 x 坐標

整數必填
--y

遠端 y 坐標

整數必填
--delta-x

帶正負號的水平滾輪單位

整數可選
--delta-y

帶正負號的垂直滾輪單位

整數可選
--monitor

顯示器 ID;screenshot 還可使用 all

文本可選
--desktop

使用桌面坐標而非顯示器內部坐標

開關可選
--observation

最新截圖返回的觀察權杖

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli scroll --help

rdp-cli drag#

在遠端坐標之間拖動

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--from-x

起點 x 坐標

整數必填
--from-y

起點 y 坐標

整數必填
--to-x

終點 x 坐標

整數必填
--to-y

終點 y 坐標

整數必填
--from-monitor

起點顯示器 ID

文本可選
--to-monitor

終點顯示器 ID

文本可選
--desktop

使用桌面坐標而非顯示器內部坐標

開關可選
--observation

最新截圖返回的觀察權杖

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli drag --help

rdp-cli type#

不改寫剪貼簿直接輸入;Android 支援可列印 ASCII、換行與定位字元,Unicode 貼上請用 android text。

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--text

Unicode 輸入或剪貼簿文字

文本可選
--text-stdin

從標準輸入讀取輸入或剪貼簿文字直到 EOF

開關可選
--sensitive

在可觀察事件中隱藏文字;截圖仍包含桌面內容

開關可選
--observation

最新截圖返回的觀察權杖

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli type --help

rdp-cli key#

發送組合鍵或按鍵狀態

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--keys

組合鍵,例如 CTRL+S

文本可選
--key

按鍵名稱;android key 使用其列出的系統鍵。

文本可選
--state

按所列值指定按鍵狀態或音訊靜音狀態

枚舉
down | up
可選
--observation

最新截圖返回的觀察權杖

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli key --help

rdp-cli clipboard get#

讀取遠端文本剪貼簿

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli clipboard get --help

rdp-cli clipboard set#

寫入遠端文本剪貼簿

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--text

Unicode 輸入或剪貼簿文字

文本可選
--text-stdin

從標準輸入讀取輸入或剪貼簿文字直到 EOF

開關可選
--observation

最新截圖返回的觀察權杖

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli clipboard set --help

檔案

--path 相對於授權的 RDP 交換磁碟、Android 目錄或 X11 SFTP 根目錄;--local 是本機檔案或資料夾。替換檔案須帶 --overwrite。檢查傳輸狀態與完成摘要,結果未知時不要重複操作。

rdp-cli files list#

列出 RDP 交換磁碟或獲授權 Android 目錄中的檔案。

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--path

相對於 RDP 交換磁碟或獲授權 Android 目錄的路徑。

路徑可選
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli files list --help

rdp-cli files upload#

上傳至工作階段檔案根目錄,並核對完成的傳輸。

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--local

上傳的本地檔案/目錄或下載的本地目標

路徑必填
--path

相對於 RDP 交換磁碟或獲授權 Android 目錄的路徑。

路徑必填
--overwrite

允許替換已有目標

開關可選
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli files upload --help

rdp-cli files download#

從 RDP 交換磁碟或穩定的 Android 檔案快照下載。

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--path

相對於 RDP 交換磁碟或獲授權 Android 目錄的路徑。

路徑必填
--local

上傳的本地檔案/目錄或下載的本地目標

路徑必填
--overwrite

允許替換已有目標

開關可選
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli files download --help

rdp-cli files status#

查詢一個或全部檔案傳輸

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--transfer-id

傳輸 ID;files status 省略時列出會話傳輸

文本可選
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli files status --help

rdp-cli files cancel#

取消檔案傳輸

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--transfer-id

傳輸 ID;files status 省略時列出會話傳輸

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli files cancel --help

rdp-cli files cleanup#

刪除指定交換內容

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--path

相對於 RDP 交換磁碟或獲授權 Android 目錄的路徑。

路徑必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli files cleanup --help

聲音與麥克風

RDP 的 --audio-mode client|host|off 和 --microphone-mode client|host|off 分別選擇新連線的播放目的地及麥克風來源,不會開始錄音。host 方向需要受控 Windows 上的對應服務,在 Linux 上不可用。X11/VNC 沒有本產品音訊通道。

rdp-cli host-microphone install#

在這台 Windows 電腦上安裝並啟動受控電腦麥克風輔助程式

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli host-microphone install --help

rdp-cli host-microphone status#

檢查這台 Windows 電腦是否已安裝受控電腦麥克風輔助程式

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli host-microphone status --help

rdp-cli host-microphone uninstall#

停止並移除這台 Windows 電腦上的受控電腦麥克風輔助程式

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli host-microphone uninstall --help

rdp-cli audio status#

查詢音訊能力與來源

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli audio status --help

rdp-cli audio mute#

為一個查看器靜音或解除靜音

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--viewer-id

已連接查看器 ID;適用時必須是控制租約持有者

文本必填
--state

按所列值指定按鍵狀態或音訊靜音狀態

枚舉
on | off
必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli audio mute --help

rdp-cli audio volume#

設置一個查看器的播放音量

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--viewer-id

已連接查看器 ID;適用時必須是控制租約持有者

文本必填
--percent

播放增益百分比

正整數必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli audio volume --help

rdp-cli audio microphone#

查詢或停止當前麥克風

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--action

查詢或停止麥克風;開啓需要人工查看器

枚舉
status | stop
預設值: status
可選
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli audio microphone --help

rdp-cli audio android#

明確選擇手機播放、手機麥克風或關閉。

需要目前支援 Android 的下載版:Windows(x64 / x86 / ARM64)、macOS(Apple silicon / Intel)或 Linux(x86_64 / ARM64)。

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--source

手機音源:off 關閉,output 需要系統分享授權,microphone 需要控制權及新的 --observation。

枚舉
off | output | microphone
必填
--observation

最新截圖返回的觀察權杖

文本可選
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli audio android --help

rdp-cli audio poll#

讀取數量受限的最近 PCM 音訊樣本。

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--after

傳回此序號之後的事件或 PCM 樣本。

正整數可選
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli audio poll --help

顯示器

monitors 返回協商佈局。monitors set 接受佈局 JSON 或 @file;--allow-reconnect 允許在不能動態調整時重連。按返回佈局重新截圖後再輸入。VNC 可報告幀緩衝區,但不接受主動佈局變更。

rdp-cli monitors#

查詢協商後的顯示器佈局

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli monitors --help

rdp-cli monitors set#

更改顯示器佈局

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--layout

顯示器佈局 JSON 或 @file

文本必填
--allow-reconnect

不支持動態佈局時允許重連

開關可選
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli monitors set --help

瀏覽器訪問

web start 配置監聽地址與 TLS 證書/私鑰或受信代理,--ice-server 可重復。非回環訪問限局域網/VPN,並需要 HTTPS 和授權。access grant 必須指定可重復的 --permission 與以秒計的 --expires-in。權限含 session.observe/control、clipboard.read/write、files.read/write、audio.listen/send。撤銷授權會關閉其流。

rdp-cli web start#

啓動內嵌授權 Web 服務

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--listen

監聽地址

文本可選
--tls-cert

HTTPS 證書檔案

路徑可選
--tls-key

HTTPS 私鑰檔案

路徑可選
--trust-proxy

信任已配置的代理

開關可選
--ice-server

WebRTC 使用的 STUN/TURN URL

文本可選 · 可重復
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli web start --help

rdp-cli web status#

查詢 Web 服務狀態

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli web status --help

rdp-cli web stop#

停止瀏覽器存取,保留遠端工作階段連線。

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli web stop --help

rdp-cli access grant#

創建有限範圍的 Web 授權

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--permission

授予此訪問權杖的權限

文本必填 · 可重復
--expires-in

授權有效期,單位秒

正整數必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli access grant --help

rdp-cli access list#

列出 Web 授權

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli access list --help

rdp-cli access revoke#

撤銷授權及其流

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--grant-id

授權標識符

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli access revoke --help

Android 手機

明確指定裝置 ID 和 usb 或 wifi 傳輸方式。發現裝置不等於授權;配對使用手機的配對連接埠,連線使用另一個連線連接埠。配對碼透過標準輸入傳送並結束輸入串流。僅在明確要求時儲存身分。輸入與應用程式變更需要控制權及最新觀察;結果不確定時先查詢應用程式工作,不盲目重試。

rdp-cli android devices#

發現 USB 與 Wi-Fi 候選裝置,不自動授權。

需要目前支援 Android 的下載版:Windows(x64 / x86 / ARM64)、macOS(Apple silicon / Intel)或 Linux(x86_64 / ARM64)。

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli android devices --help

rdp-cli android pair#

透過配對連接埠及標準輸入中的配對碼完成無線配對。

需要目前支援 Android 的下載版:Windows(x64 / x86 / ARM64)、macOS(Apple silicon / Intel)或 Linux(x86_64 / ARM64)。

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--host

RDP/VNC 位址,或明確指定的 Android Wi-Fi 端點。

文本必填
--port

TCP 連接埠:RDP 為 3389,VNC 為 5900。android pair 使用手機顯示的配對連接埠;ADB connect 使用獨立的連線連接埠。

正整數必填
--code-stdin

從標準輸入讀取六位配對碼。

開關可選
--device-auth-ref

重用明確儲存在系統憑證庫中的身分。

文本可選
--save-device-auth

明確將獲授權身分儲存至此本機參照。

文本可選
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli android pair --help

rdp-cli android forget#

刪除一個本機儲存的 Android 身分;手機端撤銷另行處理。

需要目前支援 Android 的下載版:Windows(x64 / x86 / ARM64)、macOS(Apple silicon / Intel)或 Linux(x86_64 / ARM64)。

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--device-auth-ref

重用明確儲存在系統憑證庫中的身分。

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli android forget --help

rdp-cli android apps list#

列出已安裝的 Android 套件。

需要目前支援 Android 的下載版:Windows(x64 / x86 / ARM64)、macOS(Apple silicon / Intel)或 Linux(x86_64 / ARM64)。

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli android apps list --help

rdp-cli android apps info#

查詢應用程式實際安裝路徑。

需要目前支援 Android 的下載版:Windows(x64 / x86 / ARM64)、macOS(Apple silicon / Intel)或 Linux(x86_64 / ARM64)。

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--package

Android 套件名稱。

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli android apps info --help

rdp-cli android apps install#

提交授權目錄中的單一 APK,並追蹤工作結果。

需要目前支援 Android 的下載版:Windows(x64 / x86 / ARM64)、macOS(Apple silicon / Intel)或 Linux(x86_64 / ARM64)。

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--path

相對於 RDP 交換磁碟或獲授權 Android 目錄的路徑。

路徑必填
--replace

明確取代已安裝應用程式。

開關可選
--observation

最新截圖返回的觀察權杖

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli android apps install --help

rdp-cli android apps launch#

啟動指定應用程式並核對畫面。

需要目前支援 Android 的下載版:Windows(x64 / x86 / ARM64)、macOS(Apple silicon / Intel)或 Linux(x86_64 / ARM64)。

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--package

Android 套件名稱。

文本必填
--activity

活動類別名稱;未指定時尋找啟動入口。

文本可選
--observation

最新截圖返回的觀察權杖

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli android apps launch --help

rdp-cli android apps stop#

強制停止明確指定的 Android 套件。

需要目前支援 Android 的下載版:Windows(x64 / x86 / ARM64)、macOS(Apple silicon / Intel)或 Linux(x86_64 / ARM64)。

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--package

Android 套件名稱。

文本必填
--observation

最新截圖返回的觀察權杖

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli android apps stop --help

rdp-cli android apps status#

查詢應用程式工作,不重複執行原操作。

需要目前支援 Android 的下載版:Windows(x64 / x86 / ARM64)、macOS(Apple silicon / Intel)或 Linux(x86_64 / ARM64)。

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--job

安裝、啟動或停止傳回的工作 ID。

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli android apps status --help

rdp-cli android touch#

依據最新截圖傳送完整的定時觸控手勢。

需要目前支援 Android 的下載版:Windows(x64 / x86 / ARM64)、macOS(Apple silicon / Intel)或 Linux(x86_64 / ARM64)。

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--kind

觸控手勢類型。

枚舉
tap | double-tap | long-press | swipe | drag | pinch | gesture
必填
--x

遠端 x 坐標

整數可選
--y

遠端 y 坐標

整數可選
--to-x

終點 x 坐標

整數可選
--to-y

終點 y 坐標

整數可選
--second-x

第二根手指起點 X 座標。

整數可選
--second-y

第二根手指起點 Y 座標。

整數可選
--second-to-x

第二根手指終點 X 座標。

整數可選
--second-to-y

第二根手指終點 Y 座標。

整數可選
--duration-ms

手勢時間為 1–10000 毫秒;拖曳額外保持 400 毫秒。

正整數可選
--events-stdin

從標準輸入讀取 JSON 陣列 [{at_ms,contact,phase,x,y}, …];僅限 --kind gesture。

開關可選
--observation

最新截圖返回的觀察權杖

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli android touch --help

rdp-cli android key#

持有控制權並使用最新觀察按下 Android 系統鍵。

需要目前支援 Android 的下載版:Windows(x64 / x86 / ARM64)、macOS(Apple silicon / Intel)或 Linux(x86_64 / ARM64)。

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--key

按鍵名稱;android key 使用其列出的系統鍵。

枚舉
back | home | recent | enter | backspace
必填
--observation

最新截圖返回的觀察權杖

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli android key --help

rdp-cli android text#

明確透過手機剪貼簿貼上 Unicode 文字。

需要目前支援 Android 的下載版:Windows(x64 / x86 / ARM64)、macOS(Apple silicon / Intel)或 Linux(x86_64 / ARM64)。

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--method

明確的文字方式:clipboard 貼上。

枚舉
clipboard
必填
--text

Unicode 輸入或剪貼簿文字

文本可選
--text-stdin

從標準輸入讀取輸入或剪貼簿文字直到 EOF

開關可選
--observation

最新截圖返回的觀察權杖

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli android text --help

Linux 桌面與應用程式

使用 --protocol x11,明確選擇 desktop 或 application 模式並核驗 SSH 身分。SSH 用戶端與應用程式顯示器已內建。既有 Wayland 桌面使用其已設定的 RDP/VNC 端點。X11 沒有音訊或麥克風通道。SFTP 檔案限定於授權目錄,不安裝遠端服務。

rdp-cli linux targets#

探索既有 Linux 顯示及相容端點,不啟動服務。

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--host

RDP/VNC 位址,或明確指定的 Android Wi-Fi 端點。

文本必填
--user

本地或域賬號;RDP 必填

文本必填
--port

TCP 連接埠:RDP 為 3389,VNC 為 5900。android pair 使用手機顯示的配對連接埠;ADB connect 使用獨立的連線連接埠。

正整數
預設值: 22
可選
--ssh-known-hosts

本機 OpenSSH 格式的已知主機檔案,不需要外部 SSH 程式。

路徑可選
--ssh-host-key

獨立核實的 SSH SHA256 指紋。

文本可選
--ssh-key

本機 SSH 私鑰;密碼輸入用於提供其口令。

路徑可選
--password

密碼;經典 VNC 只用前 8 個 UTF-8 位元組

文本可選
--password-stdin

從標準輸入讀取密碼直到 EOF

開關可選
--credential-ref

已有的平台憑據存儲引用

文本可選
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli linux targets --help

rdp-cli linux text#

輸入文字,或明確透過遠端剪貼簿貼上。

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--method

明確的文字方式:clipboard 貼上。

枚舉
clipboard
必填
--keys

組合鍵,例如 CTRL+S

枚舉
CTRL+V | CTRL+SHIFT+V | SHIFT+INSERT
預設值: CTRL+V
可選
--text

Unicode 輸入或剪貼簿文字

文本可選
--text-stdin

從標準輸入讀取輸入或剪貼簿文字直到 EOF

開關可選
--observation

最新截圖返回的觀察權杖

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli linux text --help

rdp-cli linux apps list#

列出本工作階段轉發的 X11 應用程式執行個體。

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli linux apps list --help

rdp-cli linux apps stop#

明確選擇並停止一個應用程式執行個體。

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--instance

linux apps list 傳回的精確執行個體 ID。

文本必填
--observation

最新截圖返回的觀察權杖

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli linux apps stop --help

操作與事件

結果不確定時,operations status 按 operation ID 或原 request ID 查詢,不重新發送輸入。events 讀取事件,--follow 持續訂閱,--after 從游標續讀。sent 後仍須另行驗證應用實際結果。

rdp-cli operations status#

查詢保留的操作結果

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--operation-id

操作標識符

文本可選
--request-id

請求關聯/冪等 ID;operations status 用它查詢原請求

文本可選
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli operations status --help

rdp-cli events#

讀取或持續訂閱事件

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--follow

持續跟隨新事件

開關可選
--after

傳回此序號之後的事件或 PCM 樣本。

文本可選
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli events --help

信任、憑據與安裝

trust 為嚴格證書模式保存精確 RDP 目標與指紋;credentials remove 僅刪除指定產品憑據。macOS 和 Linux 的 install-cli/uninstall-cli 管理命令入口,--prefix 選擇安裝位置;Windows 直接運行下載的程序。presence show --panel 可在 macOS 和 Linux 打開會話面板。licenses 輸出第三方版本與許可聲明。

rdp-cli trust list#

列出 RDP 證書信任記錄

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli trust list --help

rdp-cli trust add#

信任指定目標的證書指紋

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--target

RDP 信任目標

文本必填
--fingerprint

證書指紋

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli trust add --help

rdp-cli trust remove#

刪除指定目標的信任記錄

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--target

RDP 信任目標

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli trust remove --help

rdp-cli credentials remove#

刪除指定產品憑據

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--reference

要移除的憑據存儲引用

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli credentials remove --help

rdp-cli install-cli#

在 macOS 或 Linux 安裝命令入口

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--prefix

用戶可控的安裝前綴

路徑可選
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli install-cli --help

rdp-cli uninstall-cli#

移除 rdp-cli 創建的命令入口

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli uninstall-cli --help

rdp-cli licenses#

查看第三方版本與許可聲明

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli licenses --help

Agent 任務與自動化

新增區域截圖與畫面比較、條件等待、批次操作、持久任務報告、多 Agent 協作、MCP 與連線設定及診斷,以及 Android 虛擬螢幕。

rdp-cli tasks create#

建立持久任務

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--title

任務標題

文本必填
--session

明確的會話 ID

文本可選
--record-frames

明確儲存截圖關鍵影格

開關可選
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli tasks create --help

rdp-cli tasks list#

列出有權存取的任務

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli tasks list --help

rdp-cli tasks status#

查看任務進度與歷史

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--task

持久任務 ID

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli tasks status --help

rdp-cli tasks attach#

為任務關聯已授權工作階段

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--task

持久任務 ID

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli tasks attach --help

rdp-cli tasks checkpoint#

儲存檢查點,不重播輸入

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--task

持久任務 ID

文本必填
--note

不含秘密的進度備註

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli tasks checkpoint --help

rdp-cli tasks new-run#

從檢查點開始新一輪任務

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--task

持久任務 ID

文本必填
--from-checkpoint

現有檢查點 ID

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli tasks new-run --help

rdp-cli tasks grants list#

列出任務權限

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--task

持久任務 ID

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli tasks grants list --help

rdp-cli tasks grants grant#

授予任務權限

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--task

持久任務 ID

文本必填
--to-agent

目標 Agent 身分

文本必填
--permission

授予此訪問權杖的權限

文本必填 · 可重復
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli tasks grants grant --help

rdp-cli tasks grants revoke#

撤銷後續任務存取

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--task

持久任務 ID

文本必填
--to-agent

目標 Agent 身分

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli tasks grants revoke --help

rdp-cli tasks evidence#

儲存選定的本機證據

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--task

持久任務 ID

文本必填
--file

本機證據檔,最多 4 MiB

路徑必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli tasks evidence --help

rdp-cli tasks export#

匯出離線 JSON 或 HTML 報告

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--task

持久任務 ID

文本必填
--out

目標 PNG 檔案

路徑必填
--format

輸出格式,見本命令允許值

枚舉
json | html
預設值: json
可選
--include-evidence

包含明確儲存的證據

開關可選
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli tasks export --help

rdp-cli tasks purge#

清理選定的本機任務歷史

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--task

持久任務 ID

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli tasks purge --help

rdp-cli agents register#

註冊 Agent 身分

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--name

可讀的會話名稱

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli agents register --help

rdp-cli agents list#

列出 Agent 身分,不顯示金鑰

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli agents list --help

rdp-cli agents show#

查看 Agent 身分與權限

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--id

目標身分

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli agents show --help

rdp-cli agents revoke#

撤銷 Agent 身分及控制權

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--id

目標身分

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli agents revoke --help

rdp-cli agents grant#

授權 Agent 存取工作階段

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--id

目標身分

文本必填
--permission

授予此訪問權杖的權限

文本必填 · 可重復
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli agents grant --help

rdp-cli agents revoke-access#

撤銷 Agent 的工作階段權限

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--id

目標身分

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli agents revoke-access --help

rdp-cli control claim#

以指定 Agent 身分取得已暫停的工作階段

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--lease-seconds

控制權有效秒數

正整數
預設值: 60
可選
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli control claim --help

rdp-cli control renew#

延長仍有效的控制權

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--lease-seconds

控制權有效秒數

正整數
預設值: 60
可選
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli control renew --help

rdp-cli control unclaim#

釋放控制權並暫停工作階段

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli control unclaim --help

rdp-cli control claim-status#

查看目前控制權

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli control claim-status --help

rdp-cli control handoff#

將控制權交給已授權 Agent

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--to-agent

目標 Agent 身分

文本必填
--lease-seconds

控制權有效秒數

正整數
預設值: 60
可選
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli control handoff --help

rdp-cli profiles list#

列出連線設定

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli profiles list --help

rdp-cli profiles show#

查看設定及參數來源

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--name

可讀的會話名稱

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli profiles show --help

rdp-cli profiles save#

儲存僅含憑證參照的設定

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--json

本命令的帶版本 JSON 輸入

文本必填
--replace

明確取代已安裝應用程式。

開關可選
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli profiles save --help

rdp-cli profiles remove#

刪除設定,保留憑證

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--name

可讀的會話名稱

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli profiles remove --help

rdp-cli profiles export#

匯出不含金鑰的設定

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--name

可讀的會話名稱

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli profiles export --help

rdp-cli profiles import#

匯入設定,不自動連線

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--json

本命令的帶版本 JSON 輸入

文本必填
--replace

明確取代已安裝應用程式。

開關可選
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli profiles import --help

rdp-cli doctor#

診斷能力;連線探測須明確啟用

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--session

明確的會話 ID

文本可選
--profile

已儲存的連線設定

文本可選
--probe

明確建立暫時設定連線

開關可選
--redact

省略目標名稱、位址及工作階段 ID

開關可選
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli doctor --help

rdp-cli doctor status#

查看診斷結果

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--diagnostic-id

原診斷請求 ID

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli doctor status --help

rdp-cli doctor cancel#

取消後續診斷

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--diagnostic-id

原診斷請求 ID

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli doctor cancel --help

rdp-cli wait#

等待畫面或狀態符合條件

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--condition

等待條件

枚舉
changed | stable | connection | transfer | operation
必填
--region

遠端像素區域 x,y,width,height

文本可選
--state

按所列值指定按鍵狀態或音訊靜音狀態

文本可選
--transfer-id

傳輸 ID;files status 省略時列出會話傳輸

文本可選
--operation-id

操作標識符

文本可選
--sample-ms

取樣間隔,毫秒

正整數
預設值: 100
可選
--stable-ms

要求持續穩定的時間,毫秒

正整數
預設值: 1000
可選
--threshold-permille

變化像素比例,千分數

整數
預設值: 10
可選
--pixel-delta

忽略的 RGB 通道差值

整數
預設值: 8
可選
--max-frame-age-ms

允許的畫面最大年齡,毫秒

正整數
預設值: 5000
可選
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli wait --help

rdp-cli wait status#

查看等待結果

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--wait-id

原等待請求 ID

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli wait status --help

rdp-cli wait cancel#

取消等待,不取消目標操作

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--wait-id

原等待請求 ID

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli wait cancel --help

rdp-cli batch#

預先檢查後依序執行最多 64 步

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--json

本命令的帶版本 JSON 輸入

文本可選
--steps-stdin

從標準輸入讀取批次 JSON

開關可選
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli batch --help

rdp-cli batch status#

查看批次結果,不重播操作

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--batch-id

原批次請求 ID

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli batch status --help

rdp-cli batch cancel#

取消尚未執行的批次步驟

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--batch-id

原批次請求 ID

文本必填
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli batch cancel --help

rdp-cli operations cancel#

取消剩餘輸入,已送出的輸入不會撤銷

必須指定 --session SESSION。

命令參數
參數格式與取值要求
--operation-id

操作標識符

文本可選
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli operations cancel --help

rdp-cli mcp stdio#

透過標準輸入輸出提供 MCP 服務

不強制要求工作階段;支援選用工作階段的命令會在下表列出參數。

命令參數
參數格式與取值要求
--agent-id

接收控制的 Agent

文本可選
--agent-ref

呼叫方 Agent 的憑證參照

文本可選
--claim-ref

目前控制權的參照

文本可選
--task

持久任務 ID

文本可選
--run

任務執行輪次 ID

文本可選

rdp-cli mcp stdio --help

協議與平台條件

  • RDP 預設 --cert-policy ignore 與 --tls-profile modern。TLS 1.2 伺服器也可能需要舊簽章或演算法。對已知舊式目標,可明確加入 --tls-profile legacy 重試一次,保留憑證資料和憑證原則,使用新的請求 ID。reconnect 保留所選設定,不會自動降級。strict 核驗憑證信任及名稱;Web HTTPS 不受影響。
  • VNC 的安全性取決於所選模式。傳統 VNC 不加密,應在可信任網路或 VPN 中使用;VeNCrypt X509Plain 使用 TLS,並要求驗證憑證。 加密 VNC:--vnc-security x509-plain 需要 --user、密碼來源和獨立核驗的 --vnc-tls-pin。傳統 VNC 不接受 --user。--domain、--size、--layout 等 RDP 選項不適用。
  • VNC 不提供檔案、聲音、麥克風與主動顯示佈局調整。剪貼簿 UTF-8 取決於協商,否則僅接受 Latin-1。
  • RDP 檔案需要驅動器重定向;音訊、剪貼簿、麥克風、多屏也受服務端策略與協商能力影響。
  • Windows/macOS 提供原生查看器及狀態入口。Linux 原生窗口依賴桌面顯示服務,音訊依賴主機音訊服務,保存憑據依賴 Secret Service;無桌面主機仍可使用支持的 CLI 操作。
  • Unicode 輸入會按遠端應用兼容性節奏發送。為長文本設置合適超時並核對結果;切換輸入法或打開查看器不能保證任意服務端接受所有字符。
  • Android 最低版本為 12,已測試手機為 Pixel 3 / Android 12。貼上會明確改寫手機剪貼簿。手機播放聲音需要系統分享授權,並遵守應用程式錄製限制;手機麥克風是獨立音源。連線不會開始錄音,重新連線也不會自動恢復錄音。
  • 連接 macOS 螢幕共享時,使用 --user 指定 Mac 帳戶名稱並提供帳戶密碼,自動選擇 ARD 驗證,也可明確指定 --vnc-security ard。使用另外設定的 VNC 密碼時,選擇 --vnc-security vnc-auth,不傳 --user。ARD 不會加密桌面資料流,請在可信任網路或 VPN 中使用。

錯誤恢復

OBSERVATION_REQUIRED / INVALID_COORDINATES
重新截圖,檢查螢幕佈局並選擇有效遠端坐標。
SESSION_PAUSED / CONTROL_HELD_BY_HUMAN
停止輸入,尊重人類控制;僅在明確交還 Agent 後繼續。
AUTH_FAILED / VNC_AUTH_FAILED
檢查賬號、密碼來源及遠端認證策略。
RDP_TLS_HANDSHAKE_FAILED / CERTIFICATE_UNTRUSTED
RDP_TLS_HANDSHAKE_FAILED:檢查所選設定和伺服器演算法,不能僅憑此錯誤斷定 TLS 版本舊或密碼錯誤。對已知舊式目標,用 --tls-profile legacy 和新請求 ID 重新 connect 一次。CERTIFICATE_UNTRUSTED:核驗憑證信任、名稱及實際指紋;修改 TLS 設定不能解決憑證信任問題。
CAPABILITY_UNAVAILABLE / CLIPBOARD_ENCODING_UNSUPPORTED
檢查協議能力或文本編碼,選擇支持的操作。
REQUEST_TIMEOUT / REQUEST_ID_CONFLICT / REQUEST_WINDOW_EXPIRED
重試前查詢原操作和當前畫面;不同參數不能復用 ID,保留窗口過期後也不能假定仍可去重。