Interface de linha de comando para Windows

O AnyDesk Interface de linha de comando (CLI) permite que administradores e usuários avançados automatizem a instalação, configuração, cliente e Gerenciamento de Sessãoe configurações de rede. Este artigo explica como usar os comandos do AnyDesk no prompt de comando do Windows ou em scripts, como arquivos em lote, para simplificar as implantações e a administração.

🚨 IMPORTANTE

Todos os comandos devem ser executados a partir do diretório onde AnyDesk.exe está localizado ou o caminho executável completo deve ser especificado.

A localização do executável AnyDesk depende do tipo de cliente:

• Os clientes padrão baixados do anydesk.com normalmente são instalados em:
  C:\Program Files (x86)\AnyDesk\AnyDesk.exe

• Os clientes personalizados gerados por meio my.anydesk.com normalmente são instalados em:
  C:\Program Files (x86)\AnyDesk-<prefix>\AnyDesk-<prefix>.exe
  O <prefix> é um identificador exclusivo para sua conta. Você pode encontrá-lo na guia Compilações > selecionar my.anydesk > > de compilação desejada na seção Geral, marque o campo Prefixo.

Instalação

Esta seção fornece instruções para instalar ou atualizar o cliente Windows AnyDesk usando a linha de comando. Você pode usar esses comandos em scripts, processos de implantação do sistema ou durante a configuração manual. Os parâmetros de instalação permitem definir comportamentos de instalação específicos, como criação de atalhos, modo silencioso e preferências de atualização.

Comandos de instalação

Para instalar ou atualizar o AnyDesk usando a CLI, use o seguinte formato de comando:

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

Por exemplo:

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

Para implantações baseadas em MSI:

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

Parâmetros de instalação

Cliente AnyDesk

O executável do AnyDesk (anydesk.exe) oferece uma ampla gama de comandos que permitem aos administradores controlar e configurar o cliente. Esses comandos podem ser usados individualmente ou em scripts de automação para simplificar tarefas administrativas em vários sistemas.

Comandos do cliente

Os exemplos abaixo demonstram como usar comandos de cliente de chave, como registrar uma chave de licença ou definir uma senha Acesso não supervisionado . Esses comandos são frequentemente usados durante a configuração inicial ou ao automatizar a configuração do cliente.

Parâmetros de comando do cliente

Esta tabela lista os parâmetros de linha de comando individuais disponíveis para o cliente AnyDesk. Esses parâmetros podem ser usados para anydesk.exe configurar ou controlar o cliente diretamente e são comumente usados em scripts ou configurações administrativas.

Exemplo de script em lote para obter o ID do 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 permissão (AnyDesk 7+)

Os perfis de permissão permitem que os administradores definam configurações personalizadas de controle de acesso para sessões remotas. Esses perfis podem ser criados, configurados e gerenciados por meio da linha de comando. Isso é compatível com o AnyDesk versão 7 e posterior.

Criar um perfil de permissão

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

Cria um novo perfil de permissão chamado <name>. Por padrão, todas as permissões estão desabilitadas. Use +<permission> para habilitar permissões específicas, separadas por espaços.

Permissões suportadas:

• 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

Criar um perfil com senha de acesso não supervisionado

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

Cria um perfil de permissão nomeado <name> com a senha de acesso autônomo especificada. As permissões devem ser definidas da mesma forma que acima.

Definir uma senha para um perfil existente

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

Atribui ou atualiza a senha de acesso autônomo para o perfil especificado.

• Para perfis personalizados: use o nome do perfil de permissão.

• Para perfis padrão, use:

  • _default –Inadimplência

  • _full_access – Acesso total

  • _screen_sharing - Compartilhamento de tela

  • _unattended_access – Unattended Access

Remover uma senha de um perfil

anydesk.exe --remove-password <profile>

Remove a senha de acesso autônomo do perfil especificado.

💡 NOTA

Esse comando não pode remover senhas predefinidas de configurações personalizadas do cliente.

Iniciar sessões via linha de comando

Você pode iniciar sessões remotas diretamente da linha de comando usando o anydesk.exe executável.

Comandos de conexão

Isso pode ser útil para integrar o AnyDesk com scripts, ferramentas de gerenciamento ou processos de automação.

Conectar-se a um cliente

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

Inicia uma sessão remota para o ID ou alias do AnyDesk especificado.

• <ID_or_Alias> - o endereço AnyDesk do cliente remoto.

• <additional_parameters> - parâmetros opcionais para personalizar a sessão. Para obter parâmetros adicionais, consulte Optional session parameters.

Conecte-se usando uma senha

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

Inicia uma sessão para o cliente especificado e envia a senha fornecida para acesso autônomo.

Parâmetros de sessão opcionais

Você pode adicionar os seguintes parâmetros aos comandos de sessão para modificar como a sessão é iniciada:

Comandos de proxy

Você pode definir as configurações de proxy HTTP do AnyDesk usando parâmetros de linha de comando. Isso é especialmente útil para ambientes com políticas de rede rígidas ou onde a autenticação de proxy é necessária.

🦉 Para obter mais detalhes sobre as configurações de proxy, consulte this article. 

Desativar o uso de proxy

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

Define o modo proxy como Sem proxy em Configurações > Conexão > HTTP-Proxy. O AnyDesk não tentará se conectar por meio de um proxy.

Detectar proxy automaticamente

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

Define o modo proxy como Detectar proxy. AnyDesk tentará detectar um proxy. Se nenhum for encontrado, ele prosseguirá sem um.

Configurar um proxy manual

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

Configura um proxy manual em Configurações > Conexão > HTTP-Proxy.

• <proxy_type>: http, https, ou socks

• <address>: Endereço do servidor proxy (IP ou URL)

• <port>: Porta usada para se conectar ao proxy

• [+force-proxy]: Tente proxy, volte para a conexão normal se falhar (opcional)

• [-force-proxy]: Forçar proxy; desconectar se o proxy não estiver disponível (opcional)

• [--reconnect]: Reinicia a conexão para aplicar as novas configurações (opcional)

Desativar autenticação de proxy

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

Desabilita a autenticação. Define a autenticação HTTP-Proxy como Nenhuma autenticação necessária.

Usar credenciais do Windows

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

Usa credenciais de conta do Windows para autenticação de proxy (NTLM). Define a autenticação HTTP-Proxy como NTLM.

Especifique o nome de usuário e a senha

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

Usa o nome de usuário e a senha configurados para autenticação. Define o método de autenticação de proxy como Configurar nome de usuário e senha.