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 um novo computador de desenvolvimento. Ou use-o para configurar Visual Studio para integração contínua. Você pode usá-lo 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 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, escolha ToolsOptions> para abrir a caixa de diálogo Opções. Na caixa de diálogo Opções, selecione Plataforma> Cruzada Gerenciador de Conexões.

Syntax

ConnectionManager.execommand [arguments] [options]

Comandos e argumentos

  • adduser@host [--portporta] [--passwordsenha] [--privatekeyprivatekey_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.) Use ambos --password e --privatekey especifique uma senha para uma chave privada.

  • 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 as 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 (o que significa por padrão, acima), a conexão remota padrão do usuário será usada.

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

    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 [--portporta]] [--previous] [--fingerprint]

    Adicionado em 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

  • --fileFilename

    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 list para exibir a impressão digital de uma conexão.

  • -i

    Mesmo que --privatekey.

  • -n, --dry-run

    Faz uma execução seca do comando.

  • --no-prompt

    Falha em vez de prompt, quando apropriado.

  • --no-telemetry

    Desabilite o envio de dados de uso de volta para a Microsoft. Os dados de uso são coletados e enviados de volta para a Microsoft, a menos que o --no-telemetry sinalizador 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 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 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 booliano 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 a 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 para a conexão especificada com 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 sendo executada 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 para a conexão.
Altere a porta para a conexão especificada: ConnectionManager.exe modify -21212121 --property port=22
shell O shell preferencial a 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, será sh 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 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

Confira também

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