适用于 Windows 的命令行界面

AnyDesk 命令行界面 （CLI） 允许管理员和高级用户自动执行安装、配置、客户端和 会话管理以及网络设置。本文介绍了如何在 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>")

安装参数

AnyDesk客户端

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

客户端命令

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

客户端命令参数

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

获取 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>

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