ConnectionManager — dokumentacja

ConnectionManager.exe to narzędzie wiersza polecenia do zarządzania połączeniami programowania zdalnego poza programem Visual Studio. Jest to przydatne w przypadku zadań, takich jak aprowizowanie nowej maszyny deweloperskiej. Możesz też użyć go do skonfigurowania programu Visual Studio na potrzeby ciągłej integracji. Można go użyć w oknie wiersza polecenia dla deweloperów. Aby uzyskać więcej informacji na temat wiersza polecenia dla deweloperów, zobacz Use the Microsoft C++ toolset from the command line (Używanie zestawu narzędzi Microsoft C++ z wiersza polecenia).

ConnectionManager.exe jest dostępna w programie Visual Studio 2019 w wersji 16.5 lub nowszej. Jest to część obciążenia programowanie w systemie Linux za pomocą języka C++ w Instalator programu Visual Studio. Jest on również instalowany automatycznie po wybraniu składnika Menedżer połączeń w instalatorze. Jest on zainstalowany w folderze %VCIDEInstallDir%\Linux\bin\ConnectionManagerExe\ConnectionManager.exe.

Funkcje ConnectionManager.exe są również dostępne w programie Visual Studio. Aby zarządzać połączeniami programowania zdalnego w środowisku IDE, na pasku menu wybierz pozycję Narzędzia>Opcje , aby otworzyć okno dialogowe Opcje. W oknie dialogowym Opcje wybierz pozycję Międzyplatformowe>Menedżer połączeń.

Składnia

ConnectionManager.exepolecenie [argumenty] [opcje]

Polecenia i argumenty

• adduser@host [--portport] [--passwordhasło] [--privatekeyprivatekey_file]

  Uwierzytelnia się i dodaje nowe połączenie. Domyślnie używa portu 22 i uwierzytelniania haseł. (Zostanie wyświetlony monit o wprowadzenie hasła). Użyj opcji --password i --privatekey , aby określić hasło dla klucza prywatnego.

• clean

  Usuwa pamięć podręczną nagłówka dla połączeń, które już nie istnieją.

• help

  Wyświetla ekran pomocy.

• list [--properties]

  Wyświetla informacje, identyfikatory i właściwości wszystkich przechowywanych połączeń.
  Aby zapoznać się z przykładami, zobacz Często używane właściwości.

• modify[wartość domyślna | | connection_id user@host [--portport]] [--propertykey=value]

  Definiuje lub modyfikuje właściwość w połączeniu.
  Jeśli wartość jest pusta, klucz właściwości zostanie usunięty.
  W przypadku niepowodzenia uwierzytelniania nie zostaną wprowadzone żadne zmiany.
  Jeśli nie określono połączenia (co jest domyślnie oznaczane powyżej), zostanie użyte domyślne połączenie zdalne użytkownika.

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

  Usuwa połączenie. Jeśli nie określono żadnych argumentów, zostanie wyświetlony monit o określenie połączenia do usunięcia.

• remove-all

  Usuwa wszystkie przechowywane połączenia.

• update[wartość domyślna | Wszystkie | | connection_id user@host [--portport]] [--previous] [--fingerprint]

  Dodano element w programie Visual Studio 16.10. Aktualizacje odcisk palca klucza hosta określonych połączeń.

• version

  Wyświetla informacje o wersji.

Opcje

• --filePod nazwą

  Odczytywanie informacji o połączeniu z podanej nazwy pliku.

• --fingerprint

  Odcisk palca klucza hosta przedstawiony przez serwer. Użyj tej opcji z opcją list , aby wyświetlić odcisk palca połączenia.

• -i

  Tak samo jak --privatekey.

• -n, --dry-run

  Wykonuje suchy przebieg polecenia.

• --no-prompt

  Niepowodzenie zamiast monitu, jeśli jest to konieczne.

• --no-telemetry

  Wyłącz wysyłanie danych użycia z powrotem do firmy Microsoft. Dane użycia są zbierane i wysyłane z powrotem do firmy Microsoft, chyba że flaga --no-telemetry zostanie przekazana.

• --no-verify

  Dodawanie lub modyfikowanie połączenia bez uwierzytelniania.

• --p

  Tak samo jak --password.

• --previous

  Wskazuje, że połączenia będą odczytywane z poprzedniej wersji menedżera połączeń, aktualizowane i zapisywane w nowej wersji.

• -q, --quiet

  Uniemożliwia przesyłanie danych wyjściowych do lub stdoutstderr.

Przykłady

To polecenie dodaje połączenie dla użytkownika o nazwie "user" na hoście lokalnym. Połączenie używa pliku klucza do uwierzytelniania znajdującego się w folderze %USERPROFILE%.ssh\id_rsa.

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

To polecenie usuwa połączenie, które ma identyfikator 1975957870 z listy połączeń.

ConnectionManager.exe remove 1975957870

Często używane właściwości

Właściwość	Opis
typ uwierzytelniania	Typ uwierzytelniania używanego dla połączenia, taki jak : "password", "privatekey". Aby utworzyć połączenie z typem uwierzytelniania ustawionym na "privatekey": ConnectionManager.exe add user@127.0.0.1 --privatekey "%USERPROFILE%\.ssh\id_rsa"
default	Wartość logiczna wskazująca, czy jest to połączenie domyślne. Połączenie domyślne jest używane, gdy jest dostępnych więcej niż jedno połączenie, a używane połączenie nie jest określone. Aby ustawić określone połączenie jako domyślne połączenie: ConnectionManager.exe modify -21212121 --property default=true
host	Nazwa lub adres IP komputera zdalnego. Aby zmienić hosta dla określonego połączenia z inną maszyną, w tym przypadku hosta lokalnego: ConnectionManager.exe modify -21212121 --property host=127.0.0.1
isWsl	Zwraca wartość true, jeśli sesja zdalna jest uruchomiona Podsystem Windows dla systemu Linux.
password	Hasło połączenia. Zmień hasło dla określonego połączenia za pomocą: ConnectionManager.exe modify -21212121 --property password="xyz"
platform	Platforma komputera zdalnego, na przykład "ARM", "ARM64", "PPC", "PPC64", "x64", "x86".
port	Port używany na potrzeby połączenia. Zmień port dla określonego połączenia: ConnectionManager.exe modify -21212121 --property port=22
shell	Preferowana powłoka do użycia w systemie zdalnym. Obsługiwane powłoki to sh, csh, bash, tcsh, ksh, zsh, dash Aby ustawić preferowaną powłokę na wartość zsh dla maszyny zdalnej w określonym połączeniu: ConnectionManager.exe modify -21212121 --property shell=zsh Jeśli powłoka znaleziona w systemie Linux nie jest obsługiwana, sh zostanie użyta dla wszystkich poleceń.
systemID	Typ systemu zdalnego, taki jak "OSX", "Ubuntu".
timeout	Limit czasu połączenia w milisekundach. Zmień limit czasu dla określonego połączenia za pomocą: ConnectionManager.exe modify -21212121 --property timeout=100
username	Nazwa użytkownika zalogowanego na komputerze zdalnym. Aby dodać połączenie dla użytkownika o nazwie "user" on localhost: ConnectionManager.exe add user@127.0.0.1

Zobacz też

Nawiązywanie połączenia z docelowym systemem Linux w programie Visual Studio