ConnectionManager — dokumentacja

ConnectionManager.exe jest narzędziem 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ępny w programie Visual Studio 2019 w wersji 16.5 lub nowszej. Jest to część programowania systemu Linux z obciążeniem 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 programie %VCIDEInstallDir%\Linux\bin\ConnectionManagerExe\ConnectionManager.exe.

ConnectionManager.exe Funkcjonalność programu jest również dostępna 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

• add user@host [--port port] [--password hasło] [--privatekey privatekey_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).

  Do uwierzytelniania można użyć hasła lub pliku klucza i hasła. Pliki kluczy są bezpieczniejsze niż nazwa użytkownika/hasło. Jeśli masz już parę kluczy, możesz użyć jej ponownie. Użyj parametru --password i --privatekey , aby określić hasło dla pliku klucza prywatnego.

  Wersje programu Visual Studio przed 17.10 obsługują klucze Elliptic Curve (EC), Rivert-Shamir-Adleman (RSA) i Digital signature algorithm (DSA) dla połączeń zdalnych. Ze względu na obawy dotyczące zabezpieczeń klucze RSA i DSA nie są już obsługiwane w programie VS 17.10 i nowszych wersjach. Obecnie obsługiwane są tylko klucze EC.

  Aby utworzyć parę kluczy zgodną z menedżerem połączeń, użyj polecenia ssh-keygen -m pem -t ecdsa -f <key-name>. Jeśli tworzysz ssh-keygen klucz prywatny, musisz określić przełącznik -m pemlub klucz nie zostanie zaakceptowany przez program Visual Studio. Jeśli klucz prywatny zaczyna się od -----BEGIN OPENSSH PRIVATE KEY-----, musisz przekonwertować go na ssh-keygen -p -f <FILE> -m pem.

• 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[default | connection_id user@host | [ --port port]] [--property key=value]

  Definiuje lub modyfikuje właściwość połączenia.
  Jeśli wartość jest pusta, klucz właściwości zostanie usunięty.
  Jeśli uwierzytelnianie nie powiedzie się, nie zostaną wprowadzone żadne zmiany.
  Jeśli nie określono połączenia, zostanie użyte domyślne połączenie zdalne użytkownika.

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

  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[domyślne | wszystkie | connection_id user@host | [--port port]] [--previous] []--fingerprint

  Dodano do programu Visual Studio 16.10. Aktualizuje 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, 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

  Dodaj lub zmodyfikuj połączenie bez uwierzytelniania.

• --p

  Tak samo jak --password.

• --previous

  Wskazuje, że połączenia zostaną odczytane z poprzedniej wersji menedżera połączeń, zaktualizowane i zapisane w nowej wersji.

• -q, --quiet

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

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 znalezionego 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ści	opis
typ uwierzytelniania	Typ uwierzytelniania używanego dla połączenia, na przykład: "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 domyślne połączenie. Połączenie domyślne jest używane, gdy jest dostępnych więcej niż jedno połączenie i nie określono tego połączenia do użycia. 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, takiego jak "ARM", , "ARM64""PPC", "PPC64", "x64", "x86".
port	Port używany do 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" localhost: ConnectionManager.exe add user@127.0.0.1

Zobacz też

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