共用方式為

ConnectionManager 參考

  • 發行項

Visual Studio 2019 16.5 版和更新版本中提供ConnectionManager.exe。

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

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

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

語法

ConnectionManager.exe命令 [arguments] [options]

命令和引數

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

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

  • clean

    刪除已不存在之連線的標頭快取。

  • help

    顯示說明畫面。

  • list [--properties]

    顯示所有預存連線的資訊、識別碼和屬性。
    如需範例，請參閱 常用的屬性。

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

    定義或修改連接上的屬性。
    如果 value 是空的，則會刪除屬性 索引鍵 。
    如果驗證失敗，將不會進行任何變更。
    如果未指定任何連線 (預設的意義，) 上方，則會使用使用者的預設遠端連線。

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

    移除連接。 如果未指定任何引數，系統會提示您指定要移除的連線。

  • remove-all

    移除所有儲存的連線。

  • update[default | 所有 | | connection_iduser@host [ --portport]] [] [ --previous--fingerprint ]

    已在 Visual Studio 16.10 中新增。 更新指定連線的主機金鑰指紋 () 。

  • version

    顯示版本資訊。

選項

  • --filefilename

    從提供的 檔案名讀取連線資訊。

  • --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"

此命令會從連線清單中移除識別碼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 遠端電腦的平臺，例如 、、、、、 "x86""x64" 。 "PPC64""PPC""ARM64""ARM"
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 系統