Справка по ConnectionManager

ConnectionManager.exe — это программа командной строки для управления подключениями удаленной разработки вне Visual Studio. Ее удобно использовать для выполнения таких задач, как настройка новой рабочей станции для разработки. Кроме того, с ее помощью можно настроить Visual Studio для непрерывной интеграции. Она работает в окне "Командная строка разработчика". Дополнительные сведения о командной строке разработчика см. в статье Использование набора инструментов C++ Microsoft из командной строки.

ConnectionManager.exe доступен в Visual Studio 2019 версии 16.5 и более поздних версий. Она входит в состав рабочей нагрузки Разработка для Linux на C++ в Visual Studio Installer. Программа также устанавливается автоматически при выборе компонента Диспетчер подключений в установщике. Он установлен в %VCIDEInstallDir%\Linux\bin\ConnectionManagerExe\ConnectionManager.exe.

Функциональность ConnectionManager.exe также доступна в Visual Studio. Чтобы управлять подключениями удаленной разработки в интегрированной среде разработки, в строке меню выберите Сервис>Параметры, после чего откроется диалоговое окно "Параметры". В этом окне выберите Кроссплатформенный>Диспетчер подключений.

Синтаксис

ConnectionManager.exe команда [аргументы] [параметры]

Команды и аргументы

• add user@host [--portпорт] [--passwordпароль] [--privatekeyprivatekey_file]

  Выполнение проверки подлинности и добавление нового подключения. По умолчанию используется порт 22 и проверка подлинности с помощью пароля. (Вам будет предложено ввести пароль.)

  Вы можете использовать для проверки подлинности пароль или файл ключа с парольной фразой. Файлы ключей являются более безопасными, чем имя пользователя или пароль. Если у вас уже есть пара ключей, ее можно использовать повторно. Используйте оба --password и --privatekey для указания парольной фразы для файла закрытого ключа.

  Версии Visual Studio до 17.10 поддерживают ключи Elliptic Curve (EC), Rivert-Shamir-Adleman (RSA) и алгоритм цифровых подписей (DSA) для удаленных подключений. Из-за проблем безопасности ключи RSA и DSA больше не поддерживаются в VS 17.10 и более поздних версиях. В настоящее время поддерживаются только ключи EC.

  Чтобы создать пару ключей, совместимую с диспетчером соединений, используйте команду ssh-keygen -m pem -t ecdsa -f <key-name>. Если вы используете ssh-keygen для создания закрытого ключа, необходимо указать переключатель -m pemили ключ не будет принят Visual Studio. Если ваш закрытый ключ начинается с -----BEGIN OPENSSH PRIVATE KEY-----, тогда необходимо преобразовать его с помощью ssh-keygen -p -f <FILE> -m pem.

• clean

  Удаляет кэш заголовков для подключений, которые больше не существуют.

• help

  Вывод экрана помощи.

• list [--properties]

  Отображает сведения, идентификаторы и свойства всех сохраненных подключений.
  Примеры см. в разделе Часто используемые свойства.

• modify[default | connection_id | user@host [--portпорт]] [--propertykey=value]

  Определяет или изменяет свойство подключения.
  Если значение пусто, ключ свойства удаляется.
  Если проверка подлинности завершается ошибкой, изменения не вносятся.
  Если подключение не указано, используется удаленное подключение пользователя по умолчанию.

• remove [connection_id | user@host [--portпорт]]

  Удаление подключения. Если аргументы не указаны, вам будет предложено указать подключение для удаления.

• remove-all

  Удаление всех сохраненных подключений.

• [по умолчаниювсеconnection_idпользователь@хост [порт]] [] []

  Добавлено в Visual Studio 16.10. Обновляет отпечаток ключа хоста для указанных подключений.

• version

  Отображение сведений о версии.

Параметры

• --file имя_файла

  Считайте информацию о подключении из указанного названия_файла.

• --fingerprint

  Отпечаток ключа сервера, представленный сервером. Используйте этот параметр вместе с list, чтобы просмотреть отпечаток подключения.

• -i

  Эквивалентно --privatekey.

• -n, --dry-run

  Выполнение пробного запуска команды.

• --no-prompt

  Произвести сбой вместо запроса, когда это целесообразно.

• --no-telemetry

  Отключение отправки данных об использовании обратно в корпорацию Майкрософт. Данные об использовании собираются и отправляются обратно в корпорацию Майкрософт, если не будет передан флаг --no-telemetry.

• --no-verify

  Добавление или изменение подключения без проверки подлинности.

• --p

  Эквивалентно --password.

• --previous

  Указывает, что подключения будут считаны из предыдущей версии менеджера подключений, обновлены и записаны в новую версию.

• -q, --quiet

  Предотвращает вывод в stdout или stderr.

Примеры

Эта команда добавляет подключение для пользователя с именем "user" на localhost. Для проверки подлинности подключение использует файл ключа, который находится в %USERPROFILE%.ssh\id_rsa.

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

Эта команда удаляет подключение с ИД 1975957870 из списка подключений.

ConnectionManager.exe remove 1975957870

Часто используемые свойства

Свойство	Описание
Тип проверки подлинности	Тип проверки подлинности, используемый для подключения, например: "password""privatekey". Чтобы создать соединение с типом проверки подлинности, установленным на "privatekey", используйте: ConnectionManager.exe add user@127.0.0.1 --privatekey "%USERPROFILE%\.ssh\id_rsa".
default	Логическое значение, указывающее, используется ли это подключение по умолчанию. Подключение по умолчанию используется, если доступно несколько подключений, но при этом не указано, какое из них следует использовать. Чтобы указать определенное подключение как подключение по умолчанию, используйте эту команду: ConnectionManager.exe modify -21212121 --property default=true
host	Имя или IP-адрес удаленного компьютера. Чтобы изменить хост для указанного подключения на другой компьютер, в нашем случае на локальный хост, используйте следующее: ConnectionManager.exe modify -21212121 --property host=127.0.0.1
isWsl	Возвращает значение true, если в удаленном сеансе выполняется подсистема Windows для Linux.
password	Пароль для соединения. Измените пароль для указанного подключения с помощью следующей команды: ConnectionManager.exe modify -21212121 --property password="xyz"
platform	Платформа удаленного компьютера, например "ARM", "ARM64", "PPC", "PPC64", "x64", "x86".
port	Порт, используемый для подключения. Изменение порта для указанного подключения: ConnectionManager.exe modify -21212121 --property port=22
shell	Предпочтительная оболочка для использования в удаленной системе. Поддерживаемые оболочки: sh, csh, bash, tcsh, ksh, zsh, dash. Чтобы настроить оболочку zsh в качестве предпочитаемой для удаленного компьютера в указанном подключении, укажите следующее: ConnectionManager.exe modify -21212121 --property shell=zsh Если оболочка, найденная в системе Linux, не поддерживается, для всех команд будет использоваться sh.
systemID	Тип удаленной системы, например "OSX", "Ubuntu".
timeout	Время ожидания подключения (в миллисекундах). Измените время ожидания для указанного подключения с помощью следующей команды: ConnectionManager.exe modify -21212121 --property timeout=100
username	Имя пользователя, выполнившего вход на удаленный компьютер. Чтобы добавить подключение для пользователя с именем "user" на localhost, используйте эту команду: ConnectionManager.exe add user@127.0.0.1

См. также

Подключение к целевой системе Linux из Visual Studio