Interfaz de línea de comandos para Windows

Prev Next

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_accessUnattended 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.