Referenz zu ConnectionManager
„ConnectionManager.exe“ ist ab Visual Studio 2019 Version 16.5 verfügbar.
„ConnectionManager.exe“ ist ein Befehlszeilenhilfsprogramm zum Verwalten von Remoteentwicklungsverbindungen außerhalb von Visual Studio. Es ist gut für Aufgaben wie die Bereitstellung eines neuen Entwicklungscomputers geeignet. Sie können es auch zum Einrichten von Visual Studio für Continuous Integration verwenden. Sie können das Hilfsprogramm in einem Developer-Eingabeaufforderungsfenster verwenden. Weitere Informationen zur Developer-Eingabeaufforderung finden Sie unter Verwenden des Microsoft C++-Toolsets in der Befehlszeile.
„ConnectionManager.exe“ ist ab Visual Studio 2019 Version 16.5 verfügbar. Das Hilfsprogramm ist Teil der Workload Linux-Entwicklung mit C++. Es wird auch automatisch installiert, wenn Sie die Komponente Verbindungs-Manager im Installationsprogramm auswählen. Es wird in %VCIDEInstallDir%\Linux\bin\ConnectionManagerExe\ConnectionManager.exe installiert.
Die Funktionalität von „ConnectionManager.exe“ ist auch in Visual Studio verfügbar. Wählen Sie zum Verwalten von Remoteentwicklungsverbindungen in der IDE wählen Sie in der Menüleiste Extras>Optionen aus, um das Dialogfeld „Optionen“ zu öffnen. Wählen Sie im Dialogfeld „Optionen“ Plattformübergreifend>Verbindungs-Manager aus.
Syntax
ConnectionManager.exe
command [arguments] [options]
Befehle und Argumente
add
user@host [--port
port] [--password
password] [--privatekey
privatekey_file]Führt die Authentifizierung aus und fügt eine neue Verbindung hinzu. Standardmäßig werden Port 22 und Kennwortauthentifizierung verwendet. (Sie werden aufgefordert, ein Kennwort einzugeben.) Verwenden Sie sowohl -
-password
als auch--privatekey
, um ein Kennwort für einen privaten Schlüssel anzugeben.clean
Hiermit wird Headercache für Verbindungen entfernt, die nicht mehr vorhanden sind.
help
Zeigt einen Hilfebildschirm an.
list
[--properties
]Hiermit werden Informationen, IDs und Eigenschaften aller gespeicherten Verbindungen angezeigt.
Beispiele finden Sie unter Häufig verwendete Eigenschaften.modify
[default | connection_id | user@host [--port
port]] [--property
key=value]Hiermit wird eine Eigenschaft einer Verbindung definiert oder geändert.
Wenn value leer ist, wird die Eigenschaft key gelöscht.
Wenn die Authentifizierung fehlschlägt, werden keine Änderungen vorgenommen.
Wenn keine Verbindung angegeben ist (das ist die Bedeutung von Standard oben), wird die Standardremoteverbindung des Benutzers verwendet.remove
[connection_id | user@host [--port
port]]Entfernt eine Verbindung. Wenn keine Argumente angegeben werden, werden Sie zur Angabe aufgefordert, welche Verbindung entfernt werden soll.
remove-all
Entfernt alle gespeicherten Verbindungen.
update
[default | all | connection_id | user@host [--port
port]] [--previous
] [--fingerprint
]Dieser Befehl wurde in Visual Studio 16.10 hinzugefügt. Mit ihm wird der Fingerabdruck des Hostschlüssels für die angegebenen Verbindungen aktualisiert.
version
Zeigt Versionsinformationen an.
Optionen
--file
DateinameLiest Verbindungsinformationen aus dem bereitgestellten dateinamen.
--fingerprint
Hierbei handelt es sich um den vom Server angegebenen Fingerabdruck des Hostschlüssels. Verwenden Sie diese Option mit
list
, um den Fingerabdruck einer Verbindung anzuzeigen.-i
Wie in
--privatekey
.-n
,--dry-run
Führt einen Probelauf des Befehls aus.
--no-prompt
Fehler anstatt Eingabeaufforderung, wenn zutreffend.
--no-telemetry
Deaktiviert das Senden von Nutzungsdaten an Microsoft. Nutzungsdaten werden erfasst und an Microsoft gesendet, es sei denn, das Flag
--no-telemetry
wird übergeben.--no-verify
Fügt eine Verbindung ohne Authentifizierung hinzu oder ändert sie.
--p
Wie in
--password
.--previous
Hiermit wird angegeben, dass die Verbindungen aus der vorherigen Version des Verbindungs-Managers gelesen, aktualisiert und in die neue Version geschrieben werden.
-q
,--quiet
Verhindert die Ausgabe an
stdout
oderstderr
.
Beispiele
Mit diesem Befehl wird eine Verbindung für einen Benutzer namens „User“ auf „localhost“ hinzugefügt. Die Verbindung verwendet eine Schlüsseldatei für die Authentifizierung, die in %USERPROFILE%.ssh\id_rsa enthalten ist.
ConnectionManager.exe add user@127.0.0.1 --privatekey "%USERPROFILE%\.ssh\id_rsa"
Mit diesem Befehl wird die Verbindung mit der ID 1975957870 aus der Liste der Verbindungen entfernt.
ConnectionManager.exe remove 1975957870
Häufig verwendete Eigenschaften
Eigenschaft | BESCHREIBUNG |
---|---|
Authentifizierungstyp | Der Authentifizierungstyp, der für die Verbindung verwendet wird, z. B.: "password" , "privatekey" .So erstellen Sie eine Verbindung, bei der der Authentifizierungstyp auf "privatekey" festgelegt ist: ConnectionManager.exe add user@127.0.0.1 --privatekey "%USERPROFILE%\.ssh\id_rsa" |
default |
Ein boolescher Wert, der angibt, ob dies die Standardverbindung ist. Die Standardverbindung wird verwendet, wenn mehr als eine Verbindung verfügbar ist und die zu verwendende Verbindung nicht angegeben wurde. So legen Sie die angegebene Verbindung als Standardverbindung fest: ConnectionManager.exe modify -21212121 --property default=true |
host |
Der Name oder die IP-Adresse des Remotecomputers. So ändern Sie den Host für die angegebene Verbindung in einen anderen Computer, in diesem Fall den lokalen Host: ConnectionManager.exe modify -21212121 --property host=127.0.0.1 |
isWsl |
Gibt TRUE zurück, wenn die Remotesitzung „Windows-Subsystem für Linux“ ausführt. |
password |
Das Kennwort für die Verbindung. Ändern Sie das Kennwort für die angegebene Verbindung mit: ConnectionManager.exe modify -21212121 --property password="xyz" |
platform |
Die Plattform des Remotecomputers, z. B. "ARM" , "ARM64" , "PPC" , "PPC64" , "x64" , "x86" . |
port |
Der für die Verbindung verwendete Port. Ändern Sie den Port für die angegebene Verbindung: ConnectionManager.exe modify -21212121 --property port=22 |
shell |
Die bevorzugte Shell, die auf dem Remotesystem verwendet werden soll. Unterstützte Shells sind sh, csh, bash, tcsh, ksh, zsh, dash So legen Sie die bevorzugte Shell für den Remotecomputer unter der angegebenen Verbindung auf „zsh“ fest: ConnectionManager.exe modify -21212121 --property shell=zsh Wenn die im Linux-System gefundene Shell nicht unterstützt wird, wird sh für alle Befehle verwendet. |
systemID |
Der Remotesystemtyp, z. B. "OSX" , "Ubuntu" . |
timeout |
Das Verbindungstimeout in Millisekunden. Ändern Sie das Timeout für die angegebene Verbindung mit: ConnectionManager.exe modify -21212121 --property timeout=100 |
username |
Der Name des Benutzers, der am Remotecomputer angemeldet ist. So fügen Sie eine Verbindung für einen Benutzer namens "user" auf localhost hinzu: ConnectionManager.exe add user@127.0.0.1 |
Siehe auch
Herstellen einer Verbindung mit dem Linux-Zielsystem in Visual Studio