分享方式：

ConnectionManager 參考

  • 文章

ConnectionManager.exe 可在 Visual Studio 2019 16.5 版和更新版本中取得。

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

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

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

語法

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

命令和引數

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

    驗證並新增連線。 根據預設，其會使用連接埠 22 和密碼驗證。 （系統會提示您輸入密碼。

    您可以使用密碼或金鑰檔案和複雜密碼進行驗證。 金鑰檔案比使用者名稱/密碼更安全。 如果您已經有金鑰組，則可以重複使用。 --password使用和 --privatekey 來指定私鑰檔案的複雜密碼。

    17.10 之前的 Visual Studio 版本支援橢圓曲線 （EC）、Rivert-Shamir-Adleman （RSA） 和用於遠端連線的數位簽名演算法 （DSA） 密鑰。 由於安全性考慮，VS 17.10 和更新版本中不再支援 RSA 和 DSA 金鑰。 目前僅支援 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

    停用將使用方式資料傳回 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 系統