ConnectionManager – referenční dokumentace

ConnectionManager.exe je nástroj příkazového řádku pro správu vzdálených vývojových připojení mimo Visual Studio. Je užitečné pro úlohy, jako je zřízení nového vývojového počítače. Nebo ho můžete použít k nastavení sady Visual Studio pro kontinuální integraci. Můžete ho použít v okně příkazového řádku pro vývojáře. Další informace o příkazovém řádku pro vývojáře naleznete v tématu Použití sady nástrojů Microsoft C++ z příkazového řádku.

ConnectionManager.exe je k dispozici ve Visual Studio 2019 verzi 16.5 a vyšší. Je součástí vývoje pro Linux s C++ v Instalačním programu Visual Studio. Nainstaluje se také automaticky, když v instalačním programu zvolíte komponentu Správce připojení. Je nainstalovaný v %VCIDEInstallDir%\Linux\bin\ConnectionManagerExe\ConnectionManager.exe.

Funkcionalita ConnectionManager.exe je k dispozici také ve Visual Studio. Pokud chcete spravovat vzdálená připojení pro vývoj v integrovaném vývojovém prostředí, v řádku nabídek zvolte Možnosti nástrojů>a otevřete dialogové okno Možnosti. V dialogovém okně Možnosti vyberte Křížová platforma> Správce připojení.

Syntaxe

ConnectionManager.exe command [arguments] [options]

Příkazy a argumenty

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

  Ověří a přidá nové připojení. Ve výchozím nastavení používá port 22 a ověřování heslem. (Zobrazí se výzva k zadání hesla.)

  Pro ověřování můžete použít heslo nebo soubor klíče a heslo. Soubory klíčů jsou bezpečnější než uživatelské jméno a heslo. Pokud už pár klíčů máte, můžete ho znovu použít. K zadání heslové fráze pro soubor privátního klíče použijte jak --password, tak --privatekey.

  Verze sady Visual Studio před verzí 17.10 podporují klíče Elliptic Curve (EC), Rivert-Shamir-Adleman (RSA) a algoritmus digitálního podpisu (DSA) pro vzdálená připojení. Z bezpečnostních důvodů se klíče RSA a DSA už ve VS 17.10 a novějších nepodporují. V současné době se podporují jenom klíče EC.

  Pokud chcete vytvořit pár klíčů kompatibilní se správcem připojení, použijte příkaz ssh-keygen -m pem -t ecdsa -f <key-name>. Pokud používáte ssh-keygen k vytvoření privátního klíče, musíte zadat přepínač -m pemnebo klíč nebude přijat sadou Visual Studio. Pokud váš privátní klíč začíná -----BEGIN OPENSSH PRIVATE KEY-----, musíte ho převést na ssh-keygen -p -f <FILE> -m pem.

• clean

  Odstraní mezipaměť hlaviček pro připojení, která již neexistují.

• help

  Zobrazí obrazovku nápovědy.

• list [--properties]

  Zobrazí informace, ID a vlastnosti všech uložených připojení.
  Příklady najdete v tématu Běžně používané vlastnosti.

• modify [výchozí | connection_id | user@host [--portport]] [--propertykey=value]

  Definuje nebo upravuje vlastnost u připojení.
  Pokud je hodnota prázdná, klíč vlastnosti se odstraní.
  Pokud ověřování selže, nebudou provedeny žádné změny.
  Pokud není zadané žádné připojení, použije se výchozí vzdálené připojení uživatele.

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

  Odebere připojení. Pokud nejsou zadány žádné argumenty, zobrazí se výzva k zadání připojení, které se má odebrat.

• remove-all

  Odebere všechna uložená připojení.

• update [default | all | connection_id | uživatel@hostitel [--portport]] [--previous] [--fingerprint]

  Přidáno v sadě Visual Studio 16.10. Aktualizuje otisk klíče hostitele zadaných připojení.

• version

  Zobrazí informace o verzi.

Možnosti

• --file jméno souboru

  Přečtěte si informace o připojení ze zadaného názvu souboru.

• --fingerprint

  Otisk prstu klíče hostitele předaný serverem. Tuto možnost list použijte k zobrazení otisku prstu připojení.

• -i

  Stejné jako --privatekey.

• -n, --dry-run

  Provede testovací běh příkazu.

• --no-prompt

  Při vhodných okolnostech selžte místo zobrazení výzvy.

• --no-telemetry

  Zakažte odesílání dat o využití zpět do Microsoftu. Data o využití se shromažďují a odesílají zpět do Microsoftu, pokud není předán příznak --no-telemetry.

• --no-verify

  Přidejte nebo upravte připojení bez ověřování.

• --p

  Stejné jako --password.

• --previous

  Označuje, že připojení budou načtena z předchozí verze správce připojení, aktualizovány a zapsány do nové verze.

• -q, --quiet

  Zabraňuje výstupu do stdout nebo stderr.

Příklady

Tento příkaz přidá připojení pro uživatele s názvem "user" na localhost. Připojení používá k ověřování soubor klíče nalezený v %USERPROFILE%.ssh\id_rsa.

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

Tento příkaz odebere připojení s ID 1975957870 ze seznamu připojení.

ConnectionManager.exe remove 1975957870

Běžně používané vlastnosti

Vlastnost	Popis
typ ověřování	Typ ověřování, který se používá pro připojení, například: "password", "privatekey". Vytvoření připojení s typem ověřování nastaveným na "privatekey": ConnectionManager.exe add user@127.0.0.1 --privatekey "%USERPROFILE%\.ssh\id_rsa"
default	Logická hodnota označující, jestli se jedná o výchozí připojení. Výchozí připojení se používá, pokud je k dispozici více připojení a není zadané připojení, které se má použít. Nastavení zadaného připojení jako výchozího připojení: ConnectionManager.exe modify -21212121 --property default=true
host	Název nebo IP adresa vzdáleného počítače. Pokud chcete změnit hostitele pro zadané připojení k jinému počítači, v tomto případě místního hostitele: ConnectionManager.exe modify -21212121 --property host=127.0.0.1
isWsl	Vrátí hodnotu true, pokud vzdálená relace běží v subsystému Windows pro Linux.
password	Heslo pro připojení. Změňte heslo pro zadané připojení s: ConnectionManager.exe modify -21212121 --property password="xyz"
platform	Platforma vzdáleného počítače, jako "ARM", "ARM64", "PPC", "PPC64", "x64" nebo "x86".
port	Port použitý pro připojení. Změňte port pro zadané připojení: ConnectionManager.exe modify -21212121 --property port=22
shell	Preferovaný shell k použití na vzdáleném systému. Podporované prostředí jsou sh, csh, bash, tcsh, ksh, zsh, dash Nastavit preferovaný shell na zsh pro vzdálený počítač v rámci zadaného připojení: ConnectionManager.exe modify -21212121 --property shell=zsh Pokud prostředí nalezené v systému Linux není podporované, pak se sh používá pro všechny příkazy.
systemID	Typ vzdáleného systému, například "OSX", "Ubuntu".
timeout	Časový limit připojení v milisekundách. Změňte časový limit pro zadané připojení pomocí: ConnectionManager.exe modify -21212121 --property timeout=100
username	Jméno uživatele přihlášeného ke vzdálenému počítači. Přidání připojení pro uživatele pojmenovaného "user" na místním hostiteli: ConnectionManager.exe add user@127.0.0.1

Viz také

Připojte se k cílovému systému Linux v sadě Visual Studio