Leer en inglés

Compartir a través de


Actualización de Visual Studio con un diseño sin conexión mínimo

En el caso de los equipos que no están conectados a Internet, crear un diseño mínimo es la manera más sencilla y rápida de actualizar las instancias de Visual Studio sin conexión.

La herramienta de diseño mínimo genera un diseño adaptado específicamente a las necesidades de su equipo. Los administradores de empresa pueden usar esta herramienta para crear diseños de actualización para la mayoría de las versiones de Visual Studio, incluido Visual Studio 2017. A diferencia de un diseño completo de Visual Studio, un diseño mínimo solo contiene los paquetes actualizados, por lo que siempre es más pequeño y rápido generar e implementar. Puede minimizar aún más el tamaño del diseño de actualización especificando solo los idiomas, cargas de trabajo y componentes deseados.

Cómo generar un diseño mínimo

Importante

En estas instrucciones se supone que ha creado y usado diseños previamente. Para obtener más información sobre cómo hacerlo, consulte la página Actualizar una instalación basada en red de Visual Studio.

Para comprender mejor el ciclo de vida de Visual Studio, consulte la página ciclo de vida y mantenimiento del producto de Visual Studio.

Esta herramienta crea diseños de actualización para Visual Studio 2017 (15.9) y versiones posteriores. El diseño se puede implementar en máquinas de red o sin conexión para actualizar instancias de Visual Studio. Durante la creación del diseño normal, se descargan todos los paquetes de la versión en cuestión. La creación normal del diseño es necesaria para reparar, desinstalar y otras operaciones estándar en instancias de Visual Studio. El diseño mínimo descarga solo los paquetes actualizados, por lo que es más pequeño y fácil de copiar en máquinas sin conexión.

Instalación de la herramienta de diseño mínimo

  1. En primer lugar, descargue la herramienta de diseño mínimo, disponible aquí. Asegúrese de elegir Guardar cuando se le solicite y, después, seleccione Ejecutar.

    Herramienta para guardar el diseño mínimo

  2. A continuación, acepte la solicitud de Control de cuentas de usuario haciendo clic en .

    Aceptar control de cuentas de usuario

  3. La herramienta de diseño mínimo se instalará en C:\Program Files (x86)\Microsoft Visual Studio\MinimalLayout.

Cómo usar la herramienta para diseño minimalista

MinimalLayout.exe usa los siguientes comandos y opciones para generar el diseño. Se requiere al menos un comando para ejecutar la herramienta. Aquí se muestra cómo ejecutará la herramienta:

MinimalLayout.exe [command] <options>...

Comandos

  • vista previa: use este comando para obtener una vista previa del número de paquetes que se descargarán y el espacio total usado para crear este diseño.

  • Generar: use este comando para generar el diseño mínimo para actualizar Visual Studio.

  • Regenerar:use este comando para volver a generar un diseño mediante un archivo de respuesta de diseño mínimo existente. Cada diseño mínimo genera un archivo de respuesta MinimalLayout.json, que contiene los parámetros de entrada de diseño mínimos originales. Puede usar el comando Regenerar y un archivo de respuesta MinimalLayout.json para volver a generar el diseño mínimo. Esto resulta útil si desea crear un diseño mínimo para una nueva actualización de Visual Studio basada en el archivo de respuesta del diseño mínimo anterior.

    Para este comando, se requiere una ruta de archivo MinimalLayout.json de un diseño ya generado.

    shell
    MinimalLayout.exe regenerate --filePath C:\MinimalLayout\MinimalLayout.json
    
  • Comprobar: use este comando para determinar si la carpeta de diseño está dañada.

  • Corregir: use este comando para corregir una carpeta de diseño dañada, incluida la sustitución de los paquetes que faltan de la carpeta de diseño.

Opciones

Opciones Descripción Obligatorio/Opcional Ejemplo
--targetLocation <dir> Especifica un directorio en el que se creará un diseño sin conexión mínimo. Obligatorio --targetLocation c:\VSLayout\
--baseVersion <version> El diseño mínimo sin conexión se generará a partir de esta versión. Obligatorio --baseVersion 16.4.0
--targetVersion <version> El diseño mínimo sin conexión se generará hasta esta versión (incluida). Obligatorio --targetVersion 16.4.4
--Idiomas Especifica los idiomas que se van a incluir en el diseño mínimo sin conexión. Se pueden especificar varios valores, separados por espacios. Obligatorio --languages en-US fr-FR
--productIds <uno o varios identificadores de producto> Identificadores de los productos desde los que se generará el diseño sin conexión mínimo, separados por comas.
  • Microsoft.VisualStudio.Product.Enterprise
  • Microsoft.VisualStudio.Product.Professional
  • Microsoft.VisualStudio.Product.BuildTools
  • Microsoft.VisualStudio.Product.TestAgent
  • Microsoft.VisualStudio.Product.TestController
  • Microsoft.VisualStudio.Product.TeamExplorer
Obligatorio --productIds Microsoft.VisualStudio.Product.Enterprise,Microsoft.VisualStudio.Product.Professional
--filePath Ruta de acceso del archivo MinimalLayout.json de un diseño ya creado. Esta opción solo se usa con el comando Regenerar. Obligatorio para el comando Regenerar --filePath C:\VSLayout\minimalLayout.json

Tenga en cuenta que el comando Regenerar solo toma --filePath como opción.
--add <(al menos un id. de componente o carga de trabajo)> Especifica uno o varios identificadores de carga de trabajo o componente que se van a agregar. Se pueden agregar componentes adicionales globalmente mediante --includeRecommended y/o
--includeOptional. Se pueden especificar varias cargas de trabajo o identificadores de componente, separados por un espacio.
Opcional --add Microsoft.VisualStudio.Workload.ManagedDesktop Microsoft.VisualStudio.Workload.NetWeb Component.GitHub.VisualStudio
--includeRecommended Incluye los componentes recomendados para las cargas de trabajo instaladas, pero no para los componentes opcionales. Opcional Para una carga de trabajo específica:
--add Microsoft.VisualStudio.Workload. ManagedDesktop;includeRecommended

Para la aplicación a todas las cargas de trabajo: --includeRecommended
--includeOptional Incluye los componentes opcionales para cualquier carga de trabajo que se instale, pero no los componentes recomendados. Opcional Para una carga de trabajo específica:
--add Microsoft.VisualStudio.Workload. ManagedDesktop;includeOptional

Para aplicar a todas las cargas de trabajo: --includeOptional

Generación de un diseño mínimo

Importante

En estas instrucciones se supone que ha creado previamente un diseño de instalación de red. Para obtener más información sobre cómo hacerlo, consulte la página Crear una instalación de red de Visual Studio.

Cree un diseño mínimo mediante el comando generar para el intervalo de versiones especificado. También deberá conocer productId, idiomas y las cargas de trabajo específicas necesarias. Este diseño mínimo actualizará cualquier instancia de Visual Studio desde la versión base hasta la versión de destino.

Antes de crear el diseño, puede averiguar el tamaño total de la descarga y el número de paquetes incluidos mediante el comando preview. Este comando toma las mismas opciones que el comando generar, y los detalles se registran en la consola.

Veamos algunos ejemplos de cómo obtener una vista previa, generar y volver a generar un diseño mínimo:

  • En primer lugar, este es un ejemplo de cómo obtener una vista previa de un diseño para las versiones 16.4.0 de Visual Studio Enterprise a 16.4.4 solo para inglés.

    shell
    MinimalLayout.exe preview --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --languages en-US
    
  • Aquí se muestra cómo generar ese mismo diseño con una carga de trabajo.

    shell
    MinimalLayout.exe generate --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop;includeOptional --languages en-US
    
  • Y aquí se muestra cómo volver a generar un diseño sin conexión mínimo mediante un archivo de respuesta existente.

    shell
    MinimalLayout.exe regenerate --filepath c:\VSLayout\MinimalLayout.json
    

Algunos otros ejemplos que usan el comando generar:

  • Aquí se muestra cómo agregar una carga de trabajo adicional e incluir solo los paquetes recomendados.

    shell
    MinimalLayout.exe generate --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Professional --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop Microsoft.VisualStudio.Workload.NetWeb;includeRecommended --languages en-US
    
  • También puede generar un diseño offline mínimo que admita varios productos.

    shell
    MinimalLayout.exe generate --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise,Microsoft.VisualStudio.Product.Professional --baseVersion 16.4.0 --targetVersion 16.4.4 --languages en-US
    
  • Y por último, aquí se muestra cómo incluir varios idiomas en el diseño mínimo.

    shell
    MinimalLayout.exe generate --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop;includeOptional --languages en-US fr-FR
    

Cómo mantener un diseño mínimo

Use los comandos Comprobar y Corregir para mantener el diseño mínimo después de su creación. El comando verificar determina si hay algún paquete dañado o que falta en el diseño mínimo. Si tiene algún problema después de ejecutar el comando comprobar, use el comando corregir para corregir los paquetes que faltan o están dañados.

  • Aquí se muestra cómo comprobar si un diseño tiene paquetes dañados o que faltan:

    shell
    MinimalLayout.exe Verify --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop --includeRecommended --languages en-US
    
  • Y aquí se muestra cómo corregir ese diseño:

    shell
    MinimalLayout.exe fix --targetLocation C:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop;includeRecommended --languages en-US
    

Nota

Este diseño no se puede usar para reparar una instalación de Visual Studio. Para reparar una instancia existente de Visual Studio, consulte Reparar Visual Studio.

Cómo usar un diseño sin conexión mínimo para actualizar una instalación existente de Visual Studio

Después de generar un diseño mínimo, puede copiar toda la carpeta de diseño mínima en un equipo cliente. Esto es necesario si el equipo no tiene acceso a la carpeta de diseño mínima en su ubicación original.

Vaya a la carpeta e identifique el nombre de la aplicación bootstrapper. El nombre de la aplicación bootstrap depende del valor de la variable ProductId especificado al generar el diseño mínimo. Consulte la tabla siguiente para ver ejemplos comunes.

Valor de ProductId Nombre de la aplicación
Microsoft.VisualStudio.Product.Enterprise vs_enterprise.exe
Microsoft.VisualStudio.Product.Professional vs_professional.exe
Microsoft.VisualStudio.Product.BuildTools vs_buildtools.exe

La actualización se aplica a una instancia de Visual Studio en dos pasos. Empiece por actualizar el Instalador de Visual Studio y, a continuación, actualice Visual Studio.

  1. Actualizar el instalador de Visual Studio

    Ejecute el comando siguiente, sustituyendo vs_enterprise.exe por el nombre de aplicación de arranque correcto si es necesario.

    shell
    vs_enterprise.exe --quiet --update --offline C:\VSLayout\vs_installer.opc
    
  2. Actualizar la aplicación de Visual Studio

    Para actualizar Visual Studio, debe especificar la propiedad installPath de la instancia de Visual Studio que desea actualizar. Si hay varias instancias de Visual Studio instaladas, cada una debe actualizarse por separado. Se recomienda encarecidamente especificar la opción –noWeb con el comando update para evitar la instalación de componentes que no están en el diseño mínimo. Esto evita que deje Visual Studio en un estado inutilizable.

    Ejecute el siguiente comando y sustituya el parámetro de línea de comandos installPath adecuadamente. Asegúrese de usar también el nombre correcto de la aplicación bootstrapper.

    shell
    vs_enterprise.exe update --noWeb --quiet --installpath "C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise"
    
  1. Actualizar el instalador de Visual Studio

    Ejecute el comando siguiente, sustituyendo vs_enterprise.exe por el nombre de aplicación de arranque correcto si es necesario.

    shell
    vs_enterprise.exe --quiet --update --offline C:\VSLayout\vs_installer.opc
    
  2. Actualizar la aplicación de Visual Studio

    Para actualizar Visual Studio, debe especificar la propiedad installPath de la instancia de Visual Studio que desea actualizar. Si hay varias instancias de Visual Studio instaladas, cada una debe actualizarse por separado. Se recomienda encarecidamente especificar la opción –noWeb con el comando update para evitar la instalación de componentes que no están en el diseño mínimo. Esto evita que deje Visual Studio en un estado inutilizable.

    Ejecute el siguiente comando y sustituya el parámetro de línea de comandos installPath adecuadamente. Asegúrese de usar también el nombre de aplicación de programa previo correcto.

    shell
    vs_enterprise.exe update --noWeb --quiet --installpath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise"
    

Soporte técnico o solución de problemas

A veces, las cosas pueden ir mal. Si se produce un error en la instalación de Visual Studio, consulte Solución de problemas de instalación y actualización de Visual Studio para obtener instrucciones paso a paso.

Estas son algunas opciones de soporte técnico más:

  • Use la opción de soporte del chat de instalación (solo inglés) para problemas relacionados con la instalación.
  • Informe problemas del producto usando la herramienta Notificar un problema, que aparece tanto en el Instalador de Visual Studio como en el IDE de Visual Studio. Si es administrador de TI y no tiene Visual Studio instalado, puede enviar comentarios del administrador de TI.
  • Sugerir una característica, realizar un seguimiento de los problemas del producto y encontrar respuestas en el Visual Studio Developer Community.