Справка по 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[connection_id по умолчанию | user@host | [ --port порт]] [--propertykey=value]

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

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

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

• remove-all

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

• update[по умолчанию | все | connection_id user@host | [--portпорт]] []--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