Справка по ConnectionManager

Статья
10/16/2024

ConnectionManager.exe доступен в Visual Studio 2019 версии 16.5 и более поздних версий.

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 пароль] [--privatekey privatekey_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 порт]] [--property key=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

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

Свойство	Description
Тип проверки подлинности	Тип проверки подлинности, используемый для подключения, например: `"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

Поделиться через