Informazioni di riferimento su ConnectionManager

  • Articolo

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. Verrà richiesto di immettere una password. Usare sia --password che --privatekey per specificare una password per una chiave privata.

  • 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 (per impostazione predefinita, sopra), 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