Informazioni di riferimento su ConnectionManager

Articolo
10/16/2024

ConnectionManager.exe è disponibile in Visual Studio 2019 versione 16.5 e successive.

ConnectionManager.exe è un'utilità della riga di comando per gestire le connessioni di sviluppo remoto all'esterno di Visual Studio. È utile per attività come il provisioning di un nuovo computer di sviluppo. In alternativa, usarlo per configurare Visual Studio per l'integrazione continua. È possibile usarlo in una finestra del prompt dei comandi per gli sviluppatori. Per altre informazioni sul prompt dei comandi per gli sviluppatori, vedere Usare il set di strumenti Microsoft C++ dalla riga di comando.

ConnectionManager.exe è disponibile in Visual Studio 2019 versione 16.5 e successive. Fa parte del carico di lavoro Sviluppo linux con C++ nel Programma di installazione di Visual Studio. Viene installato automaticamente anche quando si sceglie il componente Gestione connessioni nel programma di installazione. Viene installato in %VCIDEInstallDir%\Linux\bin\ConnectionManagerExe\ConnectionManager.exe.

La funzionalità di ConnectionManager.exe è disponibile anche in Visual Studio. Per gestire le connessioni di sviluppo remoto nell'IDE, nella barra dei menu scegliere Opzioni strumenti>per aprire la finestra di dialogo Opzioni. Nella finestra di dialogo Opzioni selezionare Multipiattaforma> Gestione connessioni.

Sintassi

ConnectionManager.execomando [argomenti] [opzioni]

Comandi e argomenti

add user@host [--port porta] [--password password] [--privatekey privatekey_file]

Autentica e aggiunge una nuova connessione. Per impostazione predefinita, usa la porta 22 e l'autenticazione della password. Viene richiesto di immettere una password.

È possibile usare una password o un file di chiave e una passphrase per l'autenticazione. I file di chiave sono più sicuri rispetto a nome utente/password. Se si ha già una coppia di chiavi, è possibile riutilizzarla. Usare sia --password che --privatekey per specificare una passphrase per un file di chiave privata.

Le versioni di Visual Studio precedenti alla 17.10 supportano le chiavi Elliptic Curve (EC), Rivert-Shamir-Adleman (RSA) e Digital Signature Algorithm (DSA) per le connessioni remote. A causa dei problemi di sicurezza, le chiavi RSA e DSA non sono più supportate in VS 17.10 e versioni successive. Attualmente sono supportate solo le chiavi EC.

Per creare una coppia di chiavi compatibile con la gestione connessione, usare il comando ssh-keygen -m pem -t ecdsa -f <key-name>. Se si usa ssh-keygen per creare la chiave privata, è necessario specificare l'opzione -m pemoppure la chiave non verrà accettata da Visual Studio. Se la chiave privata inizia con -----BEGIN OPENSSH PRIVATE KEY-----, è necessario convertirla con ssh-keygen -p -f <FILE> -m pem.
clean

Elimina la cache delle intestazioni per le connessioni che non esistono più.
help

Visualizza una schermata della Guida.
list [--properties]

Visualizza informazioni, ID e proprietà di tutte le connessioni archiviate.
Per esempi, vedere Proprietà comunemente usate.
modify[impostazione predefinita | connection_id user@host | [ --port porta]] [--property key=value]

Definisce o modifica una proprietà in una connessione.
Se il valore è vuoto, la chiave della proprietà viene eliminata.
Se l'autenticazione non riesce, non verranno apportate modifiche.
Se non viene specificata alcuna connessione, viene usata la connessione remota predefinita dell'utente.
remove[connection_id user@host | [--port porta]]

Rimuove una connessione. Se non vengono specificati argomenti, viene richiesto di specificare la connessione da rimuovere.
remove-all

Rimuove tutte le connessioni archiviate.
update[impostazione predefinita | tutte le | connection_id user@host | [--port porta]] [] []--previous--fingerprint

Aggiunta in Visual Studio 16.10. Aggiorna l'impronta digitale della chiave host delle connessioni specificate.
version

Visualizza informazioni sulla versione.

Opzioni

--fileFilename

Leggere le informazioni di connessione dal nome file specificato.
--fingerprint

Impronta digitale della chiave host presentata dal server. Usare questa opzione con list per visualizzare l'impronta digitale di una connessione.
-i

Uguale a --privatekey.
-n, --dry-run

Esegue un'esecuzione secca del comando.
--no-prompt

Non eseguire il prompt, se appropriato.
--no-telemetry

Disabilitare l'invio dei dati di utilizzo a Microsoft. I dati di utilizzo vengono raccolti e inviati a Microsoft a meno che il --no-telemetry flag non venga passato.
--no-verify

Aggiungere o modificare una connessione senza autenticazione.
--p

Uguale a --password.
--previous

Indica che le connessioni verranno lette dalla versione precedente della gestione connessione, aggiornata e scritta nella nuova versione.
-q, --quiet

Impedisce l'output in stdout o stderr.

Esempi

Questo comando aggiunge una connessione per un utente denominato "user" in localhost. La connessione usa un file di chiave per l'autenticazione, disponibile in %USERPROFILE%.ssh\id_rsa.

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

Questo comando rimuove la connessione con ID 1975957870 dall'elenco di connessioni.

ConnectionManager.exe remove 1975957870

Proprietà di uso comune

Proprietà	Descrizione
tipo di autenticazione	Tipo di autenticazione usata per la connessione, ad esempio : `"password"`, `"privatekey"`. Per creare una connessione con il tipo di autenticazione impostato su `"privatekey"`: `ConnectionManager.exe add user@127.0.0.1 --privatekey "%USERPROFILE%\.ssh\id_rsa"`
`default`	Valore booleano che indica se si tratta della connessione predefinita. La connessione predefinita viene usata quando sono disponibili più connessioni e quella da usare non è specificata. Per impostare la connessione specificata come connessione predefinita: `ConnectionManager.exe modify -21212121 --property default=true`
`host`	Nome o indirizzo IP del computer remoto. Per modificare l'host per la connessione specificata a un altro computer, in questo caso l'host locale: `ConnectionManager.exe modify -21212121 --property host=127.0.0.1`
`isWsl`	Restituisce true se la sessione remota è in esecuzione sottosistema Windows per Linux.
`password`	Password della connessione. Modificare la password per la connessione specificata con: `ConnectionManager.exe modify -21212121 --property password="xyz"`
`platform`	Piattaforma del computer remoto, `"ARM"`ad esempio , `"ARM64"`, `"PPC""PPC64"`, `"x64""x86"`.
`port`	Porta utilizzata per la connessione. Modificare la porta per la connessione specificata: `ConnectionManager.exe modify -21212121 --property port=22`
`shell`	Shell preferita da usare nel sistema remoto. Le shell supportate sono `sh, csh, bash, tcsh, ksh, zsh, dash` Per impostare la shell preferita come zsh per il computer remoto nella connessione specificata: `ConnectionManager.exe modify -21212121 --property shell=zsh` Se la shell trovata nel sistema Linux non è supportata, `sh` viene usata per tutti i comandi.
`systemID`	Tipo di sistema remoto, ad esempio `"OSX"`, `"Ubuntu"`.
`timeout`	Timeout della connessione in millisecondi. Modificare il timeout per la connessione specificata con: `ConnectionManager.exe modify -21212121 --property timeout=100`
`username`	Nome dell'utente connesso al computer remoto. Per aggiungere una connessione per un utente denominato `"user"` in localhost: `ConnectionManager.exe add user@127.0.0.1`

Vedi anche

Connettersi al sistema Linux di destinazione in Visual Studio

Condividi tramite