Referensi ConnectionManager

ConnectionManager.exe adalah utilitas baris perintah untuk mengelola koneksi pengembangan jarak jauh di luar Visual Studio. Ini berguna untuk tugas-tugas seperti menyediakan mesin pengembangan baru. Atau, gunakan untuk menyiapkan Visual Studio untuk integrasi berkelanjutan. Anda dapat menggunakannya di jendela Prompt Perintah Pengembang. Untuk informasi selengkapnya tentang Prompt Perintah Pengembang, lihat Menggunakan toolset Microsoft C++ dari baris perintah.

ConnectionManager.exe tersedia di Visual Studio 2019 versi 16.5 dan yang lebih baru. Ini adalah bagian dari beban kerja pengembangan Linux dengan C++ di Penginstal Visual Studio. Ini juga diinstal secara otomatis ketika Anda memilih komponen Pengelola Koneksi di penginstal. Ini diinstal di %VCIDEInstallDir%\Linux\bin\ConnectionManagerExe\ConnectionManager.exe.

Fungsionalitas ConnectionManager.exe juga tersedia di Visual Studio. Untuk mengelola koneksi pengembangan jarak jauh di IDE, pada bilah menu, pilih Alat>Opsi untuk membuka dialog Opsi. Dalam dialog Opsi, pilih Lintas Platform>Pengelola Koneksi.

Sintaks

ConnectionManager.exe command [argumen] [options]

Perintah dan argumen

• add user@host [--portport] [--passwordpassword] [--privatekeyprivatekey_file]

  Mengautentikasi dan menambahkan koneksi baru. Secara default, ini menggunakan port 22 dan autentikasi kata sandi. (Anda diminta untuk memasukkan kata sandi.)

  Anda dapat menggunakan kata sandi atau file kunci dan frasa sandi untuk autentikasi. File kunci lebih aman daripada nama pengguna/kata sandi. Jika Anda sudah memiliki pasangan kunci, Anda dapat menggunakannya kembali. Gunakan dan --password--privatekey untuk menentukan frase sandi untuk file kunci privat.

  Versi Visual Studio sebelum 17.10 mendukung kunci Elliptic Curve (EC), Rivert-Shamir-Adleman (RSA), dan Digital signature algorithm (DSA) untuk koneksi jarak jauh. Karena masalah keamanan, kunci RSA dan DSA tidak lagi didukung di VS 17.10 dan yang lebih baru. Hanya kunci EC yang saat ini didukung.

  Untuk membuat pasangan kunci yang kompatibel dengan pengelola koneksi, gunakan perintah ssh-keygen -m pem -t ecdsa -f <key-name>. Jika Anda menggunakan ssh-keygen untuk membuat kunci privat, Anda harus menentukan sakelar -m pem, atau kunci tidak akan diterima oleh Visual Studio. Jika kunci privat Anda dimulai dengan -----BEGIN OPENSSH PRIVATE KEY-----, Anda harus mengonversinya dengan ssh-keygen -p -f <FILE> -m pem.

• clean

  Menghapus cache header untuk koneksi yang sudah tidak ada lagi.

• help

  Menampilkan layar bantuan.

• list [--properties]

  Menampilkan informasi, ID, dan properti dari semua koneksi tersimpan.
  Misalnya, lihat Properti yang umum digunakan.

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

  Menentukan atau memodifikasi properti pada koneksi.
  Jika nilai kosong, kunci properti akan dihapus.
  Jika autentikasi gagal, tidak ada perubahan yang akan dilakukan.
  Jika tidak ada koneksi yang ditentukan, koneksi jarak jauh default pengguna akan digunakan.

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

  Menghapus koneksi. Jika tidak ada argumen yang ditentukan, Anda akan diminta untuk menentukan koneksi mana yang akan dihapus.

• remove-all

  Menghapus semua koneksi tersimpan.

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

  Ditambahkan di Visual Studio 16.10. Memperbarui sidik jari kunci host dari koneksi yang ditentukan.

• version

  Menampilkan informasi versi.

Opsi

• --file Filename

  Baca informasi koneksi dari nama file yang disediakan.

• --fingerprint

  Sidik jari kunci host yang disajikan oleh server. Gunakan opsi ini dengan list untuk melihat sidik jari koneksi.

• -i

  Sama seperti --privatekey.

• -n, --dry-run

  Melakukan uji coba dasar untuk perintah.

• --no-prompt

  Gagal alih-alih prompt, jika sesuai.

• --no-telemetry

  Nonaktifkan pengiriman data penggunaan kembali ke Microsoft. Data penggunaan dikumpulkan dan dikirim kembali ke Microsoft kecuali --no-telemetry bendera diteruskan.

• --no-verify

  Menambahkan atau mengubah koneksi tanpa autentikasi.

• --p

  Sama seperti --password.

• --previous

  Menunjukkan bahwa koneksi akan dibaca dari versi pengelola koneksi sebelumnya, diperbarui, dan ditulis ke versi baru.

• -q, --quiet

  Mencegah output ke stdout atau stderr.

Contoh

Perintah ini menambahkan koneksi untuk pengguna bernama "pengguna" di localhost. Koneksi menggunakan file kunci untuk autentikasi, ditemukan di %USERPROFILE%.ssh\id_rsa.

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

Perintah ini menghapus koneksi yang memiliki ID 1975957870 dari daftar koneksi.

ConnectionManager.exe remove 1975957870

Properti yang umum digunakan

Properti	Deskripsi
tipe autentikasi	Tipe autentikasi yang digunakan untuk koneksi seperti: "password", "privatekey". Untuk membuat koneksi dengan tipe autentikasi, atur ke "privatekey": ConnectionManager.exe add user@127.0.0.1 --privatekey "%USERPROFILE%\.ssh\id_rsa"
default	Boolean yang menunjukkan apakah ini adalah koneksi default. Koneksi default digunakan ketika ada lebih dari satu koneksi yang tersedia dan koneksi yang akan digunakan tidak ditentukan. Untuk mengatur koneksi yang ditentukan menjadi koneksi default: ConnectionManager.exe modify -21212121 --property default=true
host	Nama atau alamat IP komputer jarak jauh. Untuk mengubah host untuk koneksi yang ditentukan ke komputer lain, dalam hal ini, host lokal: ConnectionManager.exe modify -21212121 --property host=127.0.0.1
isWsl	Mengembalikan benar jika sesi jarak jauh menjalankan Subsistem Windows untuk Linux.
password	Kata sandi untuk koneksi. Ubah kata sandi untuk koneksi yang ditentukan dengan: ConnectionManager.exe modify -21212121 --property password="xyz"
platform	Platform komputer jarak jauh seperti "ARM", "ARM64", "PPC", "PPC64", "x64", "x86".
port	Port yang digunakan untuk koneksi. Ubah port untuk koneksi yang ditentukan: ConnectionManager.exe modify -21212121 --property port=22
shell	Shell pilihan untuk digunakan pada sistem jarak jauh. Shell yang didukung adalah sh, csh, bash, tcsh, ksh, zsh, dash Untuk mengatur shell pilihan menjadi zsh untuk komputer jarak jauh pada koneksi yang ditentukan: ConnectionManager.exe modify -21212121 --property shell=zsh Jika shell yang ditemukan pada sistem Linux tidak didukung, sh akan digunakan untuk semua perintah.
systemID	Tipe sistem jarak jauh, seperti "OSX", "Ubuntu".
timeout	Batas waktu koneksi dalam milidetik. Ubah batas waktu untuk koneksi yang ditentukan dengan: ConnectionManager.exe modify -21212121 --property timeout=100
username	Nama pengguna yang masuk ke komputer jarak jauh. Untuk menambahkan koneksi untuk pengguna bernama "user" di localhost: ConnectionManager.exe add user@127.0.0.1

Lihat juga

Sambungkan ke sistem Linux target Anda di Visual Studio