Referenz zu ConnectionManager

„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.execommand [arguments] [options]

Befehle und Argumente

• adduser@host [--portport] [--passwordpassword] [--privatekeyprivatekey_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 [--portport]] [--propertykey=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 [--portport]]

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

• --filefilename

  Liest 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 oder stderr.

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