Creación y mantenimiento de una instalación de red de Visual Studio

📣Nos encantaría escuchar sus comentarios.Dedique un momento a completar esta encuesta y háganos saber cómo podemos mejorar la experiencia de diseño. ¡Gracias por su apoyo!

A veces, un administrador de empresa quiere crear una caché de instalación privada (también conocida como "diseño") que contiene archivos de Visual Studio que se pueden implementar en máquinas cliente dentro de una organización.

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

• Un usuario tiene permisos limitados
• Las máquinas cliente tienen acceso limitado a Internet
• Una organización quiere estandarizar en una versión determinada del conjunto de herramientas de desarrollo

Hemos diseñado Visual Studio para que un administrador pueda crear y mantener un diseño y almacenarlo en un recurso compartido de red interno y, opcionalmente, hacer que esté disponible 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 del cliente y las actualizaciones posteriores.

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

• Crear el diseño: describe cómo crear el diseño con el contenido correcto del producto, configurar las opciones predeterminadas, almacenarla en un recurso compartido de archivos 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 solicitar ayuda

Crear el 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 en su empresa (por ejemplo, Visual Studio 2022 Professional y Visual Studio 2022 Enterprise), debe crear un diseño independiente para cada edición. La creación de un diseño independiente para cada edición puede consumir mucho espacio en disco, especialmente cuando se considera que las actualizaciones de diseño también consumen espacio en disco.

La ruta de diseño debe tener menos de 80 caracteres; algunas organizaciones usan con éxito vínculos simbólicos para eludir la limitación de 80 caracteres.

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 creado el diseño, puede usarlo para instalar Visual Studio en cualquier máquina cliente. El programa de inicio es el ejecutable que se usa para crear, actualizar y realizar otras operaciones de diseño. Debe tener permisos de administrador y conexión a Internet para completar este paso.

Los siguientes inicializadores 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 continuamente actualizado y de versión no editable para la versión de mantenimiento del canal que desee del Historial de versiones de Visual Studio 2022. Cópielo en el directorio que desea servir 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
Herramientas de compilación de Visual Studio 2022	vs_buildtools.exe

Sugerencia

Si anteriormente descargaste un archivo bootstrapper y quieres comprobar qué versión instalará, aquí te mostramos cómo. En Windows, abra el Explorador de archivos, haga clic con el botón derecho en el archivo de arranque, elija Propiedades y, después, la pestaña Detalles. El campo Versión del producto describirá el canal y la versión que el archivo de arranque instalará. El número de versión siempre debe leerse como "versión de mantenimiento más reciente de lo que se especifica" y se supone que el canal es Actual a menos que se especifique explícitamente. 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

Debe tener una conexión a Internet para completar 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 ejemplos en los ejemplos de parámetros de la línea de comandos de para una página de instalación de Visual Studio.

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

El enfoque recomendado es crear un diseño inicial de Visual Studio con todas las cargas de trabajo y los idiomas adecuados y almacenar los paquetes en el directorio de diseño en el servidor de red. De este modo, cualquier instalación de cliente tiene acceso a toda la oferta de producto 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 basa 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 el administrador actualiza; si se implementan 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 si los clientes están configurados para recibir actualizaciones de los servidores hospedados de Microsoft, las actualizaciones de seguridad disponibles en el canal 17.0 LTSC están disponibles para los clientes que instalaron o actualizaron 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.

Configurar el contenido de un diseño

Hay 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 es útil si sabe que va a implementar solo un subconjunto de cargas de trabajo en estaciones de trabajo cliente. Entre los parámetros de línea de comandos típicos para personalizar el diseño se incluyen:

• --add para especificar identificadores de carga de trabajo o componente.
  Si se usa --add, solo se descargan las cargas de trabajo y los componentes especificados con --add. Si no se usa --add, se descargan todas las cargas de trabajo y componentes.
• --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 usar un archivo de *.vsconfig para especificar las cargas de trabajo, componentes o extensiones que deben incluirse en el diseño o a las que se debe hacer referencia. 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 componentes necesarios para todas las cargas de trabajo en un solo lenguaje, ejecute:

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

• Para crear un diseño con componentes necesarios para todas las cargas de trabajo en varios lenguajes, 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 lenguajes, 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 lenguajes, 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
  

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

Puede usar el parámetro --config para pasar 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, definiendo 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 el response.json para agregar "allowUnsignedExtensions": true. Consulte ejemplos de contenido 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 usa xcopy. También puede usar robocopy, si lo desea. Ejemplo:

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

Configurar los valores predeterminados de instalación de cliente iniciales para este diseño

Se crea un archivo denominado response.json en la carpeta raíz del diseño. Este archivo personalizable proporciona las opciones predeterminadas iniciales que se configuran 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
• Dónde debe el cliente recibir actualizaciones de
• Si se deben quitar componentes fuera de soporte técnico durante una actualización
• Si las extensiones sin firmar pueden cargarse silenciosamente y mediante programación

Puede encontrar más información en la página Automatizar la instalación de Visual Studio con un archivo de respuesta.

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

A partir de junio de 2023, puede hacer que los diseños estén disponibles en un sitio de intranet interno, lo que le permite aprovechar las funcionalidades de almacenamiento en caché de archivos webserver y georeplicación. Para utilizar esta nueva característica, necesita utilizar los iniciadores más recientes de Visual Studio y el instalador de Visual Studio más reciente. Los administradores de TI deben hacer lo siguiente para aprovechar esta funcionalidad de hospedaje web de intranet:

1. En primer lugar, cree y mantenga un diseño de red y asegúrese de que los datos 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 respeta los siguientes tipos 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, ejecutar 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.

Asegúrese de que la configuración usa el instalador más reciente.

Nota

A partir de junio de 2023, el instalador más reciente se distribuye de forma predeterminada con todas las actualizaciones de todas las versiones compatibles de Visual Studio 2017, Visual Studio 2019 y Visual Studio 2022. Por lo tanto, si usa una de estas versiones de producto, no tendrá que hacer nada explícitamente para obtener la versión más reciente del instalador con la funcionalidad y correcciones de errores más recientes.

Si usa una versión de Visual Studio enviada 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 el diseño de Visual Studio 2019, los clientes de Visual Studio 2019 basados en ese diseño pueden cambiar la ubicación de origen de las actualizaciones o quitar fácilmente componentes fuera de soporte técnico. Se describen más detalles 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 programas previos de Visual Studio 2019 que se compilaron después de la distribución original de Visual Studio 2022. Por lo tanto, el archivo vs_enterprise.exe del ejemplo siguiente debe ser una versión que se lanzó después del 10 de noviembre de 2021.

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

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

Mantenimiento del diseño

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

Si hospeda un diseño en un recurso compartido de archivos de red, puede descargar un diseño actualizado en un recurso compartido local privado (por ejemplo, c:\VSLayoutUpdate) y, después de descargar todo el contenido actualizado, cópielo en el recurso compartido de archivos de red de diseño (por ejemplo, \server\products\VS). Si no lo hace, es posible que los usuarios que ejecuten el programa de instalación mientras actualiza el diseño encuentren una discrepancia en el contenido del diseño porque aún no se ha actualizado por completo.

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. Se recomienda 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 segura más reciente 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 normalmente publica actualizaciones de seguridad en el segundo martes del mes, conocido como "patch tuesday", por lo que una buena estrategia sería actualizar todos los diseños en las tardes del martes de revisión.

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 es necesario volver a especificar qué componentes del producto desea en el diseño. Una actualización de diseño simplemente actualiza los componentes existentes en el diseño 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

Actualizar este diseño a la versión más reciente del producto ofrecido por Microsoft y hospedado en servidores de Microsoft es fácil. 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 actualizada de forma desatendida. La operación de diseño ejecuta el proceso de instalación en una nueva ventana de consola. La ventana se deja abierta para que los administradores puedan ver el resultado de la actualización final del diseño y un resumen de los errores que podrían haberse producido. Si desea realizar una operación de actualización de diseño de forma desatendida (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

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

A veces, puede que desee actualizar el diseño a una versión particular del producto. Por ejemplo, puede que desee que el diseño coincida con la versión segura más reciente de la línea de base de mantenimiento en la que ha estandarizado su organización. A continuación 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 la misma sintaxis exacta que antes.

Puede usar una actualización de administrador de 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 update.exe en el equipo que alberga el diseño, abra una terminal con privilegios elevados en ese equipo y ejecute un comando similar al siguiente:

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

Tenga en cuenta que una 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.

Asegurarse de que el diseño de red se basa en una versión compatible

En ocasiones, a medida que los canales pasan fuera de 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 17.0 LTSC deja de ser compatible en julio de 2023, no se liberarán más actualizaciones de seguridad y el diseño y los clientes se volverán inseguros. Las fechas de soporte técnico se pueden encontrar aquí para varios canales de Visual Studio 2022.

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 notificaciones apropiadas de una actualización para que también puedan mantenerse seguros.

Modificar el contenido de un diseño

Es posible modificar un diseño parcial y agregar cargas de trabajo, componentes o lenguajes adicionales. No es posible quitar componentes de forma confiable de un diseño.

En el ejemplo siguiente, agregaremos la carga de trabajo de Azure y un idioma localizado al diseño que se creó anteriormente con solo la carga de trabajo escritorio administrado y el idioma inglés. Después de realizar la modificación, tanto el escritorio administrado como las cargas de trabajo de Azure, y los recursos inglés y alemán se incluirán en este diseño. Además de agregar componentes, el comando --layout también hará que el diseño se actualice a la versión especificada por el instalador. 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

Puede agregar componentes a un diseño pasando 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 de layout.json en la carpeta de diseño y actualizar la sección "agregar" de este archivo para incluir los componentes adicionales que desea incluir en el diseño. A continuación, deberá actualizar el diseño mediante --layout como se ha 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, es posible que desee volver a comprobar manualmente y, posiblemente, ajustar la sección "add" en el archivo response.json para que coincida con el contenido de la sección "add" del archivo layout.json recién modificado.

Configura el diseño para quitar componentes que ya no son compatibles en el equipo 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 fuera de soporte técnico. Esto es relativamente fácil de configurar si estás gestionando un diseño y si tus clientes están recibiendo 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 el diseño tiene estos dos detalles configurados correctamente, las actualizaciones posteriores del administrador respetarán esta configuración y quitarán los componentes fuera de soporte técnico de las máquinas cliente.

Comprobación de un diseño

Use --verify para verificar el diseño de red y comprobar si los paquetes faltan o son inválidos. Al final de la comprobación, imprime la lista de archivos que faltan y 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 publique 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 layout. Si faltan estos archivos de metadatos, "--verify" no se puede ejecutar y el programa de instalación le proporciona un error. Si experimenta este error, intente actualizar de nuevo el diseño o vuelva a crear un nuevo diseño de red en otra carpeta.

Recuerde que Microsoft envía actualizaciones de Visual Studio de manera periódica, por lo que, si utiliza un instalador permanente, es posible que una distribución más reciente no contenga la misma versión que la distribución inicial. 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 e intente corregir los problemas identificados. El proceso de --fix necesita una conexión a Internet, así que asegúrese de que la máquina está conectada a Internet antes de invocar --fix.

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

Quitar versiones anteriores de un diseño

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

Para ello, necesitará las rutas de archivos de los manifiestos de catálogo que contienen esos paquetes obsoletos. Puede encontrar los manifiestos del catálogo en la carpeta "Archivo", en la caché del diseño de red. Se guardan allí cuando actualizas un diseño. En la carpeta "Archive", hay una o varias carpetas con nombre "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. En función del número de versión, puede decidir si desea quitar paquetes obsoletos de este manifiesto de catálogo. Puede hacer lo mismo a medida que recorre las otras carpetas "GUID". Después de tomar la decisión sobre los catálogos que desea limpiar, ejecute el comando --clean proporcionando las rutas de acceso de los 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 de diseño de red para buscar la lista de archivos que quitará. Después, tendrá la oportunidad de revisar los archivos que se van a eliminar y confirmar las eliminaciones.

Configurar la disposición para incluir y proporcionar siempre el instalador más reciente.

Nota

A partir de junio de 2023, el instalador más reciente se envía 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 se actualice desde esta configuración, adquirirá el instalador más reciente que está incluido y proporcionado por dicha configuración. La ventaja es que una vez que el instalador más reciente está en el cliente, las instalaciones de cliente podrán aprovechar las correcciones de errores y las nuevas funcionalidades 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 construida en o después 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 usar el instalador más reciente y más grande disponible.

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

• Puede editar el archivo layout.json directamente 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 de cuando el cliente instala o actualiza desde un diseño. Este valor concreto de "useLatestInstaller": true en el archivo layout.json se utiliza para garantizar que el contenido del diseño contenga el instalador más reciente, de modo que las máquinas cliente puedan adquirirlo desde ese diseño.

Códigos de error

Si usó el parámetro --wait, en función del resultado de la operación, la variable de entorno %ERRORLEVEL% se establece en uno de los valores siguientes:

Valor	Resultado
0	Operación completada correctamente
740	Elevación necesaria
1001	El proceso del instalador de Visual Studio se está ejecutando
1003	Visual Studio está en uso
1602	Se canceló la operación
1618	Otra instalación en ejecución
1641	La operación se completó correctamente y se inició el reinicio
3010	La operación se completó correctamente, pero la instalación requiere reiniciar antes de que se pueda usar.
5003	El iniciador no pudo descargar el instalador
5004	Se canceló la operación
5005	Error de análisis de la línea de comandos del Bootstrapper
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	Fallo al verificar 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	Microsoft Visual Studio Installer fue terminado (por el usuario o un proceso externo)
Otro (por ejemplo: -1, 1, 1603)	Condición de fallo ocurrida - compruebe los registros para obtener más información.

Obtener soporte técnico para el diseño de red

Si experimenta un problema con el diseño de red, queremos saberlo. La mejor manera de indicarnos es usar 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í. Al usar esta herramienta, sería muy útil si pudiera enviar los registros mediante la herramienta Visual Studio Collect, lo que puede ayudarnos a diagnosticar y corregir el problema.

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

También tenemos otras opciones de soporte técnico disponibles. Consulte la página Visual Studio Developer Community.

Contenido relacionado

• guía del administrador de Visual Studio
• Implementar Visual Studio desde un diseño en una máquina cliente
• Actualizar una instalación basada en red de Visual Studio
• Solución de errores relacionados con la red al instalar o usar Visual Studio
• Configurar directivas para implementaciones empresariales de Visual Studio
• ciclo de vida y mantenimiento del producto de Visual Studio
• Usar parámetros de línea de comandos para instalar Visual Studio
• Identificadores de cargas de trabajo y componentes de Visual Studio
• Instalación de certificados necesarios para la instalación sin conexión de Visual Studio