Informations de référence sur ConnectionManager

Article
10/16/2024

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 [--port port] [--password password] [--privatekey privatekey_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 [default | connection_id | user@host [--port port]] [--property key=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 [--port port]]

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 [--port port]] [--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

--file filename

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

Partager via