Interfaccia della riga di comando per Windows

AnyDesk Interfaccia della riga di comando (CLI) consente agli amministratori e agli utenti avanzati di automatizzare l'installazione, la configurazione, il client e Gestione delle sessionie le impostazioni di rete. Questo articolo spiega come utilizzare i comandi di AnyDesk nel prompt dei comandi di Windows o all'interno di script come i file batch per semplificare le distribuzioni e l'amministrazione.

🚨 IMPORTANTE

Tutti i comandi devono essere eseguiti dalla directory in cui AnyDesk.exe si trova oppure deve essere specificato il percorso completo dell'eseguibile.

La posizione dell'eseguibile AnyDesk dipende dal tipo di client:

• I client standard scaricati da anydesk.com vengono in genere installati in:
  C:\Program Files (x86)\AnyDesk\AnyDesk.exe

• I client personalizzati generati tramite my.anydesk.com vengono in genere installati per:
  C:\Program Files (x86)\AnyDesk-<prefix>\AnyDesk-<prefix>.exe
  È <prefix> un identificatore univoco per il tuo account. Puoi trovarlo nella scheda Build > selezionare my.anydesk > build desiderata > nella sezione Generale, seleziona il campo Prefisso.

Installazione

Questa sezione fornisce istruzioni per l'installazione o l'aggiornamento del client Windows AnyDesk utilizzando la riga di comando. È possibile utilizzare questi comandi negli script, nei processi di distribuzione del sistema o durante l'installazione manuale. I parametri di installazione consentono di definire comportamenti di installazione specifici, ad esempio la creazione di scorciatoie, la modalità invisibile all'utente e le preferenze di aggiornamento.

Comandi di installazione

Per installare o aggiornare AnyDesk utilizzando la CLI, utilizza il seguente formato di comando:

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

Per esempio:

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

Per le distribuzioni basate su MSI:

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

Parametri di installazione

Cliente AnyDesk

L'eseguibile AnyDesk (anydesk.exe) offre un'ampia gamma di comandi che consentono agli amministratori di controllare e configurare il client. Questi comandi possono essere utilizzati singolarmente o all'interno di script di automazione per semplificare le attività amministrative su più sistemi.

Comandi client

Gli esempi seguenti illustrano come utilizzare i comandi chiave del client, come la registrazione di una chiave di licenza o l'impostazione di una password Accesso non presidiato . Questi comandi vengono utilizzati di frequente durante l'installazione iniziale o durante l'automazione della configurazione del client.

Parametri del comando client

Questa tabella elenca i singoli parametri della riga di comando disponibili per il client AnyDesk. Questi parametri possono essere utilizzati per anydesk.exe configurare o controllare direttamente il client e sono comunemente utilizzati negli script o nelle impostazioni amministrative.

Esempio di script batch per ottenere l'ID 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

Comandi del profilo di autorizzazione (AnyDesk 7+)

I profili di autorizzazione consentono agli amministratori di definire impostazioni di controllo degli accessi personalizzate per le sessioni remote. Questi profili possono essere creati, configurati e gestiti tramite la riga di comando. Questo è supportato in AnyDesk versione 7 e successive.

Creare un profilo di autorizzazione

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

Crea un nuovo profilo di autorizzazione denominato <name>. Per impostazione predefinita, tutte le autorizzazioni sono disabilitate. Utilizzare +<permission> questa opzione per abilitare autorizzazioni specifiche, separate da spazi.

Autorizzazioni supportate:

• 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

Crea un profilo con password di accesso non presidiato

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

Crea un profilo di autorizzazione denominato <name> con la password di accesso automatico specificata. Le autorizzazioni devono essere definite allo stesso modo di cui sopra.

Impostare una password per un profilo esistente

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

Assegna o aggiorna la password di accesso automatico per il profilo specificato.

• Per i profili personalizzati: utilizza il nome del profilo di autorizzazione.

• Per i profili predefiniti, utilizzare:

  • _default –Default

  • _full_access – Accesso completo

  • _screen_sharing – Condivisione dello schermo

  • _unattended_access – Unattended Access

Rimuovere una password da un profilo

anydesk.exe --remove-password <profile>

Rimuove la password di accesso automatico dal profilo specificato.

💡 NOTA

Questo comando non è in grado di rimuovere le password preimpostate dalle configurazioni client personalizzate.

Avvia le sessioni tramite la riga di comando

È possibile avviare sessioni remote direttamente dalla riga di comando utilizzando l'eseguibile anydesk.exe .

Comandi di connessione

Questo può essere utile per integrare AnyDesk con script, strumenti di gestione o processi di automazione.

Connettersi a un client

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

Avvia una sessione remota con l'ID o l'alias AnyDesk specificato.

• <ID_or_Alias> - l'indirizzo AnyDesk del client remoto.

• <additional_parameters> - parametri opzionali per personalizzare la sessione. Per ulteriori parametri, vedere Optional session parameters.

Connettiti utilizzando una password

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

Avvia una sessione al client specificato e invia la password specificata per l'accesso automatico.

Parametri di sessione facoltativi

È possibile aggiungere i seguenti parametri ai comandi della sessione per modificare la modalità di avvio della sessione:

Comandi proxy

È possibile configurare le impostazioni del proxy HTTP di AnyDesk utilizzando i parametri della riga di comando. Ciò è particolarmente utile per gli ambienti con criteri di rete rigorosi o in cui è richiesta l'autenticazione proxy.

🦉 Per ulteriori dettagli sulle impostazioni proxy, vedere this article. 

Disabilita l'utilizzo del proxy

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

Imposta la modalità proxy su Nessun proxy in Impostazioni > Connessione > HTTP-Proxy. AnyDesk non tenterà di connettersi tramite un proxy.

Rileva automaticamente il proxy

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

Imposta la modalità proxy su Rileva proxy. AnyDesk tenterà di rilevare un proxy. Se non ne viene trovato nessuno, procederà senza uno.

Configurare un proxy manuale

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

Configura un proxy manuale in Impostazioni > Connessione > HTTP-Proxy.

• <proxy_type>: http, https, o socks

• <address>: Indirizzo del server proxy (IP o URL)

• <port>: Porta utilizzata per connettersi al proxy

• [+force-proxy]: Prova il proxy, fallback alla connessione normale se fallisce (opzionale)

• [-force-proxy]: Delega forzata; Disconnetti se il proxy non è disponibile (facoltativo)

• [--reconnect]: Riavvia la connessione per applicare le nuove impostazioni (opzionale)

Disabilitare l'autenticazione proxy

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

Disabilita l'autenticazione. Imposta l'autenticazione proxy HTTP su Nessuna autenticazione richiesta.

Usa le credenziali di Windows

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

Utilizza le credenziali dell'account Windows per l'autenticazione proxy (NTLM). Imposta l'autenticazione proxy HTTP su NTLM.

Specificare nome utente e password

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

Utilizza il nome utente e la password configurati per l'autenticazione. Imposta il metodo di autenticazione proxy su Imposta nome utente e password.