Partilhar via

Referência do ConnectionManager

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

ConnectionManager.exe é um utilitário de linha de comando para gerenciar conexões de desenvolvimento remoto fora do Visual Studio. É útil para tarefas como provisionar uma nova máquina de desenvolvimento. Ou, use-o para configurar o Visual Studio para integração contínua. Você pode usá-lo numa janela de Linha de Comandos 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. Faz parte da carga de trabalho Desenvolvimento Linux com C++ no Visual Studio Installer. Ele também é instalado automaticamente quando você escolhe o componente Connection Manager no instalador. Está instalado em %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, escolhaOpções de > para abrir a caixa de diálogo Opções. Na caixa de diálogo Opções, selecione Gerenciador deconexões>.

Sintaxe

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

Comandos e argumentos

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

    Autentica e adiciona uma nova conexão. Por padrão, ele usa a porta 22 e a autenticação de senha. (É-lhe pedido que introduza uma palavra-passe.)

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

    As versões do Visual Studio anteriores à 17.10 suportam chaves Elliptic Curve (EC), Rivert-Shamir-Adleman (RSA) e Digital signature algorithm (DSA) para conexões remotas. Devido a preocupações de segurança, as chaves RSA e DSA não são mais suportadas no VS 17.10 e posterior. Atualmente, apenas as chaves EC são suportadas.

    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, você deve especificar a opção -m pem, ou a chave não será aceita pelo Visual Studio. Se sua chave privada começar com -----BEGIN OPENSSH PRIVATE KEY-----, você deverá convertê-la com ssh-keygen -p -f <FILE> -m pem.

  • clean

    Exclui o cache de cabeçalho para 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 [--portporta]] [--propertykey=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 [--portport]]

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

  • remove-all

    Remove todas as conexões armazenadas.

  • update [padrão | tudo | connection_id | user@host [--portport]] [--previous] [--fingerprint]

    Adicionado no Visual Studio 16.10. Atualiza a impressão digital da chave do host da(s) conexão(ões) especificada(s).

  • version

    Exibe informações de versão.

Opções

  • --file nome do arquivo

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

  • --fingerprint

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

  • -i

    O mesmo que --privatekey.

  • -n, --dry-run

    Faz uma execução seca do comando.

  • --no-prompt

    Falha em vez de prompt, quando apropriado.

  • --no-telemetry

    Desative o envio de dados de uso de volta para a Microsoft. Os dados de uso são recolhidos e enviados de volta para a Microsoft, exceto se for passado o sinalizador --no-telemetry.

  • --no-verify

    Adicione ou modifique uma conexão sem autenticação.

  • --p

    O mesmo que --password.

  • --previous

    Indica que a(s) conexão(ões) será(ão) lida(s) da versão anterior do gerenciador de conexões, atualizada e gravada na nova versão.

  • -q, --quiet

    Impede a saída para stdout ou stderr.

Exemplos

Este comando adiciona uma conexão para um usuário chamado "user" 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"

Este comando remove a conexão que tem ID 1975957870 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 para a 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 esta é a conexão padrão. A conexão padrão é usada quando há mais de uma conexão disponível e a que deve ser usada não é 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 outra máquina, neste caso, host local: ConnectionManager.exe modify -21212121 --property host=127.0.0.1
isWsl Retorna true se a sessão remota estiver executando o Subsistema Windows para Linux.
password A senha para a conexão. Altere a senha para a 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 para a conexão.
Altere a porta para a conexão especificada: ConnectionManager.exe modify -21212121 --property port=22
shell O shell preferido para usar no sistema remoto. Os shells suportados são sh, csh, bash, tcsh, ksh, zsh, dash
Para definir o shell preferido como zsh para a máquina remota na conexão especificada: ConnectionManager.exe modify -21212121 --property shell=zsh
Se o shell encontrado no sistema Linux não for suportado, então sh será usado para todos os comandos.
systemID O tipo de sistema remoto, como "OSX", "Ubuntu".
timeout O tempo limite de conexão em milissegundos. Altere o tempo limite para a 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

Ver também

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

  • Last updated on