Referência do ConnectionManager

O ConnectionManager.exe é um utilitário de linha de comando para gerenciar conexões de desenvolvimento remoto fora do Microsoft Visual Studio. Ele é útil para tarefas como provisionamento de uma nova máquina de desenvolvimento. Ou use-o para configurar o Microsoft Visual Studio para integração contínua. Use-o em uma janela do Prompt de Comando do Desenvolvedor. Para obter mais informações sobre o Prompt de Comando do Desenvolvedor, consulte Usar o conjunto de ferramentas do Microsoft C++ na linha de comando.

ConnectionManager.exe está disponível no Visual Studio 2019 versão 16.5 e posterior. Ele faz parte do desenvolvimento do Linux com carga de trabalho C++ no Instalador do Visual Studio. Ele também é instalado automaticamente quando você escolhe o componente Gerenciador de Conexões no instalador. Ele é instalado no %VCIDEInstallDir%\Linux\bin\ConnectionManagerExe\ConnectionManager.exe.

A funcionalidade do ConnectionManager.exe também está disponível no Visual Studio. Para gerenciar conexões de desenvolvimento remoto no IDE, na barra de menus, escolhaFerramentas>Opções para abrir a caixa de diálogo Opções. Na caixa de diálogo Opções, selecione Plataforma cruzada>Gerenciador de Conexões.

Sintaxe

ConnectionManager.exe comando [argumentos] [opções]

Comandos e argumentos

• add user@host [--port porta] [--password senha] [--privatekey privatekey_file]

  Autentica e adiciona uma nova conexão. Por padrão, ele usa a porta 22 e a autenticação de senha. (Você será solicitado a inserir uma senha.)

  Você pode usar uma senha ou um arquivo de chave e a frase secreta para autenticação. Os arquivos de chave são mais seguros do que o nome de usuário/senha. Se você já tem um par de chaves, é possível reutilizá-lo. Use ambos --password e --privatekey para especificar uma senha para um arquivo de chave privada.

  As versões do Visual Studio anteriores à 17.10 dão suporte às chaves EC (Curva Elíptica), RSA (Rivert-Shamir-Adleman) e DSA (algoritmo de assinatura digital) para conexões remotas. Devido a questões de segurança, não há mais suporte para chaves RSA e DSA no VS 17.10 e posteriores. No momento, há suporte somente para chaves EC.

  Para criar um par de chaves compatível com o gerenciador de conexões, use o comando ssh-keygen -m pem -t ecdsa -f <key-name>. Se você usar ssh-keygen para criar a chave privada, deverá especificar a opção -m pemou a chave não será aceita pelo Visual Studio. Se a chave privada começar com -----BEGIN OPENSSH PRIVATE KEY-----, converta-a com ssh-keygen -p -f <FILE> -m pem.

• clean

  Exclui o cache de cabeçalho de conexões que não existem mais.

• help

  Exibe uma tela de ajuda.

• list [--properties]

  Exibe informações, IDs e propriedades de todas as conexões armazenadas.
  Para obter exemplos, consulte Propriedades comumente usadas.

• modify [padrão | connection_id | user@host [--port porta]] [--property key=value]

  Define ou modifica uma propriedade em uma conexão.
  Se o valor estiver vazio, a chave de propriedade será excluída.
  Se a autenticação falhar, nenhuma alteração será feita.
  Se nenhuma conexão for especificada, a conexão remota padrão do usuário será usada.

• remove [connection_id | user@host [--port porta]]

  Remove uma conexão. Se nenhum argumento for especificado, será solicitado que você especifique qual conexão remover.

• remove-all

  Remove todas as conexões armazenadas.

• update [padrão | todos | connection_id | user@host [--port porta]] [--previous] [--fingerprint]

  Adicionado no Microsoft Visual Studio 16.10. Atualiza a impressão digital da chave de host das conexões especificadas.

• version

  Exibe informações de versão.

Opções

• --file filename

  Leia as informações de conexão do nome de arquivo fornecido.

• --fingerprint

  A impressão digital da chave de host apresentada pelo servidor. Use essa opção com list para exibir a impressão digital de uma conexão.

• -i

  Mesmo que --privatekey.

• -n, --dry-run

  Faz uma execução DRY do comando.

• --no-prompt

  Falha em vez de aviso, quando adequado.

• --no-telemetry

  Desabilitar o envio de dados de uso para a Microsoft. Os dados de uso são coletados e enviados para a Microsoft, a menos que o sinalizador --no-telemetry seja passado.

• --no-verify

  Adicionar ou modificar uma conexão sem autenticação.

• --p

  Mesmo que --password.

• --previous

  Indica que as conexões serão lidas a partir da versão anterior do gerenciador de conexões, atualizadas e gravadas na nova versão.

• -q, --quiet

  Impede a saída para stdout ou stderr.

Exemplos

Esse comando adiciona uma conexão para um usuário chamado "usuário" no localhost. A conexão usa um arquivo de chave para autenticação, encontrado em %USERPROFILE%.ssh\id_rsa.

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

Esse comando remove a conexão que tem 1975957870 de ID da lista de conexões.

ConnectionManager.exe remove 1975957870

Propriedades comumente usadas

Propriedade	Descrição
tipo de autenticação	O tipo de autenticação usado na conexão, como: "password", "privatekey". Para criar uma conexão com o tipo de autenticação definido como "privatekey": ConnectionManager.exe add user@127.0.0.1 --privatekey "%USERPROFILE%\.ssh\id_rsa"
default	Um booleano que indica se essa é a conexão padrão. A conexão padrão é usada quando há mais de uma conexão disponível e a conexão que será usada não está especificada. Para definir a conexão especificada como a conexão padrão: ConnectionManager.exe modify -21212121 --property default=true
host	O nome ou endereço IP do computador remoto. Para alterar o host da conexão especificada para outro computador, nesse caso, o host local: ConnectionManager.exe modify -21212121 --property host=127.0.0.1
isWsl	Retornará true se a sessão remota estiver executando o Subsistema do Windows para Linux.
password	A senha para a conexão. Altere a senha da conexão especificada com: ConnectionManager.exe modify -21212121 --property password="xyz"
platform	A plataforma do computador remoto, como"ARM", "ARM64", "PPC", "PPC64", "x64", "x86".
port	A porta usada na conexão. Altere a porta da conexão especificada: ConnectionManager.exe modify -21212121 --property port=22
shell	O shell preferencial que será usado no sistema remoto. Os shells com suporte são sh, csh, bash, tcsh, ksh, zsh, dash Para definir o shell preferencial como zsh para o computador remoto na conexão especificada: ConnectionManager.exe modify -21212121 --property shell=zsh Se o shell encontrado no sistema Linux não tiver suporte, sh será usado para todos os comandos.
systemID	O tipo de sistema remoto, como "OSX", "Ubuntu".
timeout	O tempo limite da conexão em milissegundos. Altere o tempo limite da conexão especificada com: ConnectionManager.exe modify -21212121 --property timeout=100
username	O nome do usuário conectado ao computador remoto. Para adicionar uma conexão para um usuário nomeado "user" no localhost: ConnectionManager.exe add user@127.0.0.1

Confira também

Conectar-se a seu sistema Linux de destino no Visual Studio