Referência do ConnectionManager

  • Artigo

ConnectionManager.exe está disponível no Visual Studio 2019 versão 16.5 e posterior.

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