Compartir a través de

Referencia de ConnectionManager

  • Artículo

ConnectionManager.exe está disponible en Visual Studio 2019, versión 16.5 y posteriores.

ConnectionManager.exe es una utilidad de línea de comandos para administrar conexiones de desarrollo remotas fuera de Visual Studio. Resulta útil para tareas como el aprovisionamiento de una nueva máquina de desarrollo. O bien, úsela para configurar Visual Studio para la integración continua. Puede usarla en una ventana Símbolo del sistema para desarrolladores. Para obtener más información sobre la ventana Símbolo del sistema para desarrolladores, consulte Uso del conjunto de herramientas de Microsoft C++ desde la línea de comandos.

ConnectionManager.exe está disponible en Visual Studio 2019, versión 16.5 y posteriores. Formar parte de la carga de trabajo Desarrollo de Linux con C++ del Instalador de Visual Studio. También se instala automáticamente cuando se elige el componente Administrador de conexiones de en el instalador. Se instala en %VCIDEInstallDir%\Linux\bin\ConnectionManagerExe\ConnectionManager.exe.

La funcionalidad de ConnectionManager.exe también está disponible en Visual Studio. Para administrar las conexiones de desarrollo remotas en el IDE, en la barra de menús elija Herramientas>Opciones para abrir el cuadro de diálogo Opciones. En el cuadro de diálogo Opciones, seleccione Multiplataforma>Administrador de conexiones.

Sintaxis

ConnectionManager.exe comando [argumentos] [opciones]

Comandos y argumentos

  • add usuario@host [--port puerto] [--password contraseña] [--privatekey archivoPrivatekey]

    Autentica y agrega una nueva conexión. De forma predeterminada, usa el puerto 22 y la autenticación de contraseña. (Se le pedirá que escriba una contraseña).

    Puede utilizar una contraseña o un archivo de claves y una frase de contraseña para la autenticación. Los archivos de clave son más seguros que el nombre de usuario y la contraseña. Si ya tiene un par de claves, puede reutilizarlo. Use y --password --privatekey para especificar una frase de contraseña para un archivo de clave privada.

    Las versiones de Visual Studio anteriores a la 17.10 admiten claves de curva elíptica (EC), Rivert-Shamir-Adleman (RSA) y algoritmo de firma digital (DSA) para conexiones remotas. Debido a problemas de seguridad, las claves RSA y DSA ya no se admiten en VS 17.10 y versiones posteriores. Actualmente solo se admiten claves EC.

    Para crear un par de claves compatible con el administrador de conexiones, use el comando ssh-keygen -m pem -t ecdsa -f <key-name>. Si usa ssh-keygen para crear la clave privada, debe especificar el modificador -m pemo Visual Studio no aceptará la clave. Si la clave privada comienza por -----BEGIN OPENSSH PRIVATE KEY-----, debe convertirla con ssh-keygen -p -f <FILE> -m pem.

  • clean

    Elimina la caché del encabezado de las conexiones que ya no existen.

  • help

    Muestra una pantalla de ayuda.

  • list [--properties]

    Muestra información, identificadores y propiedades de todas las conexiones almacenadas.
    Para obtener ejemplos, vea Propiedades de uso frecuente.

  • modify [valorPredeterminado | identificadorConexión | usuario@host [--portpuerto]] [--propertyclave=valor]

    Define o modifica una propiedad en una conexión.
    Si valor está vacío, la propiedad clave se elimina.
    Si se produce un error de autenticación, no se realizan cambios.
    Si no se especifica ninguna conexión, se usa la conexión remota predeterminada del usuario.

  • remove [identificadorConexión | usuario@host [--port puerto]]

    Quita una conexión. Si no se especifica ningún argumento, se le pedirá que especifique la conexión que desea quitar.

  • remove-all

    Quita todas las conexiones almacenadas.

  • update [valorPredeterminado | todo | identificadorConexión | usuario@host [--portpuerto]] [--previous] [--fingerprint]

    Se agregó en Visual Studio 16.10. Actualiza la huella digital de la clave de host de las conexiones especificadas.

  • version

    Muestra información de la versión.

Opciones

  • --file nombredearchivo

    Lea la información de conexión del nombre de archivo proporcionado.

  • --fingerprint

    Huella digital de la clave de host presentada por el servidor. Use esta opción con list para ver la huella digital de una conexión.

  • -i

    Igual a --privatekey.

  • -n, --dry-run

    Realiza un simulacro del comando.

  • --no-prompt

    Genera un error en lugar de un mensaje, cuando corresponde.

  • --no-telemetry

    Deshabilite el envío de datos de uso a Microsoft. Los datos de uso se recopilan y se envían de vuelta a Microsoft a menos que se pase la marca --no-telemetry .

  • --no-verify

    Agregue o modifique una conexión sin autenticación.

  • --p

    Igual a --password.

  • --previous

    Indica que las conexiones se leerán en la versión anterior del administrador de conexiones, se actualizarán y se escribirán en la nueva versión.

  • -q, --quiet

    Impide la salida a stdout o stderr.

Ejemplos

Este comando agrega una conexión para un usuario denominado "user" en localhost. La conexión usa un archivo de clave para la autenticación, que se encuentra en %USERPROFILE%.ssh\id_rsa.

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

Este comando quita la conexión con el identificador 1975957870 de la lista de conexiones.

ConnectionManager.exe remove 1975957870

Propiedades de uso frecuente

Propiedad Descripción
authentication type Tipo de autenticación usado para la conexión como: "password", "privatekey".
Para crear una conexión con el tipo de autenticación establecido en "privatekey": ConnectionManager.exe add user@127.0.0.1 --privatekey "%USERPROFILE%\.ssh\id_rsa".
default Valor booleano que indica si se trata de la conexión predeterminada. La conexión predeterminada se usa cuando hay más de una conexión disponible y no se especifica la que se va a usar.
Para establecer que la conexión especificada sea la conexión predeterminada: ConnectionManager.exe modify -21212121 --property default=true.
host El nombre o la dirección IP del equipo remoto.
Para cambiar el host de la conexión especificada a otra máquina, en este caso, host local: ConnectionManager.exe modify -21212121 --property host=127.0.0.1.
isWsl Devuelve true si la sesión remota se está ejecutando Subsistema de Windows para Linux.
password La contraseña para la conexión. Cambie la contraseña de la conexión especificada con: ConnectionManager.exe modify -21212121 --property password="xyz".
platform La plataforma del equipo remoto, como "ARM", "ARM64", "PPC", "PPC64", "x64", "x86".
port Puerto utilizado para la conexión.
Cambie el puerto de la conexión especificada: ConnectionManager.exe modify -21212121 --property port=22.
shell Shell preferido que se usará en el sistema remoto. Los shells admitidos son: sh, csh, bash, tcsh, ksh, zsh, dash.
Para establecer que el shell preferido sea zsh para la máquina remota en la conexión especificada: ConnectionManager.exe modify -21212121 --property shell=zsh.
Si no se admite el shell que se encuentra en el sistema Linux, se usa sh para todos los comandos.
systemID El tipo de sistema remoto, como "OSX", "Ubuntu".
timeout El tiempo de espera de la conexión, en milisegundos. Cambie el tiempo de espera de la conexión especificada con: ConnectionManager.exe modify -21212121 --property timeout=100.
username El nombre del usuario que ha iniciado sesión en el equipo remoto.
Para agregar una conexión para un usuario llamado "user" en localhost: ConnectionManager.exe add user@127.0.0.1.

Consulta también

Conexión al sistema Linux de destino en Visual Studio