WINDOWS / CLI

命令速查

本机终端CMDPowerShell

选择操作

YaoDesk Windows 命令速查：选择本机终端与操作，查看对应调用示例。首次批量执行或部署客户端，可先阅读批量 PowerShell 教程和静默安装教程。

先做这三件事

首次使用，先配置一次程序路径。

安装客户端，确认目录中有 YaoDesk.Cli.exe。
在主窗口登录主控账号并完成实名认证。
准备目标的 9 位 ID 和密码，确认目标在线且允许相应操作。

CMD · 设置程序路径

chcp 65001 >nul
set "yao=%LOCALAPPDATA%\Programs\YaoDesk\YaoDesk.Cli.exe"

自定义安装目录时替换路径。批处理使用 UTF-8 保存，保留开头的 chcp 命令。

连接第一台电脑 →

连接一台电脑

替换设备 ID 和密码，打开远程桌面。

CMD · 示例

"%yao%" controller connect 123456789 ^
  --password "HostPassword"

connect 一次只连接一台；多台请使用屏幕墙。

批量屏幕墙

多台设备使用独立密码，最多 200 台。

CMD · 示例

"%yao%" controller wall ^
  "123456789|HostPasswordA,987654321|HostPasswordB"

通过设备列表调用

CMD · 示例

"%yao%" controller wall --targets-file ".\hosts.json"

查看 hosts.json 格式 →

执行远端 CMD

执行命令并等待完成，输出保存到本机 JSON。

CMD · 示例

"%yao%" controller cmd 123456789 --password "HostPassword" ^
  --command "hostname & whoami" ^
  --output ".\cmd-result.json"

批量执行

CMD · 示例

"%yao%" controller cmd --targets-file ".\hosts.json" ^
  --command "hostname & whoami" --output ".\cmd-results.json"

执行远端 PowerShell

从所选本机终端调用远端 PowerShell。

CMD · 示例

"%yao%" controller powershell 123456789 --password "HostPassword" ^
  --command "Get-Date" ^
  --output ".\ps-result.json"

批量运行脚本

CMD · 示例

"%yao%" controller powershell --targets-file ".\hosts.json" ^
  --script ".\task.ps1" --timeout 120 ^
  --output ".\script-results.json"

task.ps1 是本机 UTF-8 脚本，执行结果保存到 JSON。

发送文件

把本机文件发送到远端指定目录。

CMD · 示例

"%yao%" controller send-files 123456789 --password "HostPassword" ^
  --file "D:\资料\报告.pdf" --to "D:\接收" ^
  --output ".\file-result.json"

批量发送多个文件

CMD · 示例

"%yao%" controller send-files --targets-file ".\hosts.json" ^
  --file "D:\资料\报告.pdf" --file "D:\资料\配置.json" ^
  --to "D:\接收" --output ".\file-results.json"

文件夹先压缩；多个文件重复填写 --file。

安装客户端

静默安装完成后自动启动客户端。

2026.1015.180 起支持

CMD · 静默安装并启动

start "" /wait ".\YaoDesk-2026.1018.190-x64-setup.exe" /S
echo %ERRORLEVEL%

普通安装与自定义目录

CMD · 普通安装

".\YaoDesk-2026.1018.190-x64-setup.exe"

CMD · 自定义目录

start "" /wait ".\YaoDesk-2026.1018.190-x64-setup.exe" /S /D=D:\Apps\YaoDesk
echo %ERRORLEVEL%

先下载最新安装包，在安装包所在目录执行。/S 必须大写，/D=路径放在最后；建议使用管理员终端。

卸载客户端

先退出主窗口和托盘程序，再运行卸载命令。

CMD · 静默卸载

"%LOCALAPPDATA%\Programs\YaoDesk\uninstall.exe" /S

打开卸载向导

CMD · 普通卸载

"%LOCALAPPDATA%\Programs\YaoDesk\uninstall.exe"

示例使用默认安装目录；自定义安装时替换路径。卸载期间请勿重新打开客户端。

帮助与本机设置

查询命令，或修改本机被控设置。

CMD · 内置帮助

"%yao%" --help

设置固定密码

CMD · 示例

"%yao%" host password "NewHostPassword"

检查更新

CMD · 示例

"%yao%" host update

固定密码与更新结果在主窗口查看。

参数与结果

需要时展开查阅，完整说明可离线下载。

设备列表 · hosts.json

JSON · hosts.json

[
  {
    "id": "123456789",
    "password": "HostPasswordA",
    "name": "办公室电脑"
  },
  {
    "id": "987654321",
    "password": "HostPasswordB",
    "name": "开发测试机"
  }
]

下载设备列表模板 ↓

最多 200 台；ID 不能重复。复杂密码优先写入 JSON，避免终端展开字符。

常用参数

--password 访问密码。

--targets-file UTF-8 JSON 设备列表，不与 ID / --password 混用。

--command / --script 命令文本或本机 UTF-8 脚本，二选一。

--file 本机文件；可重复。--to 远端绝对接收目录。

--output 本机结果 JSON；省略时写入本机 cli-results 目录。

--timeout 1～3600 秒；命令默认 90 秒，文件默认 600 秒。

结果与退出码

CMD · 任务结束后读取退出码

echo %ERRORLEVEL%

cmd、powershell、send-files 等待任务完成；connect、wall 提交打开窗口请求后返回。

0 / 1: 批量全部成功 / 存在失败；单台命令返回远端实际退出码。
2 / 3: 输入、登录、认证或写入失败 / 另一组任务执行中。
124 / 130: 超时或结果未知 / 取消或账号变化。

以 JSON 中每台主机的 state、exitCode 为准。取消后不自动重发，已启动的远端程序可能继续运行。

限制与注意事项

任务最多 200 台，同时处理 4 台，一次运行一组任务。文件每次 1～500 个，名称不能重复；接收后核对名称和大小。

--script 为本机 UTF-8 文件，最多 16 KB，编码后的单次命令最多 7000 字符；较大脚本先发送文件再运行。

直接给 ID 而不填密码时使用本机连接历史；没有可用密码则报错。目标无需登录同一账号。

CMD 中 ID|密码必须使用双引号；复杂密码使用 JSON。续行符 CMD 为 ^，PowerShell 为反引号，符号后不要添加空格。