Справка по 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.execommand [arguments] [options]

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

• adduser@host [--portport] [--passwordpassword] [--privatekeyprivatekey_file]

  Выполнение проверки подлинности и добавление нового подключения. По умолчанию используется порт 22 и проверка подлинности с помощью пароля. (Будет выведен запрос на ввод пароля.) Чтобы указать пароль для закрытого ключа, используйте и --password , и --privatekey .

• clean

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

• help

  Вывод окна справки.

• list [--properties]

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

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

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

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

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

• remove-all

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

• update [default | all | connection_id | user@host [--portport]] [--previous] [--fingerprint]

  Добавлено в 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