Dela via

ConnectionManager-referens

ConnectionManager.exe finns i Visual Studio 2019 version 16.5 och senare.

ConnectionManager.exe är ett kommandoradsverktyg för att hantera fjärrutvecklingsanslutningar utanför Visual Studio. Det är användbart för uppgifter som att etablera en ny utvecklingsdator. Du kan också använda den för att konfigurera Visual Studio för kontinuerlig integrering. Du kan använda den i kommandotolken för utvecklare. Mer information om kommandotolken för utvecklare finns i Använda Microsoft C++-verktygsuppsättningen från kommandoraden.

ConnectionManager.exe finns i Visual Studio 2019 version 16.5 och senare. Det är en del av Linux-utvecklingen med C++ -arbetsbelastningen i Visual Studio Installer. Den installeras också automatiskt när du väljer Anslutningshanteraren-komponenten i installationsprogrammet. Den är installerad i %VCIDEInstallDir%\Linux\bin\ConnectionManagerExe\ConnectionManager.exe.

Funktionerna ConnectionManager.exe i är också tillgängliga i Visual Studio. Om du vill hantera fjärrutvecklingsanslutningar i IDE går du till menyraden och väljer Verktygsalternativ> för att öppna dialogrutan Alternativ. I dialogrutan Alternativ väljer du Plattformsoberoende>anslutningshanterare.

Syntax

ConnectionManager.exe kommando [argument] [alternativ]

Kommandon och argument

  • add user@host [--portport] [--passwordlösenord] [--privatekeyprivatekey_file]

    Autentiserar och lägger till en ny anslutning. Som standard används port 22- och lösenordsautentisering. (Du uppmanas att ange ett lösenord.)

    Du kan använda antingen ett lösenord eller en nyckelfil och lösenfras för autentisering. Nyckelfiler är säkrare än användarnamn/lösenord. Om du redan har ett nyckelpar kan du återanvända det. Använd båda --password och --privatekey för att ange en lösenfras för en privat nyckelfil.

    Versioner av Visual Studio före 17.10 stöder Elliptic Curve (EC), Rivert-Shamir-Adleman (RSA) och DSA-nycklar (Digital Signature Algorithm) för fjärranslutningar. På grund av säkerhetsproblem stöds inte längre RSA- och DSA-nycklar i VS 17.10 och senare. För närvarande stöds endast EC-nycklar.

    Om du vill skapa ett nyckelpar som är kompatibelt med anslutningshanteraren använder du kommandot ssh-keygen -m pem -t ecdsa -f <key-name>. Om du använder ssh-keygen för att skapa den privata nyckeln måste du ange växeln -m pem, annars accepteras inte nyckeln av Visual Studio. Om din privata nyckel börjar med -----BEGIN OPENSSH PRIVATE KEY-----måste du konvertera den med ssh-keygen -p -f <FILE> -m pem.

  • clean

    Tar bort huvudcachen för anslutningar som inte längre finns.

  • help

    Visar en hjälpskärm.

  • list [--properties]

    Visar information, ID:t och egenskaper för alla lagrade anslutningar.
    Exempel finns i Vanliga egenskaper.

  • modify [standard | connection_id | user@host [--portport]] [--propertykey=value]

    Definierar eller ändrar en egenskap för en anslutning.
    Om värdet är tomt tas egenskapsnyckeln bort.
    Om autentiseringen misslyckas görs inga ändringar.
    Om ingen anslutning anges används användarens standardanslutning.

  • remove [connection_id | user@host [--portport]]

    Tar bort en anslutning. Om inga argument anges uppmanas du att ange vilken anslutning som ska tas bort.

  • remove-all

    Tar bort alla lagrade anslutningar.

  • update[standard | alla | connection_id | user@host [--portport]] [--previous] [--fingerprint]

    Lades till i Visual Studio 16.10. Uppdaterar värdnyckelns fingeravtryck för de angivna anslutningarna.

  • version

    Visar versionsinformation.

Alternativ

  • --file filnamn

    Läs anslutningsinformation från det angivna filnamnet.

  • --fingerprint

    Fingeravtrycket för värdnyckeln som presenteras av servern. Använd det här alternativet med list för att visa en anslutnings fingeravtryck.

  • -i

    Samma som --privatekey.

  • -n, --dry-run

    Utför en torr körning av kommandot.

  • --no-prompt

    Misslyckas i stället för uppmana, när det är lämpligt.

  • --no-telemetry

    Inaktivera att skicka användningsdata tillbaka till Microsoft. Användningsdata samlas in och skickas tillbaka till Microsoft om inte --no-telemetry flaggan skickas.

  • --no-verify

    Lägga till eller ändra en anslutning utan autentisering.

  • --p

    Samma som --password.

  • --previous

    Anger att anslutningarna ska läsas från den tidigare versionen av anslutningshanteraren, uppdateras och skrivas till den nya versionen.

  • -q, --quiet

    Förhindrar utdata till stdout eller stderr.

Exempel

Det här kommandot lägger till en anslutning för en användare med namnet "användare" på localhost. Anslutningen använder en nyckelfil för autentisering som finns i %USERPROFILE%.ssh\id_rsa.

ConnectionManager.exe add user@127.0.0.1 --privatekey "%USERPROFILE%\.ssh\id_rsa"

Det här kommandot tar bort anslutningen som har ID 1975957870 från listan över anslutningar.

ConnectionManager.exe remove 1975957870

Vanliga egenskaper

Fastighet Beskrivning
autentiseringstyp Den typ av autentisering som används för anslutningen, till exempel: "password", "privatekey".
Så här skapar du en anslutning med autentiseringstypen inställd på "privatekey": ConnectionManager.exe add user@127.0.0.1 --privatekey "%USERPROFILE%\.ssh\id_rsa"
default Ett booleskt värde som anger om detta är standardanslutningen. Standardanslutningen används när det finns fler än en tillgänglig anslutning och den som ska användas inte har angetts.
Så här anger du den angivna anslutningen som standardanslutning: ConnectionManager.exe modify -21212121 --property default=true
host Fjärrdatorns namn eller IP-adress.
Om du vill ändra värden för den angivna anslutningen till en annan dator, i det här fallet lokal värd: ConnectionManager.exe modify -21212121 --property host=127.0.0.1
isWsl Returnerar sant om fjärrsessionen kör Windows-undersystemet för Linux.
password Lösenordet för anslutningen. Ändra lösenordet för den angivna anslutningen med: ConnectionManager.exe modify -21212121 --property password="xyz"
platform Plattformen för fjärrdatorn, till exempel "ARM", "ARM64", "PPC", "PPC64", "x64", "x86".
port Porten som används för anslutningen.
Ändra porten för den angivna anslutningen: ConnectionManager.exe modify -21212121 --property port=22
shell Det önskade gränssnittet som ska användas på fjärrsystemet. Gränssnitt som stöds är sh, csh, bash, tcsh, ksh, zsh, dash
Så här anger du det önskade gränssnittet till zsh för fjärrdatorn på den angivna anslutningen: ConnectionManager.exe modify -21212121 --property shell=zsh
Om gränssnittet som finns i Linux-systemet inte stöds används det sh för alla kommandon.
systemID Fjärrsystemtypen, till exempel "OSX", "Ubuntu".
timeout Tidsgränsen för anslutningen i millisekunder. Ändra tidsgränsen för den angivna anslutningen med: ConnectionManager.exe modify -21212121 --property timeout=100
username Namnet på den användare som är inloggad på fjärrdatorn.
Så här lägger du till en anslutning för en användare med namnet "user" på localhost: ConnectionManager.exe add user@127.0.0.1

Se även

Ansluta till ditt Linux-målsystem i Visual Studio