Crear y mantener una instalación de red de Visual Studio

📣Nos encantaría conocer su opinión.Dedique un momento a realizar esta encuesta y díganos cómo podríamos mejorar el diseño del entorno. ¡Gracias por su colaboración!

A veces, un administrador de empresa desea crear una caché de instalación privada (también conocida como "diseño") que contenga archivos de Visual Studio que se puedan implementar en equipos de cliente dentro de una organización.

La creación de un diseño es útil en situaciones siguientes:

• Un usuario tiene permisos limitados
• Los equipos cliente tienen acceso limitado a Internet
• Una organización desea estandarizar una versión concreta del conjunto de herramientas para desarrolladores

Hemos diseñado Visual Studio para que un administrador pueda crear y mantener una presentación, almacenarla en un recurso compartido de red interna y, opcionalmente, ponerla a disposición en la intranet de una organización. El diseño actúa como ubicación de origen para todos los archivos de Visual Studio necesarios para la instalación inicial en el cliente y las actualizaciones posteriores.

La información de esta página se agrupa en tres secciones principales:

• Crear la presentación: describe cómo crear la presentación con el contenido de producto correcto, configurar los ajustes predeterminados, almacenarla en un recurso compartido de red y ponerla a disposición en la intranet.
• Mantenimiento del diseño: información sobre cómo actualizar mejor la versión de producto del diseño o modificar el contenido del producto, la configuración del canal, la versión del instalador y el tamaño de carpeta del diseño.
• Ayuda y soporte técnico: dónde pedir ayuda

Creación del diseño

Preparación de la ubicación de almacenamiento del recurso compartido de archivos de red

En primer lugar, debe determinar dónde va a almacenar los paquetes de Visual Studio descargados. Si tiene varias ediciones de Visual Studio en uso dentro de su empresa como, por ejemplo, Visual Studio 2022 Professional y Visual Studio 2022 Enterprise, debe crear un diseño aparte para cada edición. La creación de un diseño independiente para cada edición puede consumir mucho espacio en disco, especialmente si se tiene en cuenta que las actualizaciones de diseño también consumen espacio en disco.

La ruta de acceso del diseño debe tener menos de 80 caracteres, aunque algunas organizaciones utilizan correctamente vínculos simbólicos para evitar esta limitación.

Descarga del archivo de arranque de Visual Studio para crear el diseño

Descargue el archivo de arranque adecuado de la edición de Visual Studio que desee y cópielo en el directorio que desea que sirva como repositorio del diseño. Una vez que se haya creado el diseño, podrá usarlo para instalar Visual Studio en cualquier equipo cliente. El Programa previo es el archivo ejecutable que se usa para crear, actualizar y realizar otras operaciones de diseño. Debe tener una conexión a Internet y permisos de administrador para completar este paso.

Los siguientes cargadores de arranque siempre instalan la versión más reciente y segura de Visual Studio 2022 en el canal actual, independientemente de cuándo los ejecute. Como alternativa, si desea crear o actualizar un diseño a una versión específica o a un canal específico de Visual Studio 2022, descargue el cargador de arranque de la versión permanente y fija de la versión de mantenimiento correspondiente al canal que desee desde Historial de versiones de Visual Studio 2022. Cópielos en el directorio que desea que sirva como ubicación de origen del diseño.

Edición	Archivos de arranque
Visual Studio 2022 Enterprise	vs_enterprise.exe
Visual Studio 2022 Professional	vs_professional.exe
Visual Studio 2022 Community	vs_community.exe
Visual Studio 2022 Build Tools	vs_buildtools.exe

Sugerencia

Si previamente descargó un archivo de programa previo y quiere comprobar qué versión instalará, aquí se muestra cómo hacerlo. En Windows, abra el Explorador de archivos, haga clic con el botón derecho en el archivo del cargador de arranque, elija Propiedades y seleccione la pestaña Detalles. El campo Versión del producto describe el canal y la versión que se instalará en el arranque. El número de versión debe leerse siempre como la "versión de mantenimiento más reciente de lo que se especifica", y el canal será Current (Actual) a menos que se especifique de forma explícita. Por tanto, un archivo de arranque que tenga la versión de producto LTSC 17.0 instalará la versión de servicio 17.0.x más reciente que esté disponible en el canal de LTSC 17.0. Un cargador de arranque que tenga una versión de producto que indique Visual Studio 2022 instala la versión más reciente de Visual Studio 2022 en el canal actual.

Descarga de los paquetes de Visual Studio

Deberá disponer de conexión a Internet para poder realizar este paso.

Abra un símbolo del sistema con privilegios elevados, desplácese hasta el directorio en el que descargó el archivo de arranque y use los parámetros del archivo de arranque tal y como se define en la página Usar parámetros de la línea de comandos para instalar Visual Studio para crear y mantener el diseño de red. En los ejemplos siguientes se muestran formas comunes de crear diseños iniciales. Puede encontrar más muestras en la página Ejemplos de parámetros de la línea de comandos para una instalación de Visual Studio .

Un diseño completo inicial para una configuración regional de un solo idioma requiere aproximadamente 40 GB de espacio en disco para Visual Studio Community y unos 50 GB para Visual Studio Enterprise. Las configuraciones regionales adicionales requieren aproximadamente medio GB cada una.

El enfoque recomendado es crear un diseño inicial de Visual Studio con todos los idiomas correspondientes y todas las cargas de trabajo, y almacenar los paquetes en el directorio del diseño en el servidor de red. De este modo, cualquier instalación de cliente tiene acceso a toda la oferta de productos de Visual Studio y a la capacidad de instalar cualquier subconjunto. Para crear un diseño completo de Visual Studio, ejecute el siguiente comando desde el directorio en el que planea hospedar el diseño de red:

vs_enterprise.exe --layout c:\VSLayout

Asegúrese de que el diseño se base en el canal correcto.

Es importante asegurarse de que el diseño de red esté basado en el canal correcto, ya que este es uno de los criterios que actualiza el administrador; si se implementa en toda la organización, utilícelo para identificar qué instancias de cliente se deben actualizar. Por ejemplo, si el diseño se basa en el canal VisualStudio.17.Release.LTSC.17.0 y los clientes están configurados para recibir actualizaciones desde servidores hospedados de Microsoft, las actualizaciones de seguridad que se hagan disponibles en el canal LTSC 17.0 estarán disponibles para los clientes que se hayan instalado o actualizado desde ese diseño.

Los archivos de arranque enumerados anteriormente se basan en el canal Current (Actual). Para crear un diseño basado en uno de los canales LTSC, debe obtener el cargador de arranque del canal correcto en la página Historial de versiones de Visual Studio 2022, copiarlo en la carpeta del diseño y usarlo para crear o actualizar el diseño.

Configuración del contenido del diseño

Existen varias opciones que puede usar para personalizar el contenido del diseño de red. Puede crear un diseño parcial que solo contenga un conjunto específico de configuraciones regionales de idioma, cargas de trabajo y componentes, y sus dependencias recomendados u opcionales. Un diseño parcial resulta útil si sabe que solo va a implementar un subconjunto de las cargas de trabajo en las estaciones de trabajo cliente. Entre los parámetros de línea de comandos comunes para personalizar el diseño se incluyen:

• --add para especificar identificadores de carga de trabajo o componente.
  Si se usa --add, solo se descargan esas cargas de trabajo y componentes especificados con --add. Si no se usa --add, se descargan todos los componentes y cargas de trabajo.
• --includeRecommended: para incluir todos los componentes recomendados de los identificadores de carga de trabajo especificados.
• --includeOptional: para incluir todos los componentes opcionales de los identificadores de carga de trabajo especificados.
• --config para utilizar un archivo *.vsconfig para especificar las cargas de trabajo, componentes o extensiones que se deben incluir en el diseño o a los que se debe hacer referencia en el diseño. Asegúrese de especificar la ruta de acceso completa del archivo de configuración.
• --lang para especificar configuraciones regionales de idioma.

Estos son algunos ejemplos de cómo crear un diseño de red personalizado.

• Para crear un diseño con los componentes necesarios para todas las cargas de trabajo en un solo idioma, ejecute:

  vs_enterprise.exe --layout C:\VSLayout --lang en-US
  

• Para crear un diseño con los componentes necesarios para todas las cargas de trabajo en varios idiomas, ejecute:

  vs_enterprise.exe --layout C:\VSLayout --lang en-US de-DE ja-JP
  

• Para crear un diseño con una carga de trabajo y todos los componentes necesarios y recomendados para esa carga de trabajo, en todos los idiomas, ejecute:

  vs_enterprise.exe --layout C:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --includeRecommended
  

• Para crear un diseño con dos cargas de trabajo y un componente opcional en tres idiomas, ejecute:

  vs_enterprise.exe --layout C:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Microsoft.VisualStudio.Component.Git --lang en-US de-DE ja-JP
  

Uso de un archivo de configuración para inicializar el contenido de un diseño

Puede utilizar el parámetro --config para transferir un archivo *.vsconfig. Asegúrese de especificar la ruta de acceso completa del archivo de configuración. El uso de un archivo *.vsconfig durante la creación del diseño personaliza y limita el contenido de un diseño de red a lo que se especifica en el archivo de configuración. El archivo de configuración se copia en el directorio de diseño y se cambia el nombre a layout.vsconfig.

Las extensiones especificadas en el archivo *.vsconfig no se copian directamente en el diseño. En su lugar, el archivo response.json del diseño contiene una referencia al archivo layout.vsconfig recién creado, que define la ubicación de instalación para las extensiones del cliente. Si va a instalar extensiones que no están firmadas digitalmente, asegúrese de editar response.json para agregar "allowUnsignedExtensions": true. Consulte ejemplos de contenido de response.json.

vs_enterprise.exe --layout "C:\VSLayout" --config "C:\myconfig.vsconfig" 

Copia del diseño en un recurso compartido de red

Deberá hospedar el diseño en un recurso compartido de red para que se pueda acceder a él desde los equipos cliente. Si creó el diseño en un equipo local, deberá copiarlo en una ubicación de archivo de red. En el ejemplo siguiente se utiliza xcopy. Si quiere, también puede usar robocopy. Ejemplo:

xcopy /e c:\VSLayout \\server\share\layoutdirectory

Configuración de los valores predeterminados de instalación inicial del cliente para este diseño

Se crea un archivo llamado response.json en la carpeta raíz del diseño. Este archivo personalizable proporciona las opciones predeterminadas iniciales para configurar en el cliente cuando este se instala inicialmente desde el diseño. Entre las opciones de configuración comunes se incluyen la capacidad de configurar:

• Qué cargas de trabajo, componentes o idiomas deben instalarse de forma predeterminada en el cliente
• Si también se deben instalar los componentes recomendados
• Si el cliente debe respetar un archivo de instalación *.vsconfig
• De dónde debe recibir actualizaciones el cliente
• Si los componentes sin soporte técnico deben eliminarse durante una actualización
• Si las extensiones sin firmar pueden cargarse silenciosamente y mediante programación

Consulte la página Automatización de la instalación de Visual Studio con un archivo de respuesta para más información.

Hacer que el diseño sea accesible a través de un sitio de intranet

A partir de junio de 2023, podrá hacer que los diseños estén disponibles en un sitio de la intranet interna, lo que le permite aprovechar las funcionalidades de almacenamiento en caché de archivos de servidor web y rendimiento de replicación geográfica. Para usar esta nueva característica, debe usar los cargadores de arranque y el Instalador de Visual Studio más recientes. Los administradores de TI deben hacer lo siguiente para aprovechar esta funcionalidad de hospedaje web de la intranet:

1. En primer lugar, cree y mantenga un diseño de red y asegúrese de que las distintas partes estén presentes y se actualicen periódicamente en el recurso compartido de red. Además, recuerde configurar el valor de channelUri en el archivo response.json del diseño si quiere que los clientes obtengan sus actualizaciones desde la ubicación del diseño de la intranet.

2. A continuación, un administrador deberá preparar un sitio web interno y enlazar el origen del sitio web a la ubicación del archivo de red del diseño. También deben asegurarse de que el servidor web respete los siguientes tipos de MIME:

   Extensión de archivo	Tipo MIME
   .cab	application/vnd.ms-cab-compressed
   .exe	application/octet-stream
   .json	application/json
   .msi	application/octet-stream
   .msu	application/octet-stream
   .nupkg	application/octet-stream
   .opc	application/octet-stream
   .ps1	application/postscript
   .vsix	application/octet-stream
   .xml	text/xml
   .zip	application/x-zip-compressed

3. Por último, para implementar este diseño en el cliente, ejecute un script de PowerShell en el cliente para realizar la instalación inicial. Después de que Visual Studio se instale correctamente en el cliente desde un diseño hospedado en web, las actualizaciones del cliente de los diseños hospedados en web se podrán realizar a través de métodos estándar.

Asegurarse de que el diseño usa el instalador más reciente

Nota

A partir de junio de 2023, el instalador más reciente se distribuye de forma predeterminada con cada actualización a las versiones compatibles de Visual Studio 2017, Visual Studio 2019 y Visual Studio 2022. Por lo tanto, si utiliza alguna de las versiones mencionadas, no tendrá que realizar ninguna acción explícita para obtener la última versión del instalador con la funcionalidad y las correcciones de errores más recientes.

Si usa una versión de Visual Studio distribuida antes de junio de 2023, se recomienda usar siempre el instalador de Visual Studio más reciente en el diseño y distribuirlo a los clientes. Por ejemplo, si distribuye el instalador de Visual Studio 2022 en su diseño de Visual Studio 2019, los clientes de Visual Studio 2019 basados en ese diseño podrán cambiar la ubicación de origen de las actualizaciones o quitar con facilidad los componentes que no tengan soporte técnico. Puede consultar más información en la sección siguiente.

La capacidad de asegurarse mediante programación de que está usando el instalador más reciente solo está disponible para los cargadores de arranque de Visual Studio 2019 que se compilaron después de la distribución original de Visual Studio 2022. Así, el vs_enterprise.exe del siguiente ejemplo debe ser una versión que se haya enviado después del 10 de noviembre de 2021.

Para crear un diseño de todo el producto que utilice el instalador más reciente y mejor disponible, ejecute:

vs_enterprise.exe --layout C:\VSLayout --useLatestInstaller

Mantenimiento del diseño

Se recomienda actualizar el diseño de Visual Studio periódicamente a la versión segura más reciente del producto. Esto garantiza que el diseño se pueda usar tanto como punto de instalación como un origen de actualización de las instalaciones de cliente. En la siguiente sección, se describen las operaciones de mantenimiento de diseños más comunes o útiles.

Si hospeda un diseño en un recurso compartido de archivos de red, es posible que quiera descargar un diseño actualizado en un recurso compartido local privado (por ejemplo, c:\VSLayoutUpdate) y, después de descargar todo el contenido actualizado, copiarlo en el recurso compartido de red del diseño (por ejemplo, \server\products\VS). Si no lo hace, los usuarios que dé la casualidad de que ejecuten el programa de instalación mientras se actualiza el diseño no puedan obtener todo el contenido del diseño, ya que todavía no está completamente actualizado.

Actualización del diseño a la versión más reciente del producto

Microsoft publica con frecuencia versiones actualizadas del producto para corregir problemas de funcionalidad o seguridad. Le recomendamos encarecidamente mantener el diseño actualizado con la versión más reciente del producto para que los clientes siempre tengan acceso a la versión más reciente más segura del producto. Esto es muy importante si los clientes no tienen acceso a Internet y solo pueden recibir actualizaciones de producto desde el diseño. Visual Studio suele publicar actualizaciones de seguridad el segundo martes del mes, conocido como "Patch Tuesday", por lo que una buena estrategia sería actualizar todos los diseños durante la tarde del martes de actualizaciones.

Al crear el diseño inicial, las opciones especificadas, como las cargas de trabajo y los idiomas que se van a incluir en el diseño, se guardan en el archivo de configuración del diseño layout.json. Más adelante, al actualizar ese diseño a una versión más reciente del producto, no habrá que volver a especificar qué componentes del producto se quieren en el diseño. Una actualización de diseño simplemente actualiza los componentes existentes a su versión más actual.

Supongamos que ya ha creado este diseño parcial mediante uno de los Programas previos permanentes de la tabla anterior.

vs_enterprise.exe --layout c:\VSLayout --add Microsoft.VisualStudio.Workload.ManagedDesktop --lang en-US

Es fácil actualizar este diseño a la versión más reciente del producto ofrecida por Microsoft y hospedada en servidores de Microsoft. Solo tiene que usar el archivo de arranque permanente existente en el diseño y ejecutar el comando --layout en un símbolo del sistema con privilegios elevados para descargar los paquetes más recientes en el diseño. Puede hacerlo de la siguiente manera:

vs_enterprise.exe --layout c:\VSLayout

También puede actualizar el diseño a una versión más nueva de forma desatendida. La operación de diseño ejecuta el proceso de instalación en una ventana de consola nueva. La ventana se mantiene abierta para que los administradores puedan ver la actualización del diseño final y un resumen de los errores que pudieran haberse producido. Si quiere realizar una operación de actualización del diseño en modo desatendido (por ejemplo, tiene un script que se ejecuta periódicamente para actualizar el diseño a la versión más reciente), use el parámetro --passive y el proceso cerrará automáticamente la ventana.

vs_enterprise.exe --layout c:\VSLayout --passive

Actualización del diseño a una versión específica del producto

Es posible que en ocasiones desee actualizar el diseño a una versión determinada del producto. Por ejemplo, puede que desee que el diseño coincida con la versión más reciente y segura de la línea base de mantenimiento que ha estandarizado en la organización. Aquí se muestra cómo hacerlo:

Puede ir a la página Historial de versiones de Visual Studio 2022 y descargar un Programa previo de una versión fija determinada, copiarlos en el diseño y usarlos para actualizar el diseño a la versión exacta especificada en el Programa previo. Usaría exactamente la misma sintaxis que la anterior.

Puede usar una actualización de administrador para actualizar el diseño a una versión específica del producto. Para obtener la actualización del administrador, vaya al Catálogo de Microsoft Update y busque la actualización con la que quiere actualizar el diseño. Descargue el archivo update.exe en el equipo que hospeda el diseño, abra un símbolo del sistema con privilegios elevados en ese equipo y ejecute un comando como este:

visualstudioupdate-17.0.0to17.4.4.exe layout --layoutPath c:\VSLayout

Tenga en cuenta que la actualización del administrador no iniciará la creación de un nuevo diseño; solo actualizará un diseño existente. Deberá usar un cargador de arranque para crear el diseño inicial.

Garantía de que el diseño de red se basa en una versión compatible

En ocasiones, a medida que los canales salgan del soporte técnico, deberá asegurarse de que el diseño de red sigue basándose en un canal compatible para que los clientes puedan seguir recibiendo notificaciones de actualizaciones de seguridad. Si el diseño se basa en el canal VisualStudio.17.Release.LTSC.17.0, una vez que el canal LTSC 17.0 se deje de admitir en julio de 2023, no publicaremos más actualizaciones de seguridad en él y el diseño y los clientes se volverán poco seguros. Puede encontrar las fechas de soporte técnico para los distintos canales de Visual Studio 2022 aquí.

Para cambiar el canal en el que se basa el diseño, obtenga el cargador de arranque del canal deseado desde la página Historial de versiones de Visual Studio 2022, cópielo en la carpeta del diseño y realice una actualización normal. A continuación, los clientes deben recibir una notificación adecuada de las actualizaciones para que también puedan mantenerse seguros.

Modificación del contenido de un diseño

Se puede modificar un diseño parcial y agregar más cargas de trabajo, componentes o idiomas. No se pueden quitar componentes de un diseño de forma fiable.

En el siguiente ejemplo agregaremos la carga de trabajo de Azure y un idioma localizado al diseño que se creó anteriormente con únicamente la carga de trabajo de Escritorio administrado y el idioma inglés. Después de realizar la modificación, en este diseño se incluyen las cargas de trabajo tanto de Escritorio administrado como de Azure, así como recursos en inglés y alemán. Además de agregar componentes, el comando --layout también hará que el diseño se actualice a la versión especificada por el programa previo. Así, si usa el programa previo perenne, el diseño resultante tendrá el nuevo componente y el nuevo idioma, y todo el contenido del diseño se actualizará a la versión más reciente en el canal del programa previo.

vs_enterprise.exe --layout c:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --lang de-DE

Si desea modificar un diseño parcial existente para que se convierta en un diseño completo, use la opción --all, como se muestra en el ejemplo siguiente. De nuevo, este comando hará que el contenido del diseño se actualice a la versión especificada por el programa previo.

vs_enterprise.exe --layout c:\VSLayout --all

Para agregar componentes a un diseño, transfiera un archivo *.vsconfig que contenga los componentes adicionales que desee en el diseño. Si lo hace, el nuevo contenido de *.vsconfig sobrescribirá el contenido de layout.vsconfig existente. Para obtener más información, consulte la sección anterior Uso de un archivo de configuración para inicializar el contenido de un diseño.

vs_enterprise.exe --layout C:\VSLayout --config "C:\myupdatedconfig.vsconfig"

Por último, puede editar directamente el archivo de configuración layout.json en la carpeta layout y actualizar la sección "add" de ese archivo para incluir los componentes adicionales que desea incluir en el diseño. Después, deberá actualizar el diseño mediante --layout tal y como hemos descrito anteriormente para descargar los componentes más recientes.

Nota

La manera más fácil de instalar los componentes de diseño recién agregados en un equipo cliente es ejecutar el programa previo en el diseño desde el equipo cliente. La sección "add" del archivo response.json en el diseño determinará qué componentes se seleccionan de forma predeterminada en la interfaz de usuario del instalador del cliente. Si ha modificado el diseño con uno de los métodos anteriores, conviene volver a comprobar manualmente y, posiblemente, adaptar la sección "add" del archivo response.json para que coincida de mejor forma con el contenido de la sección "add" del archivo layout.json recién modificado.

Configure el diseño para quitar los componentes que no tengan soporte técnico en la máquina cliente.

Algunas empresas querrán aprovechar la característica introducida en la versión 17.4 de Visual Studio 2022 que quita los componentes que han pasado a un estado sin soporte técnico. Esta opción es relativamente fácil de configurar si administra un diseño y si los clientes reciben actualizaciones de administrador. En primer lugar, deberá configurar el diseño para que tenga la última versión del instalador, tal y como se ha descrito anteriormente. En segundo lugar, deberá agregar la línea "removeOos": true al archivo response.json. Si se han configurado correctamente estos dos detalles en el diseño, las actualizaciones de administrador posteriores respetarán esta configuración y quitarán los componentes que se queden sin soporte técnico de las máquinas cliente.

Comprobación de un diseño

Use la opción --verify para realizar la comprobación en el diseño de red, que comprueba si faltan archivos del paquete o no son válidos. Al finalizar la comprobación, se imprime la lista de los archivos que faltan y que no son válidos.

La comprobación solo funciona para la versión más reciente de una versión secundaria específica de Visual Studio. En cuanto se publica una nueva versión, la comprobación no funcionará para los diseños que contienen versiones anteriores.

vs_enterprise.exe --layout <layoutDir> --verify

Nota

Algunos archivos de metadatos importantes que necesita la opción --verify deben estar en la carpeta del diseño. Si faltan estos archivos de metadatos, "--verify" no puede ejecutarse y la instalación genera un error. Si experimenta este error, intente actualizar el diseño de nuevo o vuelva a crear un nuevo diseño de red en otra carpeta.

Recuerde que Microsoft envía actualizaciones de Visual Studio periódicamente, por lo que es posible que un diseño más reciente no contenga la misma versión que el diseño inicial si utiliza un archivo de arranque permanente. Sin embargo, si usa un archivo de arranque de vínculo fijo, (casi) siempre obtendrá un conjunto de archivos determinista.

Corrección de un diseño

Use --fix para realizar la misma comprobación que --verify y también intente corregir los problemas identificados. El proceso --fix necesita una conexión a Internet, por lo que asegúrese de que su máquina esté conectada a Internet antes de invocar --fix.

vs_enterprise.exe --layout <layoutDir> --fix

Eliminación de versiones anteriores de un diseño

Después de realizar actualizaciones del diseño en una caché de red, la carpeta del diseño puede tener algunos paquetes obsoletos que ya no son necesarios para la instalación de Visual Studio más reciente. Puede usar la opción --clean para quitar los paquetes obsoletos de una carpeta del diseño de red.

Para hacerlo, necesitará la ruta de acceso de archivo de los manifiestos de catálogo que contenga esos paquetes obsoletos. Puede encontrar los manifiestos del catálogo en la carpeta "Archivo", en la caché del diseño de red. Cuando actualiza un diseño, se guardan ahí. En la carpeta "Archivo", existen una o más carpetas denominadas "GUID", cada una de las cuales contiene un manifiesto de catálogo obsoleto. El número de carpetas "GUID" debe ser el mismo que el número de actualizaciones realizadas en los diseños.

Algunos archivos se guardan dentro de cada carpeta "GUID". Los dos archivos de mayor interés son un archivo "catalog.json" y un archivo "version.txt". El archivo "catalog.json" es el manifiesto de catálogo obsoleto que necesitará pasar a la opción --clean. El otro archivo version.txt contiene la versión de este manifiesto de catálogo obsoleto. Basándose en el número de versión, puede decidir si quiere quitar paquetes obsoletos de este manifiesto de catálogo. Puede hacer lo mismo a medida que recorra las demás carpetas "GUID". Tras decidir los catálogos que quiera limpiar, ejecute el comando --clean proporcionando las rutas de acceso de archivos a estos catálogos.

Este es un ejemplo de cómo usar la opción --clean:

c:\VSLayout\vs_enterprise.exe --layout c:\VSLayout --clean c:\VSLayout\Archive\1cd70189-fc55-4583-8ad8-a2711e928325\Catalog.json --clean c:\VSLayout\Archive\d420889f-6aad-4ba4-99e4-ed7833795a10\Catalog.json

Al ejecutar este comando, el programa de instalación analiza la carpeta del diseño de red para buscar la lista de archivos que quitará. Después, tendrá la oportunidad de revisar los archivos que van a eliminarse y confirmar su eliminación.

Configuración del diseño para incluir y proporcionar siempre el instalador más reciente

Nota

A partir de junio de 2023, se distribuye el instalador más reciente de forma predeterminada con cada actualización a las versiones compatibles de Visual Studio 2017, Visual Studio 2019 y Visual Studio 2022. Por lo tanto, no tendrá que realizar ninguna acción explícita para obtener la última versión del instalador con la funcionalidad y las correcciones de errores más recientes en su diseño y el de sus clientes.

Sin embargo, si usa un diseño creado antes de junio de 2023, también puede configurarlo explícitamente para incluir y proporcionar siempre el instalador más reciente a los clientes, incluso si el instalador se considera parte de una versión más reciente de Visual Studio. Por lo tanto, cuando el cliente actualiza desde este diseño, el cliente adquirirá el instalador más reciente que incluya y proporcione este diseño. La ventaja es que una vez que el instalador más reciente está en el cliente, las instalaciones del cliente podrán aprovechar las correcciones de errores y la nueva funcionalidad que seguimos agregando al instalador.

Hay varias maneras de permitir que el diseño incluya y proporcione el instalador más reciente:

• Puede usar una versión de Visual Studio que se creara a partir de junio de 2023.

• Puede pasar el parámetro --useLatestInstaller al Programa previo al crear o actualizar el diseño. Esto hará que se establezca una configuración en el archivo layout.json, que se puede encontrar en el directorio raíz del diseño. Este es un ejemplo de cómo actualizar el diseño y configurarlo para que use el instalador más reciente y mejor disponible.

  vs_enterprise.exe --layout C:\VSLayout --useLatestInstaller
  

• Puede editar directamente el archivo layout.json para agregar esta configuración.

  {
     "installChannelUri": ".\\ChannelManifest.json",
     "channelUri": "\\\\server\\share\\layoutdirectory\\ChannelManifest.json",
     "installCatalogUri": ".\\Catalog.json",
     "channelId": "VisualStudio.16.Release",
     "productId": "Microsoft.VisualStudio.Product.Enterprise",
  
     "useLatestInstaller": true,
     "removeOos": true
  
  }
  

No hay ninguna manera de quitar esta configuración mediante programación en el archivo layout.json, por lo que si desea que el diseño deje de usar el instalador más reciente que Microsoft pone a disposición y que, en su lugar, use la versión del instalador correspondiente al programa previo (que probablemente sea más antigua que el instalador más reciente), edite el archivo layout.json y quite el valor "UseLatestInstaller": true.

Tenga en cuenta que también puede encontrar este "UseLatestInstaller": true parámetro en el archivo del diseñoresponse.json, pero en esa ubicación se omite para garantizar que el diseño siempre tenga el instalador más reciente. El archivo response.json se usa para establecer opciones de configuración predeterminadas en el cliente cuando el cliente instala o actualiza desde un diseño. Este "useLatestInstaller": true parámetro concreto del archivo layout.json se utiliza para garantizar que el contenido del diseño incluya el instalador más reciente, de modo que los equipos cliente puedan adquirir el instalador más reciente del diseño.

Códigos de error

Si ha usado el parámetro --wait, la variable de entorno %ERRORLEVEL% se establece en uno de los siguientes valores, según el resultado de la operación:

Valor	Resultado
0	Operación completada correctamente
740	Elevación necesaria
1001	El proceso del instalador de Visual Studio está en ejecución
1003	Visual Studio está en uso
1602	Operación cancelada
1618	Otra instalación en ejecución
1641	Operación completada correctamente y reinicio empezado
3010	Operación completada correctamente, pero la instalación requiere reiniciar el equipo para que se pueda usar
5003	Error del programa previo al intentar descargar el instalador
5004	Operación cancelada
5005	Error de análisis de línea de comandos del programa previo
5007	Operación bloqueada: el equipo no cumple los requisitos
8001	Error de comprobación de la máquina de ARM
8002	Error de comprobación previa de descarga en segundo plano
8003	Error seleccionable sin soporte técnico
8004	Error de directorio de destino
8005	Comprobación del error de las cargas de origen
8006	Procesos de Visual Studio en ejecución
8010	No se admite el sistema operativo. Consulte los requisitos del sistema
-1073720687	Error de conectividad
-1073741510	El usuario o un proceso externo ha finalizado el Instalador de Microsoft Visual Studio
Otros (por ejemplo: -1, 1, 1603)	Condición de error: consulte los registros para obtener más información

Obtención de soporte técnico para el diseño de red

Si experimenta un problema con el diseño de red, nos gustaría que nos lo comunicara. La mejor manera para notificarnos un problema es a través de la herramienta Notificar un problema que aparece en el Instalador de Visual Studio y en el IDE de Visual Studio. Si es administrador de TI y no tiene Visual Studio instalado, puede enviar comentarios de administrador de TI aquí. Cuando utilice esta herramienta, sería muy útil que enviara los registros mediante la herramienta Visual Studio Collect, que puede ayudarnos a diagnosticar y solucionar el problema.

También ofrecemos una opción de soporte técnico de chat de instalación para incidencias relacionadas con la instalación (solo en inglés).

Tenemos también otras opciones de soporte técnico disponibles. Consulte nuestra Visual Studio Developer Community.

Contenido relacionado

• Guía del administrador de Visual Studio
• Implementación de Visual Studio desde un diseño en un equipo cliente
• Actualizar una instalación basada en red de Visual Studio
• Solución de problemas de errores relacionados con la red al instalar o usar Visual Studio
• Configuración de directivas para implementaciones empresariales de Visual Studio
• Ciclo de vida y mantenimiento del producto de Visual Studio
• Usar parámetros de la línea de comandos para instalar Visual Studio
• Identificadores de cargas de trabajo y componentes de Visual Studio
• Instalar los certificados necesarios para la instalación sin conexión de Visual Studio