YaoDesk 命令行使用说明 · CMD 版
更新：2026-10-15
https://yaodesk.com/cli.html?shell=cmd

使用 2026.1013.173 或以上版本。CLI 与 YaoDesk.exe 及运行库需放在同一目录。
默认目录：%LOCALAPPDATA%\Programs\YaoDesk。
先在主窗口登录主控账号并完成实名认证。
目标电脑需在线，允许命令行、文件传输等对应权限。
使用真实的 9 位数字设备 ID 和访问密码；被控端可以属于不同账号，也可以没有登录账号。
将示例 ID、密码、路径替换为实际信息。

示例在本机 CMD 输入，也可保存为 UTF-8 的 .bat；开头执行 chcp 65001 >nul，以处理中文路径。
用 ^ 续行，^ 后不要添加空格。ID|密码 必须使用双引号；包含百分号或感叹号等特殊字符的密码建议使用 JSON 文件。

这里选择的是本机终端；远端执行类型由 controller cmd 或 controller powershell 决定。

1. 设置 CLI 程序路径
chcp 65001 >nul
set "yao=%LOCALAPPDATA%\Programs\YaoDesk\YaoDesk.Cli.exe"

2. 单台远程桌面
"%yao%" controller connect 123456789 ^
  --password "HostPassword"

3. 使用独立密码打开屏幕墙
"%yao%" controller wall ^
  "123456789|HostPasswordA,987654321|HostPasswordB"

4. 通过设备列表打开屏幕墙
"%yao%" controller wall --targets-file ".\hosts.json"

5. 单台执行 CMD 命令
"%yao%" controller cmd 123456789 --password "HostPassword" ^
  --command "hostname & whoami" ^
  --output ".\cmd-result.json"

6. 批量执行 CMD 命令
"%yao%" controller cmd --targets-file ".\hosts.json" ^
  --command "hostname & whoami" --output ".\cmd-results.json"

7. 单台执行 PowerShell 命令
"%yao%" controller powershell 123456789 --password "HostPassword" ^
  --command "Get-Date" ^
  --output ".\ps-result.json"

8. 批量运行本机 UTF-8 脚本
"%yao%" controller powershell --targets-file ".\hosts.json" ^
  --script ".\task.ps1" --timeout 120 ^
  --output ".\script-results.json"

9. 单台发送文件
"%yao%" controller send-files 123456789 --password "HostPassword" ^
  --file "D:\资料\报告.pdf" --to "D:\接收" ^
  --output ".\file-result.json"

10. 批量发送多个文件
"%yao%" controller send-files --targets-file ".\hosts.json" ^
  --file "D:\资料\报告.pdf" --file "D:\资料\配置.json" ^
  --to "D:\接收" --output ".\file-results.json"

11. 查看内置帮助
"%yao%" --help

12. 设置本机固定访问密码
"%yao%" host password "NewHostPassword"

13. 检查客户端更新
"%yao%" host update

14. 在上一条 CLI 任务结束后读取退出码
echo %ERRORLEVEL%

15. 静默安装客户端并等待完成
start "" /wait ".\YaoDesk-2026.1018.190-x64-setup.exe" /S
echo %ERRORLEVEL%

16. 静默安装到自定义目录
start "" /wait ".\YaoDesk-2026.1018.190-x64-setup.exe" /S /D=D:\Apps\YaoDesk
echo %ERRORLEVEL%

设备列表 hosts.json
使用 UTF-8 JSON 数组，最多 200 台，ID 不能重复，name 可省略。
模板：https://yaodesk.com/assets/hosts.example.json
--targets-file 不可与直接提供 ID 或 --password 混用。密码复杂时建议使用 JSON 文件。
直接提供 ID 而不填密码时使用本机成功连接历史密码；没有可用密码则报错。
connect 一次只连接一台；wall 批量打开屏幕墙。

参数与任务限制
--command 与 --script 二选一；脚本是本机 UTF-8 文件，最多 16 KB，最终编码命令最多 7000 字符。
较大脚本可先发送文件，再调用被控端上的文件。
--file 可重复指定，每次 1～500 个文件；文件夹请先压缩，多个源文件不能同名。
--to 是远端 Windows 绝对目录或 UNC 路径；传输后确认文件名称和大小，不进行内容哈希校验。
--output 是本机 JSON 结果文件；省略时保存到 %LOCALAPPDATA%\CloudPCNativeAllInOne\cli-results。
--timeout 范围 1～3600 秒，命令默认 90 秒，文件默认 600 秒，另包含连接与清理时间。

等待与退出码
cmd、powershell、send-files 等待整个任务完成，结果 JSON 输出到终端并保存到文件。
connect、wall 提交打开窗口请求后返回，不等待窗口关闭；返回 0 不代表远程连接已成功。
单台命令收到结果时返回远端实际退出码；批量命令和文件任务全部成功为 0，存在失败为 1。
2：输入、登录、认证或结果写入失败；3：另一组命令行任务正在执行。
124：超时或结果未知；130：Ctrl+C 取消或主控账号变化。
以 JSON 中每台设备的 state、exitCode 为准，远端程序也可能返回上述数值。
每台结果包含 id、name、state；命令结果还有 exitCode、output；文件结果还有逐文件信息。
queued：排队；connecting：连接中；running：执行中；completed：完成；failed：失败；unknown：未知；cancelled：取消。
命令输出最多保留末尾约 32 KB；结果不保存访问密码或命令正文。
命令和文件任务同时处理 4 台，一次只运行一组任务；最多 200 台。
未知或取消后不会自动重发，已启动的远端程序可能继续运行；重试前检查主机或接收目录。
任务结束不会关闭已有远程窗口或屏幕墙缩略图。

安装与本机设置
/S 必须大写，/D=完整路径 必须放在安装器参数最后；示例中的安装包名称请替换为实际文件名。
安装退出码 0 表示成功，非 0 表示失败；180 版起，静默安装成功后自动启动客户端。
建议使用管理员终端完成系统控制服务安装。
固定访问密码需 6～32 位英文、数字或常用符号，不能包含空格。
本机密码与检查更新由主窗口处理，请在界面中查看结果。


普通安装
".\YaoDesk-2026.1018.190-x64-setup.exe"

卸载客户端（先退出主窗口和托盘，自定义目录请替换路径）
"%LOCALAPPDATA%\Programs\YaoDesk\uninstall.exe" /S

打开卸载向导
"%LOCALAPPDATA%\Programs\YaoDesk\uninstall.exe"