Informations de référence sur ConnectionManager

ConnectionManager.exe est disponible dans Visual Studio 2019 version 16.5 et ultérieure.

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 ultérieure. 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.

Les fonctionnalités sont ConnectionManager.exe également disponibles 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.exe commande [arguments] [options]

Commandes et arguments

• add user@host [--portport] [--passwordmot de passe] [--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 êtes invité à entrer un mot de passe.)

  Vous pouvez utiliser un mot de passe ou un fichier de clé avec une phrase secrète pour l’authentification. Les fichiers clés sont plus sécurisés que le nom d’utilisateur/mot de passe. Si vous avez déjà une paire de clés, il est possible de la réutiliser. Utilisez les deux --password et --privatekey spécifiez une phrase secrète pour un fichier de clé privée.

  Les versions de Visual Studio antérieures à la version 17.10 prennent en charge les clés Elliptic Curve (EC), Rivert-Shamir-Adleman (RSA) et DSA (Digital Signature Algorithm) pour les connexions à distance. Pour des raisons de sécurité, les clés RSA et DSA ne sont plus prises en charge dans Visual Studio 17.10 et les versions ultérieures. Seules les clés EC sont prises en charge.

  Pour créer une paire de clés compatible avec le gestionnaire de connexions, utilisez la commande ssh-keygen -m pem -t ecdsa -f <key-name>. Si vous utilisez ssh-keygen pour créer la clé privée, vous devez spécifier le commutateur -m pem, ou la clé n’est pas acceptée par Visual Studio. Si votre clé privée commence par -----BEGIN OPENSSH PRIVATE KEY-----, vous devez la convertir avec ssh-keygen -p -f <FILE> -m pem.

• 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[par défaut | | connection_iduser@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, la connexion distante 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[par défaut | tout | 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.

Paramètres

• --file nom de 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

Voir aussi

Connexion à votre système Linux cible dans Visual Studio