Command-line interface for Windows

The AnyDesk Interface de linha de comando (CLI) allows administrators and advanced users to automate installation, configuration, client and Gerenciamento de Sessão, and network settings. This article explains how to use AnyDesk commands in the Windows Command Prompt or within scripts such as batch files to streamline deployments and administration.

🚨 IMPORTANT

All commands must be run from the directory where AnyDesk.exe is located, or the full executable path must be specified.

The location of the AnyDesk executable depends on the client type:

• Standard clients downloaded from anydesk.com are typically installed to:
  C:\Program Files (x86)\AnyDesk\AnyDesk.exe

• Custom clients generated via my.anydesk.com are typically installed to:
  C:\Program Files (x86)\AnyDesk-<prefix>\AnyDesk-<prefix>.exe
  The <prefix> is a unique identifier for your account. You can find it in my.anydesk > Builds tab > select desired build > in the General section, check the Prefix field.

Installation

This section provides instructions for installing or updating the AnyDesk Windows client using command-line. You can use these commands in scripts, system deployment processes, or during manual setup. Installation parameters allow you to define specific installation behaviors, such as shortcut creation, silent mode, and update preferences.

Installation commands

To install or update AnyDesk using the CLI, use the following command format:

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

For example:

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

For MSI-based deployments:

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

Installation parameters

AnyDesk client

The AnyDesk executable (anydesk.exe) offers a wide range of commands that allow administrators to control and configure the client. These commands can be used individually or within automation scripts to streamline administrative tasks across multiple systems.

Client commands

The examples below demonstrate how to use key client commands, such as registering a license key or setting an Acesso não supervisionado password. These commands are frequently used during initial setup or when automating client configuration.

Client command parameters

This table lists individual command-line parameters available for the AnyDesk client. These parameters can be used with anydesk.exe to configure or control the client directly, and are commonly used in scripts or administrative setups.

Example batch script to get 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

Permission profile commands (AnyDesk 7+)

Permission profiles allow administrators to define custom access control settings for remote sessions. These profiles can be created, configured, and managed via the command line. This is supported in AnyDesk version 7 and later.

Create a permission profile

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

Creates a new permission profile named <name>. By default, all permissions are disabled. Use +<permission> to enable specific permissions, separated by spaces.

Supported permissions:

• 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

Create a profile with unattended access password

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

Creates a permission profile named <name> with the specified unattended access password. Permissions must be defined the same way as above.

Set a password for an existing profile

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

Assigns or updates the unattended access password for the specified profile.

• For custom profiles: use the permission profile name.

• For default profiles, use:

  • _default – Default

  • _full_access – Full Access

  • _screen_sharing – Screen Sharing

  • _unattended_access – Unattended Access

Remove a password from a profile

anydesk.exe --remove-password <profile>

Removes the unattended access password from the specified profile.

💡 NOTE

This command cannot remove preset passwords from custom client configurations.

Start sessions via command-line

You can initiate remote sessions directly from the command line using the anydesk.exe executable.

Connection commands

This can be useful for integrating AnyDesk with scripts, management tools, or automation processes.

Connect to a client

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

Starts a remote session to the specified AnyDesk ID or Alias.

• <ID_or_Alias> - the AnyDesk address of the remote client.

• <additional_parameters> - optional parameters to customize the session. For additional parameters, see Optional session parameters.

Connect using a password

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

Starts a session to the specified client and submits the given password for Unattended Access.

Optional session parameters

You can add the following parameters to session commands to modify how the session starts:

Proxy commands

You can configure AnyDesk’s HTTP proxy settings using command-line parameters. This is especially useful for environments with strict network policies or where proxy authentication is required.

🦉 For more details on proxy settings, see this article. 

Disable proxy usage

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

Sets the proxy mode to No proxy under Settings > Connection > HTTP-Proxy. AnyDesk will not attempt to connect via a proxy.

Detect proxy automatically

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

Sets the proxy mode to Detect proxy. AnyDesk will attempt to detect a proxy. If none is found, it will proceed without one.

Set up a manual proxy

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

Configures a manual proxy under Settings > Connection > HTTP-Proxy.

• <proxy_type>: http, https, or socks

• <address>: Proxy server address (IP or URL)

• <port>: Port used to connect to the proxy

• [+force-proxy]: Try proxy, fallback to normal connection if it fails (optional)

• [-force-proxy]: Force proxy; disconnect if the proxy is unavailable (optional)

• [--reconnect]: Restarts the connection to apply the new settings (optional)

Disable proxy authentication

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

Disables authentication. Sets HTTP-Proxy authentication to No authentication required.

Use Windows credentials

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

Uses Windows account credentials for proxy authentication (NTLM). Sets HTTP-Proxy authentication to NTLM.

Specify username and password

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

Uses the configured username and password for authentication. Sets the proxy authentication method to Set up username and password.