ConnectionManager 引用

ConnectionManager.exe 是用于在 Visual Studio 之外管理远程开发连接的命令行实用工具。 它对于预配新开发计算机之类的任务非常有用。 你也可以使用它来设置 Visual Studio 进行持续集成。 可以在“开发人员命令提示”窗口中使用它。 若要详细了解开发人员命令提示，请参阅通过命令行使用 Microsoft C++ 工具集。

可以在 Visual Studio 2019 版本 16.5 及更高版本中使用 ConnectionManager.exe。 它属于 Visual Studio 安装程序中的“使用 C++ 的 Linux 开发”工作负载。 它也会在你选择安装程序中的“连接管理器”组件时自动安装。 它的安装路径为 %VCIDEInstallDir%\Linux\bin\ConnectionManagerExe\ConnectionManager.exe。

在 Visual Studio 中，也可以使用 ConnectionManager.exe 的功能。 若要在 IDE 中管理远程开发连接，请在菜单栏上依次选择“工具”>“选项”，以打开“选项”对话框。 在“选项”对话框中，依次选择“跨平台”>“连接管理器”。

语法

ConnectionManager.exe command [arguments] [options]

命令和参数

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

  验证身份，并添加新连接。 默认情况下，它使用端口 22 和密码身份验证。 （系统会提示你输入密码。）同时使用 --password 和 --privatekey 指定私钥的密码。

• clean

  删除不再存在的连接的标头缓存。

• help

  显示帮助屏幕。

• list [--properties]

  显示已存储的所有连接的信息、ID 和属性。
  有关示例，请参阅常用属性。

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

  定义或修改连接的属性。
  如果 value 为空，则删除属性 key。
  如果身份验证失败，则不进行任何更改。
  如果未指定连接（上述的默认情况），则使用用户的默认远程连接。

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

  删除连接。 如果你没有指定任何参数，系统会提示你指定要删除哪个连接。

• remove-all

  删除已存储的所有连接。

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

  已在 Visual Studio 16.10 中添加。 更新指定连接的主机密钥指纹。

• version

  显示版本信息。

选项

• --file filename

  从提供的 filename 中读取连接信息。

• --fingerprint

  服务器提供的主机密钥指纹。 将此选项与“list”配合使用以查看连接的指纹。

• -i

  与 --privatekey 相同。

• -n, --dry-run

  试运行命令。

• --no-prompt

  视情况发生故障，而不是提示。

• --no-telemetry

  禁用将用法数据发送回 Microsoft。 除非传递的是 --no-telemetry 标志，否则用法数据会被收集并发送回 Microsoft。

• --no-verify

  添加或修改连接，而无需进行身份验证。

• --p

  与 --password 相同。

• --previous

  指示将从先前版本的连接管理器中读取连接，更新此连接并将其写入新版本。

• -q, --quiet

  防止输出到 stdout 或 stderr。

示例

下面的命令在 localhost 上为名为“user”的用户添加连接。 连接使用 %USERPROFILE%.ssh\id_rsa 中的密钥文件进行身份验证。

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

下面的命令从连接列表中删除 ID 为 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	如果远程会话正在运行适用于 Linux 的 Windows 子系统，则返回 true。
password	连接的密码。 使用以下命令更改指定连接的密码：ConnectionManager.exe modify -21212121 --property password="xyz"
platform	远程计算机的平台，例如 "ARM"、"ARM64"、"PPC"、"PPC64"、"x64"、"x86"。
port	连接使用的端口。 更改指定连接的端口：ConnectionManager.exe modify -21212121 --property port=22
shell	要在远程系统上使用的首选 shell。 支持的 shell 为 sh, csh, bash, tcsh, ksh, zsh, dash 对于指定连接上的远程计算机，将首选 shell 设置为 zsh：ConnectionManager.exe modify -21212121 --property shell=zsh 如果在 Linux 系统上找到的 shell 不受支持，则对所有命令使用 sh。
systemID	远程系统类型，例如 "OSX"、"Ubuntu"。
timeout	连接超时时间（毫秒）。 使用以下命令更改指定连接的超时时间：ConnectionManager.exe modify -21212121 --property timeout=100
username	登录到远程计算机的用户的名称。 在 localhost 上为名为 "user" 的用户添加连接：ConnectionManager.exe add user@127.0.0.1

另请参阅

在 Visual Studio 中连接到你的目标 Linux 系统