AnyDesk Command-Line Interface （CLI）允许管理员和高级用户自动执行安装、配置、客户端和 Session Management以及网络设置。本文介绍了如何在 Windows 命令提示符或批处理文件等脚本中使用 AnyDesk 命令来简化部署和管理。

🚨 重要
所有命令都必须从所在的目录 AnyDesk.exe 运行，或者必须指定完整的可执行路径。

AnyDesk 可执行文件的位置取决于客户端类型：

从anydesk.com 下载的标准客户端 通常安装到：
C:\Program Files (x86)\AnyDesk\AnyDesk.exe
通过my.anydesk.com生成的自定义客户端 通常安装到：
C:\Program Files (x86)\AnyDesk-<prefix>\AnyDesk-<prefix>.exe
是您 <prefix> 帐户的唯一标识符。您可以在 my.anydesk > 构建选项卡中找到它>在常规部分选择所需的构建>，选中前缀字段。

安装

本节提供使用命令行安装或更新 AnyDesk Windows 客户端的说明。您可以在脚本、系统部署过程或手动设置期间使用这些命令。安装参数允许您定义特定的安装行为，例如快捷方式创建、静默模式和更新首选项。

安装命令

要使用 CLI 安装或更新 AnyDesk，请使用以下命令格式：

anydesk.exe --install <location> <additional_parameters>

例如：

anydesk.exe --install  “C:\Program Files (x86)\AnyDesk” --start-with-win --create-desktop-icon

对于基于 MSI 的部署：

anydesk.msi (optional: INSTALL="<location>")

安装参数

参数	描述
--install <位置>	将 AnyDesk 安装在指定位置（例如 `C:\Program Files (x86)\AnyDesk`）。
--以赢开始	将 AnyDesk 配置为在 Windows 上自动启动。
--创建快捷方式	添加“开始”菜单快捷方式。
--创建桌面图标	添加桌面快捷方式。
--删除优先	在安装新版本之前卸载当前版本。对于手动更新很有用。
--沉默	运行安装，没有用户界面和错误提示。
--手动更新	启用手动更新（自定义客户端的默认值）。
--更新禁用	禁用 AnyDesk 更新。
--更新自动	启用自动更新（标准客户端默认，自定义客户端不可用

AnyDesk客户端

AnyDesk 可执行文件（anydesk.exe）提供了广泛的命令，允许管理员控制和配置客户端。这些命令可以单独使用，也可以在自动化脚本中使用，以简化跨多个系统的管理任务。

客户端命令

以下示例演示了如何使用关键客户端命令，例如注册许可证密钥或设置 Unattended Access 密码。这些命令在初始设置或自动执行客户端配置时经常使用。

命令	描述
anydesk.exe <参数>	有关可用选项的完整列表，请参阅 Client command parameters。
'回声<license_key>“\|anydesk.exe --注册许可证	注册指定的许可证密钥。需要管理员权限。
'echo <my_password> “\|anydesk.exe --设置密码	设置无人值守访问的指定密码。

客户端命令参数

下表列出了可用于 AnyDesk 客户端的各个命令行参数。这些参数可用于 anydesk.exe 直接配置或控制客户端，并且通常用于脚本或管理设置。

参数	描述
--卸载	使用图形提示卸载 AnyDesk。
--删除	静默卸载 AnyDesk，没有任何提示或 UI。
--开始	启动 AnyDesk 后台服务。
--停止服务	停止 AnyDesk 后台服务。
--重新启动服务	重新启动 AnyDesk 后台服务。
--删除密码	删除无人值守访问密码（需要管理员权限）。注意：这无法从自定义客户端中删除预设密码。
--删除许可证	从客户端中删除许可证密钥。注意：这不会注销通过其帐户登录的用户。
--获取别名	显示 AnyDesk 别名。通常用于脚本。
--获取 ID	显示 AnyDesk ID。通常用于脚本。
--获取状态	显示客户端的联机状态。
--版本	显示已安装的 AnyDesk 版本。
--设置	打开默认（本地）设置页面。
--管理员设置	打开全局（管理员级别）设置页面。
--设置：<viable_parameter>	打开指定的设置部分。支持参数：`ui`、、 `privacyrecordingprinterwolaliascapturelicensevideoaudioconnectionfile_transfersecurityabout`
--管理员设置：<viable_parameter>	打开全局设置的指定部分。支持参数：`capture`、、`security`、 `connectionrecording`
--免責聲明	显示自定义免责声明消息。仅适用于启用此选项的自定义客户端。

获取 AnyDesk ID 的示例批处理脚本：

@echo off
for /f "delims=" %%i in ('"C:\Program Files (x86)\AnyDesk\AnyDesk.exe" --get-id') do set ID=%%i 
echo AnyDesk ID is: %ID%
pause

权限配置文件命令（AnyDesk 7+）

权限配置文件允许管理员为远程会话定义自定义访问控制设置。这些配置文件可以通过命令行创建、配置和管理。AnyDesk 版本 7 及更高版本支持此功能。

创建权限配置文件

anydesk.exe --add-profile <name> +<permission> +<permission> ...

创建名为 <name>的新权限配置文件。默认情况下，所有权限都处于禁用状态。用于 +<permission> 启用特定权限，以空格分隔。

支持的权限：

audio
input
clipboard
clipboard_files
block_input
sas (CTRL+ALT+DEL action)
restart
file_manager
lock_desk
sysinfo
whiteboard
tcp_tunnel
VPN
user_pointer
privacy_feature
record_session

使用无人值守访问密码创建配置文件

echo <password> | anydesk.exe --add-profile <name> +<permission> +<permission> ...

创建使用指定的无人值守访问密码命名的 <name> 权限配置文件。权限的定义方式必须与上述相同。

为现有配置文件设置密码

echo <password> | anydesk.exe --set-password <profile>

为指定配置文件分配或更新无人值守访问密码。

对于自定义配置文件：使用权限配置文件名称。
对于默认配置文件，请使用：
- _default –违约
- _full_access – 完全访问权限
- _screen_sharing – 屏幕共享
- _unattended_access – Unattended Access

从个人资料中移除密码

anydesk.exe --remove-password <profile>

从指定的配置文件中删除无人值守访问密码。

💡 注意
此命令无法从自定义客户端配置中删除预设密码。

通过命令行启动会话

您可以使用可执行文件直接 anydesk.exe 从命令行启动远程会话。

连接命令

这对于将 AnyDesk 与脚本、管理工具或自动化流程集成非常有用。

连接到客户端

anydesk.exe <ID/Alias> <additional parameters>

启动到指定 AnyDesk ID 或别名的远程会话。

<ID_or_Alias> - 远程客户端的 AnyDesk 地址。
<additional_parameters> - 用于自定义会话的可选参数。有关其他参数，请参阅 Optional session parameters。

使用密码连接

echo <password> | anydesk.exe <ID/Alias> --with-password

启动与指定客户端的会话，并提交给定的密码以进行无人值守访问。

可选会话参数

您可以向会话命令添加以下参数，以修改会话的启动方式：

命令	描述
--文件传输	启动文件传输会话。
--全屏	以全屏模式启动会话。
--平原	在没有边框和菜单选项的窗口中启动会话。

代理命令

您可以使用命令行参数配置 AnyDesk 的 HTTP 代理设置。这对于具有严格网络策略或需要代理身份验证的环境特别有用。

🦉 有关代理设置的更多详细信息，请参阅 this article。

禁用代理使用

anydesk.exe --proxy --set-host never

将代理模式设置为“设置”>“连接”>“HTTP-Proxy”下的“无代理”。AnyDesk 不会尝试通过代理进行连接。

自动检测代理

anydesk.exe --proxy --set-host detect

将代理模式设置为 “检测代理”。AnyDesk将尝试检测代理。如果未找到，则在没有找到的情况下继续。

设置手动代理

anydesk.exe --proxy --set-host <proxy_type> <address> <port> [<force_proxy>] [--reconnect]

在“ 设置”>“连接”>“HTTP-Proxy”下配置手动代理。

<proxy_type>： http， https，或 socks
<address>：代理服务器地址（IP 或 URL）
<port>：用于连接到代理的端口
[+force-proxy]：尝试代理，失败时回退到正常连接（可选）
[-force-proxy]：强制代理;如果代理不可用，则断开连接（可选）
[--reconnect]：重新启动连接以应用新设置（可选）

禁用代理身份验证

anydesk.exe --proxy --set-auth disable

禁用身份验证。将 HTTP-Proxy 身份验证设置为“ 无需身份验证”。

使用 Windows 凭据

anydesk.exe --proxy --set-auth auto

使用 Windows 帐户凭据进行代理身份验证（NTLM）。将 HTTP-Proxy 身份验证设置为 NTLM。

指定用户名和密码

echo <password> | anydesk.exe --proxy --set-auth simple <username>

使用配置的用户名和密码进行身份验证。将代理认证方法设置为设置 用户名和密码。