Informations de référence sur ConnectionManager

ConnectionManager.exe est un utilitaire de ligne de commande pour gérer les connexions de développement à distance en dehors de Visual Studio. Il est utile pour des tâches telles que l’approvisionnement d’un nouvel ordinateur de développement. Vous pouvez également l’utiliser pour configurer Visual Studio pour l’intégration continue. Vous pouvez l’utiliser dans une fenêtre d’invite de commandes développeur. Pour plus d’informations sur l’invite de commandes développeur, consultez Utiliser l’ensemble d’outils Microsoft C++ à partir de la ligne de commande.

ConnectionManager.exe est disponible dans Visual Studio 2019 version 16.5 et versions ultérieures. Il fait partie de la charge de travail de développement Linux avec C++ dans le programme d’installation de Visual Studio. Il est également installé automatiquement lorsque vous choisissez le composant Gestionnaire de connexions dans le programme d’installation. Il est installé dans %VCIDEInstallDir%\Linux\bin\ConnectionManagerExe\ConnectionManager.exe.

La fonctionnalité de ConnectionManager.exe est également disponible dans Visual Studio. Pour gérer les connexions de développement à distance dans l’IDE, dans la barre de menus, choisissez Outils>Options pour ouvrir la boîte de dialogue Options. Dans la boîte de dialogue Options, sélectionnez Multiplateforme>Gestionnaire de connexions.

Syntaxe

ConnectionManager.execommand [arguments] [options]

Commandes et arguments

• adduser@host [--portport] [--passwordpassword] [--privatekeyprivatekey_file]

  Authentifie et ajoute une nouvelle connexion. Par défaut, la commande utilise le port 22 et l’authentification par mot de passe. (Vous serez invité à entrer un mot de passe.) Utilisez --password et --privatekey pour spécifier un mot de passe pour une clé privée.

• clean

  Supprime le cache d’en-tête pour les connexions qui n’existent plus.

• help

  Affiche un écran d’aide.

• list [--properties]

  Affiche les informations, ID et propriétés de toutes les connexions stockées.
  Pour obtenir des exemples, consultez Propriétés couramment utilisées.

• modify [default | connection_id | user@host [--portport]] [--propertykey=value]

  Définit ou modifie une propriété sur une connexion.
  Si la valeur est vide, la clé de propriété est supprimée.
  En cas d’échec de l’authentification, aucune modification n’est apportée.
  Si aucune connexion n’est spécifiée (comme l’indique default ci-dessus), la connexion à distance par défaut de l’utilisateur est utilisée.

• remove [connection_id | user@host [--portport]]

  Supprime une connexion. Si aucun argument n’est spécifié, vous êtes invité à spécifier la connexion à supprimer.

• remove-all

  Supprime toutes les connexions stockées.

• update [default | all | connection_id | user@host [--portport]] [--previous] [--fingerprint]

  Ajouté dans Visual Studio 16.10. Met à jour l’empreinte digitale de la clé hôte de la ou des connexions spécifiées.

• version

  Affiche les informations de version.

Options

• --filenom_fichier

  Lisez les informations de connexion à partir du nom de fichier (filname) fourni.

• --fingerprint

  Empreinte digitale de la clé hôte présentée par le serveur. Utilisez cette option list pour afficher l’empreinte digitale d’une connexion.

• -i

  Comme pour --privatekey.

• -n, --dry-run

  Effectue une exécution sèche de la commande.

• --no-prompt

  Affiche échec à la place d’une invite, le cas échéant.

• --no-telemetry

  Désactive le renvoi des données d’utilisation à Microsoft. Les données d’utilisation sont collectées et renvoyées à Microsoft, sauf si l’indicateur --no-telemetry est passé.

• --no-verify

  Ajoute ou modifie une connexion sans authentification.

• --p

  Comme pour --password.

• --previous

  Indique que la ou les connexions seront lues à partir de la version précédente du gestionnaire de connexions, mises à jour et écrites dans la nouvelle version.

• -q, --quiet

  Empêche la sortie vers stdout ou stderr.

Exemples

Cette commande ajoute une connexion pour un utilisateur nommé « user » sur localhost. La connexion utilise un fichier de clé pour l’authentification, trouvé dans %USERPROFILE%.ssh\id_rsa.

ConnectionManager.exe add user@127.0.0.1 --privatekey "%USERPROFILE%\.ssh\id_rsa"

Cette commande supprime la connexion qui a l’ID 1975957870 de la liste des connexions.

ConnectionManager.exe remove 1975957870

Propriétés couramment utilisées

Propriété	Description
Type d’authentification	Type d’authentification utilisé pour la connexion, par exemple : "password", "privatekey". Pour créer une connexion avec le type d’authentification défini sur "privatekey" : ConnectionManager.exe add user@127.0.0.1 --privatekey "%USERPROFILE%\.ssh\id_rsa"
default	Valeur booléenne indiquant s’il s’agit de la connexion par défaut. La connexion par défaut est utilisée quand il existe plusieurs connexions disponibles et que celle à utiliser n’est pas spécifiée. Pour définir la connexion spécifiée comme connexion par défaut : ConnectionManager.exe modify -21212121 --property default=true
host	Nom ou adresse IP de l’ordinateur distant. Pour remplacer l’hôte pour la connexion spécifiée par une autre machine, en l’occurrence, un hôte local : ConnectionManager.exe modify -21212121 --property host=127.0.0.1
isWsl	Retourne true si la session à distance exécute le Sous-système Windows pour Linux.
password	Mot de passe pour la connexion. Modifiez le mot de passe de la connexion spécifiée avec : ConnectionManager.exe modify -21212121 --property password="xyz"
platform	Plateforme de l’ordinateur distant, telle que "ARM", "ARM64", "PPC", "PPC64", "x64", "x86".
port	Port utilisé pour la connexion. Modifiez le port pour la connexion spécifiée : ConnectionManager.exe modify -21212121 --property port=22
shell	Interpréteur de commandes préféré à utiliser sur le système distant. Les interpréteurs de commandes pris en charge sont sh, csh, bash, tcsh, ksh, zsh, dash Pour définir l’interpréteur de commandes préféré sur zsh pour l’ordinateur distant sur la connexion spécifiée : ConnectionManager.exe modify -21212121 --property shell=zsh Si l’interpréteur de commandes trouvé sur le système Linux n’est pas pris en charge, sh il est utilisé pour toutes les commandes.
systemID	Type de système distant, tel que "OSX", "Ubuntu".
timeout	Délai d’expiration de la connexion en millisecondes. Remplacez le délai d’expiration de la connexion spécifiée pas : ConnectionManager.exe modify -21212121 --property timeout=100
username	Nom de l’utilisateur connecté à l’ordinateur distant. Pour ajouter une connexion pour un utilisateur nommé "user" sur localhost : ConnectionManager.exe add user@127.0.0.1

Voir aussi

Connexion à votre système Linux cible dans Visual Studio