ConnectionManager – referenční dokumentace

Článek
10/16/2024

ConnectionManager.exe je k dispozici v sadě Visual Studio 2019 verze 16.5 a novější.

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 v sadě Visual Studio 2019 verze 16.5 a novější. Je součástí vývoje pro Linux pomocí úlohy C++ v Instalační program pro 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.

Funkce ConnectionManager.exe jsou k dispozici také v sadě 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.execommand [arguments] [options]

Příkazy a argumenty

add user@host [--port port] [--password heslo] [--privatekey privatekey_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í přístupového hesla pro soubor privátního klíče použijte obojí --password --privatekey i heslo.

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 | [ --port port]] [--property klíč=hodnota]

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 | [--port port]]

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[výchozí všechny | | connection_id user@host | [--port port]] [--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

--filejméno souboru

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

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

Stejné jako --privatekey.
-n, --dry-run

Provede suchý běh příkazu.
--no-prompt

Pokud je to vhodné, místo výzvy selžou.
--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 --no-telemetry , pokud se příznak nepředá.
--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ěží Subsystém 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"`je , `"ARM64"`, `"PPC"`, `"PPC64"`, `"x64"`, . `"x86"`
`port`	Port použitý pro připojení. Změňte port pro zadané připojení: `ConnectionManager.exe modify -21212121 --property port=22`
`shell`	Upřednostňované prostředí, které se má použít ve vzdáleném systému. Podporované prostředí jsou `sh, csh, bash, tcsh, ksh, zsh, dash` Nastavení upřednostňovaného prostředí na zsh pro vzdálený počítač v zadaném připojení: `ConnectionManager.exe modify -21212121 --property shell=zsh` Pokud prostředí nalezené v systému Linux není podporované, `sh` použije se 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řipojení k cílovému systému Linux v sadě Visual Studio

Sdílet prostřednictvím