Interface de ligne de commande pour Windows

L’AnyDesk Interface de ligne de commande (CLI) permet aux administrateurs et aux utilisateurs avancés d’automatiser l’installation, la configuration, le client et Gestion de session, ainsi que les paramètres réseau. Cet article explique comment utiliser les commandes AnyDesk dans l’invite de commande Windows ou dans des scripts tels que des fichiers batch pour rationaliser les déploiements et l’administration.

🚨 IMPORTANT
Toutes les commandes doivent être exécutées à partir du répertoire où AnyDesk.exe se trouve, ou le chemin d’accès complet de l’exécutable doit être spécifié.

L’emplacement de l’exécutable AnyDesk dépend du type de client :

Les clients standard téléchargés à partir de anydesk.com sont généralement installés sur :
C:\Program Files (x86)\AnyDesk\AnyDesk.exe
Les clients personnalisés générés via my.anydesk.com sont généralement installés pour :
C:\Program Files (x86)\AnyDesk-<prefix>\AnyDesk-<prefix>.exe
Il s’agit <prefix> d’un identifiant unique pour votre compte. Vous pouvez le trouver dans my.anydesk >onglet Builds > sélectionner le > de build souhaité dans la section Général , vérifiez le champ Préfixe .

Installation

Cette section fournit des instructions pour l’installation ou la mise à jour du client Windows AnyDesk à l’aide de la ligne de commande. Vous pouvez utiliser ces commandes dans des scripts, des processus de déploiement du système ou lors d’une configuration manuelle. Les paramètres d’installation vous permettent de définir des comportements d’installation spécifiques, tels que la création de raccourcis, le mode silencieux et les préférences de mise à jour.

Commandes d’installation

Pour installer ou mettre à jour AnyDesk à l’aide de l’interface de ligne de commande, utilisez le format de commande suivant :

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

Par exemple:

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

Pour les déploiements basés sur MSI :

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

Paramètres d’installation

Paramètre	Description
--install <emplacement>	Installe AnyDesk à l’emplacement spécifié (par exemple, `C:\Program Files (x86)\AnyDesk`).
--commencer-par-gagner	Configure AnyDesk pour qu’il se lance automatiquement avec Windows.
--create-shortcuts	Ajoute un raccourci du menu Démarrer.
--create-desktop-icon	Ajoute un raccourci sur le bureau.
--supprimer-d’abord	Désinstalle la version actuelle avant d’en installer une nouvelle. Utile pour les mises à jour manuelles.
--silencieux	Exécute l’installation sans interface utilisateur ni invites d’erreur.
--update-manually	Active les mises à jour manuelles (par défaut pour le client personnalisé).
--update-disabled	Désactive les mises à jour AnyDesk.
--update-auto	Active les mises à jour automatiques (par défaut pour les clients standard ; non disponible pour les clients personnalisés

Client AnyDesk

L’exécutable AnyDesk (anydesk.exe) offre un large éventail de commandes qui permettent aux administrateurs de contrôler et de configurer le client. Ces commandes peuvent être utilisées individuellement ou dans des scripts d’automatisation pour rationaliser les tâches administratives sur plusieurs systèmes.

Commandes du client

Les exemples ci-dessous montrent comment utiliser les commandes clés du client, telles que l’enregistrement d’une clé de licence ou la définition d’un mot de passe Accès sans surveillance . Ces commandes sont fréquemment utilisées lors de la configuration initiale ou de l’automatisation de la configuration du client.

Commander	Description
anydesk.exe <paramètre>	Pour obtenir la liste complète des options disponibles, reportez-vous à la Client command parameters.
'écho <license_key> "\| anydesk.exe --register-license	Enregistre la clé de licence spécifiée. Nécessite des privilèges d’administrateur.
'écho <my_password> "\| anydesk.exe --set-password	Définit le mot de passe spécifié pour l’accès sans surveillance.

Paramètres de commande du client

Ce tableau répertorie les paramètres de ligne de commande individuels disponibles pour le client AnyDesk. Ces paramètres peuvent être utilisés pour anydesk.exe configurer ou contrôler directement le client, et sont couramment utilisés dans les scripts ou les configurations administratives.

Paramètre	Description
--désinstaller	Désinstalle AnyDesk à l’aide d’une invite graphique.
--enlever	Désinstalle AnyDesk en mode silencieux sans aucune invite ni interface utilisateur.
--commencer	Démarre le service d’arrière-plan AnyDesk.
--stop-service	Arrête le service d’arrière-plan AnyDesk.
--restart-service	Redémarre le service d’arrière-plan AnyDesk.
--supprimer-mot-de-passe	Supprime le mot de passe d’accès sans surveillance (droits d’administrateur requis). Note: Cela ne peut pas supprimer les mots de passe prédéfinis des clients personnalisés.
--remove-license	Supprime la clé de licence du client. Note: Cela ne déconnecte pas les utilisateurs connectés via leur compte.
--get-alias	Affiche l’alias AnyDesk. Généralement utilisé dans les scripts.
--get-id	Affiche l’ID AnyDesk. Généralement utilisé dans les scripts.
--get-status	Affiche l’état en ligne du client.
--Version	Affiche la version installée d’AnyDesk.
--Paramètres	Ouvre la page des paramètres par défaut (locaux).
--admin-settings	Ouvre la page des paramètres globaux (niveau administrateur).
--settings :<viable_parameter>	Ouvre la section des paramètres spécifiés. Paramètres pris en charge : `ui`, , , `videocapturerecordingfile_transferlicenseprivacywolaudioprinterconnectionsecurityaliasabout`
--admin-settings :<viable_parameter>	Ouvre la section spécifiée des paramètres globaux. Paramètres pris en charge : `capture`, `security`, `connection`, `recording`
--démenti	Affiche le message d’avertissement personnalisé. Ne fonctionne que pour les clients personnalisés avec cette option activée.

Exemple de script batch pour obtenir 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

Commandes de profil d’autorisation (AnyDesk 7+)

Les profils d’autorisation permettent aux administrateurs de définir des paramètres de contrôle d’accès personnalisés pour les sessions à distance. Ces profils peuvent être créés, configurés et gérés via la ligne de commande. Ceci est pris en charge dans AnyDesk version 7 et ultérieures.

Créer un profil d’autorisation

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

Crée un profil d’autorisation nommé <name>. Par défaut, toutes les autorisations sont désactivées. Permet +<permission> d’activer des autorisations spécifiques, séparées par des espaces.

Autorisations prises en charge :

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

Créer un profil avec un mot de passe d’accès sans surveillance

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

Crée un profil d’autorisation nommé <name> avec le mot de passe d’accès sans assistance spécifié. Les autorisations doivent être définies de la même manière que ci-dessus.

Définir un mot de passe pour un profil existant

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

Attribue ou met à jour le mot de passe d’accès sans surveillance pour le profil spécifié.

Pour les profils personnalisés : utilisez le nom du profil d’autorisation.
Pour les profils par défaut, utilisez :
- _default –Faire défaut
- _full_access – Accès complet
- _screen_sharing – Partage d’écran
- _unattended_access – Unattended Access

Supprimer un mot de passe d’un profil

anydesk.exe --remove-password <profile>

Supprime le mot de passe d’accès sans assistance du profil spécifié.

💡 NOTE
Cette commande ne peut pas supprimer les mots de passe prédéfinis des configurations client personnalisées.

Démarrer des sessions via la ligne de commande

Vous pouvez lancer des sessions à distance directement à partir de la ligne de commande à l’aide de l’exécutable anydesk.exe .

Commandes de connexion

Cela peut être utile pour intégrer AnyDesk à des scripts, des outils de gestion ou des processus d’automatisation.

Se connecter à un client

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

Démarre une session à distance à partir de l’ID ou de l’alias AnyDesk spécifié.

<ID_or_Alias> - l’adresse AnyDesk du client distant.
<additional_parameters> - Paramètres optionnels pour personnaliser la session. Pour plus d’informations sur les paramètres, reportez-vous à la Optional session parameters.

Se connecter à l’aide d’un mot de passe

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

Démarre une session sur le client spécifié et envoie le mot de passe donné pour l’accès sans surveillance.

Paramètres de session facultatifs

Vous pouvez ajouter les paramètres suivants aux commandes de session pour modifier le mode de démarrage de la session :

Commander	Description
--transfert-de-fichiers	Démarre une session de transfert de fichiers.
--plein-écran	Démarre une session en mode plein écran.
--plaine	Démarre une session dans une fenêtre sans bordures ni options de menu.

Commandes proxy

Vous pouvez configurer les paramètres de proxy HTTP d’AnyDesk à l’aide des paramètres de ligne de commande. Ceci est particulièrement utile pour les environnements avec des politiques réseau strictes ou où l’authentification proxy est requise.

🦉 Pour plus d’informations sur les paramètres de proxy, reportez-vous à la section this article.

Désactiver l’utilisation du proxy

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

Définit le mode proxy sur Aucun proxy sous Paramètres > Connexion > HTTP-Proxy. AnyDesk ne tentera pas de se connecter via un proxy.

Détection automatique du proxy

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

Définit le mode proxy sur Détecter le proxy. AnyDesk tentera de détecter un proxy. S’il n’en trouve pas, il continuera sans qu’il y en ait.

Configurer un proxy manuel

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

Configure un proxy manuel sous Paramètres > Connexion > HTTP-Proxy.

<proxy_type>: , httphttps, ousocks
<address>: Adresse du serveur proxy (IP ou URL)
<port>: Port utilisé pour se connecter au proxy
[+force-proxy]: Essayer le proxy, revenir à la connexion normale en cas d’échec (facultatif)
[-force-proxy]: Forcer le proxy ; Déconnecter si le proxy n’est pas disponible (facultatif)
[--reconnect]: Redémarre la connexion pour appliquer les nouveaux paramètres (facultatif)

Désactiver l’authentification proxy

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

Désactive l’authentification. Définit l’authentification HTTP-Proxy sur Aucune authentification requise.

Utiliser les informations d’identification Windows

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

Utilise les informations d’identification du compte Windows pour l’authentification proxy (NTLM). Définit l’authentification HTTP-Proxy sur NTLM.

Spécifiez le nom d’utilisateur et le mot de passe

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

Utilise le nom d’utilisateur et le mot de passe configurés pour l’authentification. Définit la méthode d’authentification proxy sur Configurer le nom d’utilisateur et le mot de passe.