Configuración de los valores predeterminados de instalación mediante un archivo de respuesta

En este artículo, aprenderá a crear un archivo de respuesta que le ayude a automatizar la instalación de Visual Studio. El uso más común es cuando se instala Visual Studio desde un diseño.

El archivo de respuesta de Visual Studio es un archivo de JSON cuyo contenido contiene personalizaciones usadas durante la instalación inicial de Visual Studio en el cliente. Su contenido refleja los argumentos y parámetros de la línea de comandos . Use el archivo de respuesta para las siguientes opciones de configuración:

• Configurar qué cargas de trabajo, componentes o idiomas deben seleccionarse de forma predeterminada durante la instalación inicial.
• Haga referencia a un archivo de configuración de instalación *.vsconfig que su equipo ha estandarizado.
• Especifique donde el cliente debe recibir actualizaciones de. Algunos ejemplos son los servidores predeterminados de Microsoft hospedados en Internet o desde una ubicación de la red controlada por el administrador.
• Eliminación automática de componentes que están fuera de soporte técnico durante las actualizaciones.

Creación del archivo de respuesta

El archivo response.json se crea normalmente cuando un administrador crea un de diseño y se puede encontrar en la carpeta raíz del diseño. Sin embargo, puede crear su propio archivo de respuesta mediante uno de los ejemplos siguientes.

Especificación del archivo de respuesta

Si un administrador implementa Visual Studio invocando el instalador desde una distribución, se usa automáticamente el archivo de respuesta que se encuentra en el directorio raíz de la distribución. Los administradores también pueden elegir especificar explícitamente un archivo de respuesta diferente mediante el parámetro --in, como en el ejemplo siguiente:

\\server\share\layoutdirectory\vs_enterprise.exe --in custom_response_file.json

Contenido del archivo de respuesta

El archivo de respuesta encapsula los parámetros de línea de comandos usados por el Instalador de Visual Studio y sigue estas reglas generales:

• Si un parámetro de línea de comandos no toma argumentos (por ejemplo, --quiet, --passive, includeRecommended, removeOos, useLatestInstaller, allowUnsignedExtensions, etc.), el valor del archivo de respuesta debe ser true/false.
• Si el parámetro toma un argumento (por ejemplo, --installPath <dir>, --config <*.vsconfig file>), el valor del archivo de respuesta debe ser una cadena.
• Si el parámetro toma un argumento y puede aparecer en la línea de comandos más de una vez (por ejemplo, --add <id>), el valor del archivo de respuesta debe ser una matriz de cadenas.

Los parámetros especificados en la línea de comandos invalidan la configuración que se incluye en el archivo de respuesta, excepto cuando los parámetros toman varias entradas (por ejemplo, --add). Cuando tiene varias entradas, las entradas proporcionadas en la línea de comandos se combinan con la configuración del archivo de respuesta.

Configuración del archivo de respuesta usado al realizar la instalación desde un diseño

Si crea un diseño mediante el comando --layout, se crea un archivo response.json predeterminado en la raíz de la carpeta layout. Se espera que los administradores modifiquen y personalicen el archivo de respuesta correctamente antes de instalar en un equipo cliente. De este modo, pueden controlar las opciones de configuración iniciales del cliente.

Solo se hace referencia a los valores de configuración del archivo response.json al ejecutar un cargador de arranque (por ejemplo, vs_enterprise.exe). Los bootstrappers se suelen usar para realizar la instalación inicial en un cliente, pero a veces también pueden usarse para actualizar un cliente. El response.json nunca se usa al iniciar el instalador localmente en el cliente.

Si el administrador creó un diseño parcial, el archivo de response.json predeterminado en el diseño especifica solo las cargas de trabajo y los idiomas que se incluyeron en el diseño parcial.

Si el diseño se crea pasando un archivo de --config *.vsconfig, el archivo *.vsconfig se copia en el directorio de diseño como layout.vsconfig y se hace referencia a este archivo de configuración en el archivo response.json. De este modo, puede usar archivos de configuración para inicializar las instalaciones de cliente que proceden de un diseño.

Asegúrese de prestar especial atención al parámetro channelUri, que configura el lugar en el que buscará el cliente las actualizaciones. La configuración predeterminada es para que el cliente examine los servidores hospedados por Microsoft en Internet para obtener actualizaciones. Tendrá que cambiar el valor de channelUri para que dirija al diseño si quiere que los clientes obtengan sus actualizaciones del diseño. A continuación se detallan ejemplos de cómo hacerlo. Siempre puede cambiar el lugar donde busca un cliente las actualizaciones. Para ello, ejecute el instalador en el cliente e invoque el comando modifySettings.

Si la instalación original no se realiza mediante el modo --quiet o --passive, los usuarios podrán invalidar los valores predeterminados especificados en response.json y seleccionar o anular la selección de cargas de trabajo y componentes adicionales que se van a instalar.

Advertencia

Tenga mucho cuidado al editar las propiedades de la response.json definidas cuando se creó el diseño, ya que algunos de los elementos son necesarios para la instalación.

El archivo base response.json en un diseño debe ser similar al ejemplo siguiente, excepto que el ID de producto reflejará la edición en tu diseño.

{
  "installChannelUri": ".\\ChannelManifest.json",
  "channelUri": "https://aka.ms/vs/17/release/channel",
  "installCatalogUri": ".\\Catalog.json",
  "channelId": "VisualStudio.17.Release",
  "productId": "Microsoft.VisualStudio.Product.Enterprise"
}

{
  "installChannelUri": ".\\ChannelManifest.json",
  "channelUri": "https://aka.ms/vs/17/release.ltsc.17.0/channel",
  "installCatalogUri": ".\\Catalog.json",
  "channelId": "VisualStudio.17.Release.LTSC.17.0",
  "productId": "Microsoft.VisualStudio.Product.Enterprise"
}

Al crear o actualizar un diseño, también se crea un archivo response.template.json. Este archivo contiene todos los identificadores de carga de trabajo, componente e idioma que se pueden usar. Este archivo se proporciona como plantilla para lo que se podría incluir en una instalación personalizada. Los administradores pueden usar este archivo como punto de partida para un archivo de respuesta personalizado. Simplemente elimine los identificadores de los elementos que no desea instalar y guárdelos en el archivo response.json o en su propio documento de respuesta. No personalice el archivo response.template.json o los cambios se pierdan cada vez que se actualice el diseño.

Ejemplo de contenido de diseño personalizado de archivo de respuesta

En el ejemplo de archivo response.json siguiente se inicializa una instalación de cliente de Visual Studio Enterprise para seleccionar varias cargas de trabajo y componentes comunes, para seleccionar los idiomas de la interfaz de usuario en inglés y francés y para que la ubicación de actualización esté configurada para buscar orígenes en un diseño hospedado en red. Consulte Configuración de directivas para implementaciones empresariales de Visual Studio y Configuración del diseño para incluir y proporcionar siempre el instalador más reciente para obtener información sobre cómo configurarlo.

{
  "installChannelUri": ".\\ChannelManifest.json",
  "channelUri": "\\\\server\\share\\layoutdirectory\\ChannelManifest.json",
  "installCatalogUri": ".\\Catalog.json",
  "channelId": "VisualStudio.17.Release",
  "productId": "Microsoft.VisualStudio.Product.Enterprise",

  "installPath": "C:\\VS2022",
  "quiet": false,
  "passive": false,
  "includeRecommended": true,
  "norestart": false,
  "useLatestInstaller": true,
  "removeOos": true,

  "addProductLang": [
    "en-US",
    "fr-FR"
    ],

    "add": [
        "Microsoft.VisualStudio.Workload.ManagedDesktop",
        "Microsoft.VisualStudio.Workload.Data",
        "Microsoft.VisualStudio.Workload.NativeDesktop",
        "Microsoft.VisualStudio.Workload.NetWeb",
        "Microsoft.VisualStudio.Workload.Office",
        "Microsoft.VisualStudio.Workload.Universal",
        "Component.GitHub.VisualStudio"
    ]
}

En el ejemplo siguiente, el archivo response.json inicializa una instalación de cliente de Visual Studio Enterprise que:

• Usa un archivo *.vsconfig de configuración que define las cargas de trabajo, los componentes y las extensiones para instalar
• Selecciona los idiomas de la interfaz de usuario inglés y francés.
• Configura la ubicación de actualización para buscar fuentes en un entorno hospedado en HTTP
• Permite la carga programática de extensiones sin firmar
• Quita los componentes que han pasado a un estado sin soporte en el momento de actualizar el cliente. Consulte la lista de componentes fuera de soporte técnico aquí.

{
  "installChannelUri": ".\\ChannelManifest.json",
  "channelUri": "http://MyCompanyIntranetSite/VS2022Enterprise/ChannelManifest.json",
  "installCatalogUri": ".\\Catalog.json",
  "channelId": "VisualStudio.17.Release",
  "productId": "Microsoft.VisualStudio.Product.Enterprise",
  "arch": "x64",
  "config": ".\\Layout.vsconfig"
  "installPath": "C:\\VS2022",
  "quiet": false,
  "passive": false,
  "includeRecommended": true,
  "norestart": false,
  "useLatestInstaller": true,
  "removeOos": true,
  "allowUnsignedExtensions": true,

  "addProductLang": [
    "en-US",
    "fr-FR"
    ]

}

Advertencia

Si usa diseños web hospedados en intranet, no puede establecer "noWeb": true en el response.json y esperar que funcione. Esto deshabilitará el protocolo HTTP e impedirá que el cliente acceda al sitio web.

Solución de problemas

Si tiene un problema con el instalador de Visual Studio que produce un error al emparejarlo con un archivo response.json, consulte la página Solución de errores relacionados con la red al instalar o usar Visual Studio para obtener más información.

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:

• Utiliza la opción de soporte técnico del chat de instalación , (en inglés solamente) 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.

Contenido relacionado

• Guía de administradores de Visual Studio
• Crear y mantener una instalación de red de Visual Studio
• Implementar Visual Studio desde un diseño en una máquina cliente
• Configurar directivas para implementaciones empresariales
• Identificadores de cargas de trabajo y componentes de Visual Studio
• Solución de errores relacionados con la red al instalar o usar Visual Studio