Referencia de ConnectionManager

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.execomando [argumentos] [opciones]

Comandos y argumentos

• addusuario@host [--portpuerto] [--passwordcontraseña] [--privatekeyarchivo_de_clave_privada]

  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). Use --password y --privatekey para especificar una contraseña para una clave privada.

• 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 [valor_predeterminado | id_conexió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 (lo que significa predeterminado, arriba), se usa la conexión remota predeterminada del usuario.

• remove [id_conexión | usuario@host [--portpuerto]]

  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 [valor_predeterminado | all | id_conexió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

• --filenombredearchivo

  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