Informazioni di riferimento su ConnectionManager

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.exe comando [argomenti] [opzioni]

Comandi e argomenti

• add user@host [--portporta] [--passwordpassword] [--privatekeyprivatekey_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]] [--propertykey=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 | [--portporta]]

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

• remove-all

  Rimuove tutte le connessioni archiviate.

• update[ [ | ]] [] [] |

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

• version

  Visualizza informazioni sulla versione.

Opzioni

• --file Filename

  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