ConnectionManager 參考

ConnectionManager.exe 是命令列公用程式，可用來管理 Visual Studio 外部的遠端開發連線。 這適用於佈建新開發機器等工作。 或者，您可以使用其來設定 Visual Studio 以進行持續整合。 您可以在 [開發人員命令提示字元] 視窗中加以使用。 如需開發人員命令提示字元的詳細資訊，請參閱從命令列使用 Microsoft C++ 工具組。

Visual Studio 2019 16.5 版和更新版本提供 ConnectionManager.exe。 其是在 Visual Studio 安裝程式中使用 C++ 進行 Linux 開發工作負載的一部分。 當您在安裝程式中選擇連線管理員元件時，也會自動安裝之。 ConnectionManager.exe 會安裝在 %VCIDEInstallDir%\Linux\bin\ConnectionManagerExe\ConnectionManager.exe 中。

Visual Studio 中也提供 ConnectionManager.exe 的功能。 若要管理 IDE 中的遠端開發連線，請在功能表列上，選擇 [工具] > [選項] 以開啟 [選項] 對話方塊。 在 [選項] 對話方塊中，選取 [跨平台] > [連線管理員]。

語法

ConnectionManager.exe 命令 [引數] [選項]

命令和引數

• add user@host [--port 連接埠] [--password 密碼] [--privatekey privatekey_file]

  驗證並新增連線。 根據預設，其會使用連接埠 22 和密碼驗證。 (系統會提示您輸入密碼。)同時使用 --password 和 --privatekey 來指定私密金鑰的密碼。

• 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

  停用將使用方式資料傳回 Microsoft 的功能。 除非傳遞 --no-telemetry 旗標，否則會收集使用方式資料並將其傳回 Microsoft。

• --no-verify

  在不經驗證的情況下新增或修改連線。

• --p

  與 --password 相同。

• --previous

  表示將會從舊版的連線管理員讀取、更新連線並將其寫入新版本。

• -q, --quiet

  防止輸出至 stdout 或 stderr。

範例

此命令會在 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	如果遠端工作階段正在執行 Windows 子系統 Linux 版，則傳回 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	遠端系統上要使用的慣用殼層。 支援的殼層為 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	登入遠端電腦的使用者名稱。 若要為 localhost 上名為 "user" 的使用者新增連線：ConnectionManager.exe add user@127.0.0.1

另請參閱

連線至 Visual Studio 中的目標 Linux 系統