Freigeben über

Referenz zu ConnectionManager

  • Artikel

ConnectionManager.exe ist in Visual Studio 2019, Version 16.5 und höher, 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 in Visual Studio 2019, Version 16.5 und höher, 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 ist installiert in %VCIDEInstallDir%\Linux\bin\ConnectionManagerExe\ConnectionManager.exe.

Die Funktionalität ist ConnectionManager.exe 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.)

    Sie können entweder ein Kennwort oder eine Schlüsseldatei und eine Passphrase zur Authentifizierung verwenden. Schlüsseldateien sind sicherer als Benutzername/Kennwort. Wenn Sie bereits über ein Schlüsselpaar verfügen, ist es möglich, dieses wiederzuverwenden. Verwenden Sie sowohl eine Passphrase als auch --password --privatekey eine Passphrase für eine private Schlüsseldatei.

    Versionen von Visual Studio vor 17.10 unterstützen Elliptic Curve (EC), Rivert-Shamir-Adleman (RSA) und DSA-Schlüssel (Digital Signature Algorithm) für Remoteverbindungen. Aufgrund von Sicherheitsbedenken werden RSA- und DSA-Schlüssel in VS 17.10 und höher nicht mehr unterstützt. Derzeit werden nur EC-Schlüssel unterstützt.

    Verwenden Sie den Befehl ssh-keygen -m pem -t ecdsa -f <key-name>, um ein Schlüsselpaar zu erstellen, das mit dem Verbindungs-Manager kompatibel ist. Wenn Sie ssh-keygen den privaten Schlüssel erstellen, müssen Sie die Option -m pemangeben, oder der Schlüssel wird von Visual Studio nicht akzeptiert. Wenn Ihr privater Schlüssel mit -----BEGIN OPENSSH PRIVATE KEY----- beginnt, müssen Sie ihn mit ssh-keygen -p -f <FILE> -m pem konvertieren.

  • 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, wird die Standard-Remoteverbindung 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 Dateiname

    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