ConnectionManager-referentie

ConnectionManager.exe is een opdrachtregelprogramma voor het beheren van externe ontwikkelverbindingen buiten Visual Studio. Dit is handig voor taken zoals het inrichten van een nieuwe ontwikkelcomputer. Of gebruik deze om Visual Studio in te stellen voor continue integratie. U kunt deze gebruiken in een opdrachtpromptvenster voor ontwikkelaars. Voor meer informatie over de Ontwikkelaar Opdrachtprompt, zie De Microsoft C++-toolset van de opdrachtregel gebruiken.

ConnectionManager.exe is beschikbaar in Visual Studio 2019 versie 16.5 en hoger. Het maakt deel uit van de Linux-ontwikkeling met C++ -workload in het Visual Studio Installer. Deze wordt ook automatisch geïnstalleerd wanneer u het onderdeel Verbindingsbeheer in het installatieprogramma kiest. Het is geïnstalleerd in %VCIDEInstallDir%\Linux\bin\ConnectionManagerExe\ConnectionManager.exe.

De functionaliteit van ConnectionManager.exe is ook beschikbaar in Visual Studio. Als u externe ontwikkelverbindingen in de IDE wilt beheren, kiest u op de menubalk Extra>opties om het dialoogvenster Opties te openen. Selecteer Cross Platform>Connection Manager in het dialoogvenster Opties.

Syntaxis

ConnectionManager.exe opdracht [argumenten] [opties]

Opdrachten en argumenten

• add user@host [--port] [--passwordwachtwoord] [--privatekeyprivatekey_file]

  Hiermee wordt een nieuwe verbinding geverifieerd en toegevoegd. Standaard wordt poort 22 en wachtwoordverificatie gebruikt. (U wordt gevraagd een wachtwoord in te voeren.)

  U kunt een wachtwoord of een sleutelbestand en wachtwoordzin voor verificatie gebruiken. Sleutelbestanden zijn veiliger dan gebruikersnaam/wachtwoord. Als u al een sleutelpaar hebt, is het mogelijk om het opnieuw te gebruiken. Gebruik beide --password en --privatekey geef een wachtwoordzin op voor een bestand met een persoonlijke sleutel.

  Versies van Visual Studio vóór 17.10 ondersteunen Elliptic Curve (EC), Rivert-Shamir-Adleman (RSA) en DSA-sleutels (Digital Signature Algorithm) voor externe verbindingen. Vanwege beveiligingsproblemen worden RSA- en DSA-sleutels niet meer ondersteund in VS 17.10 en hoger. Momenteel worden alleen EC-sleutels ondersteund.

  Gebruik de opdracht ssh-keygen -m pem -t ecdsa -f <key-name>om een sleutelpaar te maken dat compatibel is met het verbindingsbeheer. Als u de persoonlijke sleutel met ssh-keygen maakt, moet u de optie -m pem opgeeft of wordt de sleutel niet geaccepteerd door Visual Studio. Als uw persoonlijke sleutel begint met -----BEGIN OPENSSH PRIVATE KEY-----, moet u deze converteren met ssh-keygen -p -f <FILE> -m pem.

• clean

  Hiermee verwijdert u de headercache voor verbindingen die niet meer bestaan.

• help

  Geeft een Help-scherm weer.

• list [--properties]

  Geeft informatie, id's en eigenschappen van alle opgeslagen verbindingen weer.
  Zie Veelgebruikte eigenschappen voor voorbeelden.

• modify[standaard | connection_id | user@host [--portpoort]] [--propertykey=value]

  Hiermee definieert of wijzigt u een eigenschap in een verbinding.
  Als de waarde leeg is, wordt de eigenschapssleutel verwijderd.
  Als de verificatie mislukt, worden er geen wijzigingen aangebracht.
  Als er geen verbinding is opgegeven, wordt de standaard externe verbinding van de gebruiker gebruikt.

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

  Hiermee verwijdert u een verbinding. Als er geen argumenten zijn opgegeven, wordt u gevraagd op te geven welke verbinding u wilt verwijderen.

• remove-all

  Hiermee verwijdert u alle opgeslagen verbindingen.

• update[standaardinstelling | alle | connection_id | user@host [--portpoort]] [--previous] [--fingerprint]

  Toegevoegd in Visual Studio 16.10. Hiermee werkt u de vingerafdruk van de hostsleutel van de opgegeven verbindingen bij.

• version

  Geeft versiegegevens weer.

Opties

• --file bestandsnaam

  Lees de verbindingsgegevens uit de opgegeven bestandsnaam.

• --fingerprint

  De vingerafdruk van de hostsleutel die door de server wordt gepresenteerd. Gebruik deze optie met list om de vingerafdruk van een verbinding weer te geven.

• -i

  Hetzelfde als --privatekey.

• -n, --dry-run

  Voert een proefuitvoering van de opdracht uit.

• --no-prompt

  Mislukt in plaats van prompt, indien van toepassing.

• --no-telemetry

  Schakel het verzenden van gebruiksgegevens terug naar Microsoft uit. Gebruiksgegevens worden verzameld en teruggestuurd naar Microsoft, tenzij de --no-telemetry vlag wordt doorgegeven.

• --no-verify

  Een verbinding zonder verificatie toevoegen of wijzigen.

• --p

  Hetzelfde als --password.

• --previous

  Geeft aan dat de verbindingen worden gelezen uit de vorige versie van verbindingsbeheer, bijgewerkt en naar de nieuwe versie geschreven.

• -q, --quiet

  Voorkomt uitvoer naar stdout of stderr.

Voorbeelden

Met deze opdracht wordt een verbinding toegevoegd voor een gebruiker met de naam 'gebruiker' op localhost. De verbinding maakt gebruik van een sleutelbestand voor verificatie, te vinden in %USERPROFILE%.ssh\id_rsa.

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

Met deze opdracht verwijdert u de verbinding met id-1975957870 uit de lijst met verbindingen.

ConnectionManager.exe remove 1975957870

Veelgebruikte eigenschappen

Vastgoed	Beschrijving
verificatietype	Het type verificatie dat wordt gebruikt voor de verbinding, zoals: "password", "privatekey". Een verbinding maken met het verificatietype ingesteld op "privatekey": ConnectionManager.exe add user@127.0.0.1 --privatekey "%USERPROFILE%\.ssh\id_rsa"
default	Een Booleaanse waarde die aangeeft of dit de standaardverbinding is. De standaardverbinding wordt gebruikt wanneer er meer dan één verbinding beschikbaar is en de verbinding die moet worden gebruikt, niet is opgegeven. De opgegeven verbinding instellen als de standaardverbinding: ConnectionManager.exe modify -21212121 --property default=true
host	De naam of het IP-adres van de externe computer. Om de host voor de opgegeven verbinding naar een andere machine te wijzigen, in dit geval naar de lokale host: ConnectionManager.exe modify -21212121 --property host=127.0.0.1
isWsl	Retourneert true wanneer de externe sessie Windows Subsystem voor Linux uitvoert.
password	Het wachtwoord voor de verbinding. Wijzig het wachtwoord voor de opgegeven verbinding met: ConnectionManager.exe modify -21212121 --property password="xyz"
platform	Het platform van de externe computer zoals "ARM", "ARM64", "PPC", "PPC64", "x64", "x86".
port	De poort die wordt gebruikt voor de verbinding. Wijzig de poort voor de opgegeven verbinding: ConnectionManager.exe modify -21212121 --property port=22
shell	De voorkeursshell die moet worden gebruikt op het externe systeem. Ondersteunde shells zijn sh, csh, bash, tcsh, ksh, zsh, dash De voorkeursshell instellen op zsh voor de externe computer op de opgegeven verbinding: ConnectionManager.exe modify -21212121 --property shell=zsh Als de shell op het Linux-systeem niet wordt ondersteund, wordt deze sh gebruikt voor alle opdrachten.
systemID	Het externe systeemtype, zoals "OSX", "Ubuntu".
timeout	De verbindingstime-out in milliseconden. Wijzig de time-out voor de opgegeven verbinding met: ConnectionManager.exe modify -21212121 --property timeout=100
username	De naam van de gebruiker die zich heeft aangemeld bij de externe computer. Een verbinding toevoegen voor een gebruiker met de naam "user" localhost: ConnectionManager.exe add user@127.0.0.1

Zie ook

Verbinding maken met uw linux-doelsysteem in Visual Studio