Interfaz de línea de comandos para Windows

AnyDesk Interfaz de línea de comandos (CLI) permite a los administradores y usuarios avanzados automatizar la instalación, la configuración, el cliente y la Gestión de sesionesy la configuración de red. Este artículo explica cómo usar los comandos de AnyDesk en el símbolo del sistema de Windows o dentro de scripts como archivos por lotes para optimizar las implementaciones y la administración.

🚨 IMPORTANTE
Todos los comandos deben ejecutarse desde el directorio donde AnyDesk.exe se encuentra, o se debe especificar la ruta ejecutable completa.

La ubicación del ejecutable de AnyDesk depende del tipo de cliente:

Los clientes estándar descargados de anydesk.com se instalan normalmente para:
C:\Program Files (x86)\AnyDesk\AnyDesk.exe
Los clientes personalizados generados a través de my.anydesk.com se instalan normalmente para:
C:\Program Files (x86)\AnyDesk-<prefix>\AnyDesk-<prefix>.exe
Es <prefix> un identificador único para su cuenta. Puede encontrarlo en my.anydesk > pestaña Compilaciones > seleccionar el > de compilación deseado en la sección General , marque el campo Prefijo .

Instalación

Esta sección proporciona instrucciones para instalar o actualizar el cliente de Windows de AnyDesk mediante la línea de comandos. Puede utilizar estos comandos en scripts, procesos de implementación del sistema o durante la configuración manual. Los parámetros de instalación le permiten definir comportamientos de instalación específicos, como la creación de accesos directos, el modo silencioso y las preferencias de actualización.

Comandos de instalación

Para instalar o actualizar AnyDesk mediante la CLI, utilice el siguiente formato de comando:

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

Por ejemplo:

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

Para implementaciones basadas en MSI:

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

Parámetros de instalación

Parámetro	Descripción
--install <ubicación>	Instala AnyDesk en la ubicación especificada (por ejemplo, `C:\Program Files (x86)\AnyDesk`).
--start-with-win	Configura AnyDesk para que se inicie automáticamente con Windows.
--create-shortcuts	Agrega un acceso directo al menú Inicio.
--create-desktop-icon	Agrega un acceso directo en el escritorio.
--eliminar-primero	Desinstala la versión actual antes de instalar una nueva. Útil para actualizaciones manuales.
--silencioso	Ejecuta la instalación sin interfaz de usuario ni mensajes de error.
--actualizar-manualmente	Habilita las actualizaciones manuales (predeterminado para el cliente personalizado).
--actualización-deshabilitada	Deshabilita las actualizaciones de AnyDesk.
--actualización-automática	Habilita las actualizaciones automáticas (predeterminado para clientes estándar; no disponible para clientes personalizados

Cliente de AnyDesk

El ejecutable de AnyDesk (anydesk.exe) ofrece una amplia gama de comandos que permiten a los administradores controlar y configurar el cliente. Estos comandos se pueden usar individualmente o dentro de scripts de automatización para optimizar las tareas administrativas en múltiples sistemas.

Comandos de cliente

Los siguientes ejemplos muestran cómo usar comandos clave del cliente, como registrar una clave de licencia o establecer una contraseña Acceso desatendido . Estos comandos se utilizan con frecuencia durante la configuración inicial o al automatizar la configuración del cliente.

Mandar	Descripción
anydesk.exe <parámetro>	Para obtener una lista completa de las opciones disponibles, consulte Client command parameters.
'echo <license_key> "\| anydesk.exe --register-license	Registra la clave de licencia especificada. Requiere privilegios de administrador.
'echo <my_password> "\| anydesk.exe --set-password	Establece la contraseña especificada para el acceso desatendido.

Parámetros de comando de cliente

En esta tabla se enumeran los parámetros de línea de comandos individuales disponibles para el cliente de AnyDesk. Estos parámetros se pueden usar para anydesk.exe configurar o controlar el cliente directamente, y se usan comúnmente en scripts o configuraciones administrativas.

Parámetro	Descripción
--desinstalar	Desinstala AnyDesk con un indicador gráfico.
--eliminar	Desinstala AnyDesk silenciosamente sin ningún aviso o interfaz de usuario.
--empezar	Inicia el servicio en segundo plano de AnyDesk.
--parar-servicio	Detiene el servicio en segundo plano de AnyDesk.
--reiniciar-servicio	Reinicia el servicio en segundo plano de AnyDesk.
--eliminar-contraseña	Elimina la contraseña de acceso desatendido (se requieren derechos de administrador). Nota: Esto no puede eliminar contraseñas preestablecidas de clientes personalizados.
--eliminar-licencia	Elimina la clave de licencia del cliente. Nota: Esto no cierra la sesión de los usuarios que iniciaron sesión a través de su cuenta.
--get-alias	Muestra el alias de AnyDesk. Normalmente se usa en scripts.
--get-id	Muestra el ID de AnyDesk. Normalmente se utiliza en scripts.
--get-status	Muestra el estado en línea del cliente.
--Versión	Muestra la versión de AnyDesk instalada.
--Configuración	Abre la página de configuración predeterminada (local).
--admin-settings	Abre la página de configuración global (nivel de administrador).
--ajustes:<viable_parameter>	Abre la sección de configuración especificada. Parámetros admitidos: , , , `videocapturefile_transferrecordingwollicenseaudioprinterprivacyconnectionaliassecurityuiabout`
--admin-settings:<viable_parameter>	Abre la sección especificada de la configuración global. Parámetros admitidos: `capture`, `security`, `connection`, `recording`
--Renuncia	Muestra el mensaje de declinación de responsabilidades personalizado. Solo funciona para clientes personalizados con esta opción habilitada.

Ejemplo de script por lotes para obtener el ID de AnyDesk:

@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

Comandos de perfil de permisos (AnyDesk 7+)

Los perfiles de permisos permiten a los administradores definir configuraciones de control de acceso personalizadas para sesiones remotas. Estos perfiles se pueden crear, configurar y administrar a través de la línea de comandos. Esto es compatible con AnyDesk versión 7 y posteriores.

Crear un perfil de permisos

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

Crea un nuevo perfil de permisos denominado <name>. De forma predeterminada, todos los permisos están deshabilitados. Úselo +<permission> para habilitar permisos específicos, separados por espacios.

Permisos admitidos:

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

Crear un perfil con contraseña de acceso desatendido

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

Crea un perfil de permisos con <name> la contraseña de acceso desatendido especificada. Los permisos deben definirse de la misma manera que los anteriores.

Establecer una contraseña para un perfil existente

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

Asigna o actualiza la contraseña de acceso desatendido para el perfil especificado.

Para perfiles personalizados: use el nombre del perfil de permiso.
Para los perfiles predeterminados, use:
- _default –Predeterminado
- _full_access – Acceso completo
- _screen_sharing – Compartir pantalla
- _unattended_access – Unattended Access

Eliminar una contraseña de un perfil

anydesk.exe --remove-password <profile>

Quita la contraseña de acceso desatendido del perfil especificado.

💡 NOTA
Este comando no puede eliminar contraseñas preestablecidas de las configuraciones de cliente personalizadas.

Iniciar sesiones a través de la línea de comandos

Puede iniciar sesiones remotas directamente desde la línea de comandos mediante el anydesk.exe ejecutable.

Comandos de conexión

Esto puede ser útil para integrar AnyDesk con scripts, herramientas de gestión o procesos de automatización.

Conectarse a un cliente

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

Inicia una sesión remota en el ID o alias de AnyDesk especificado.

<ID_or_Alias> - la dirección de AnyDesk del cliente remoto.
<additional_parameters> - Parámetros opcionales para personalizar la sesión. Para obtener parámetros adicionales, consulte Optional session parameters.

Conéctese usando una contraseña

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

Inicia una sesión en el cliente especificado y envía la contraseña especificada para el acceso desatendido.

Parámetros de sesión opcionales

Puede agregar los siguientes parámetros a los comandos de sesión para modificar cómo se inicia la sesión:

Mandar	Descripción
--file-transfer	Inicia una sesión de transferencia de archivos.
--pantalla completa	Inicia una sesión en modo de pantalla completa.
--llanura	Inicia una sesión en una ventana sin bordes y sin opciones de menú.

Comandos proxy

Puede configurar los ajustes del proxy HTTP de AnyDesk utilizando parámetros de línea de comandos. Esto es especialmente útil para entornos con políticas de red estrictas o donde se requiere autenticación de proxy.

🦉 Para obtener más información sobre la configuración del proxy, consulte this article.

Inhabilitar el uso de proxy

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

Establece el modo de proxy en Sin proxy en Configuración > Conexión > HTTP-Proxy. AnyDesk no intentará conectarse a través de un proxy.

Detectar proxy automáticamente

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

Establece el modo de proxy en Detectar proxy. AnyDesk intentará detectar un proxy. Si no se encuentra ninguno, procederá sin uno.

Configurar un proxy manual

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

Configura un proxy manual en Configuración > Conexión > HTTP-Proxy.

<proxy_type>: http, https, o socks
<address>: Dirección del servidor proxy (IP o URL)
<port>: Puerto utilizado para conectarse al proxy
[+force-proxy]: Pruebe el proxy, recurra a la conexión normal si falla (opcional)
[-force-proxy]: Poder de fuerza; Desconectar si el proxy no está disponible (opcional)
[--reconnect]: Reinicia la conexión para aplicar la nueva configuración (opcional)

Deshabilitar la autenticación de proxy

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

Deshabilita la autenticación. Establece la autenticación de proxy HTTP en No se requiere autenticación.

Usar credenciales de Windows

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

Usa credenciales de cuenta de Windows para la autenticación de proxy (NTLM). Establece la autenticación de proxy HTTP en NTLM.

Especificar nombre de usuario y contraseña

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

Utiliza el nombre de usuario y la contraseña configurados para la autenticación. Establece el método de autenticación de proxy en Configurar nombre de usuario y contraseña.