Definir configurações padrão de instalação usando um arquivo de resposta

2025-08-07

Neste artigo, você aprenderá a criar um arquivo de resposta que ajuda a automatizar a instalação do Visual Studio. O uso mais comum é quando você instala o Visual Studio de um layout .

O arquivo de resposta do Visual Studio é um arquivo de JSON cujo conteúdo contém personalizações usadas durante a instalação inicial do Visual Studio no cliente. Seu conteúdo espelha os argumentos e parâmetros da linha de comando . Use o arquivo de resposta para as seguintes opções de configuração:

Configurar quais cargas de trabalho, componentes ou idiomas devem ser selecionados por padrão durante a instalação inicial.
Faça referência a um arquivo de configuração de instalação *.vsconfig que sua equipe padronizou.
Especifique onde o cliente deve receber atualizações de. Os exemplos incluem os servidores padrão hospedados pela Microsoft na Internet ou em um local de rede controlada pelo administrador.
Remoção automática de componentes sem suporte durante as atualizações.

Criando o arquivo de resposta

O arquivo response.json normalmente é criado quando um administrador cria um layout e pode ser encontrado na pasta raiz do layout. No entanto, você pode criar seu próprio arquivo de resposta usando um dos exemplos a seguir.

Especificando o arquivo de resposta

Se um administrador implantar o Visual Studio invocando o bootstrapper de um layout, o arquivo de resposta encontrado no diretório raiz do layout será usado automaticamente. Os administradores também podem optar por especificar explicitamente um arquivo de resposta diferente usando o parâmetro --in, como no exemplo a seguir:

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

Conteúdo do arquivo de resposta

O arquivo de resposta encapsula os parâmetros de linha de comando usados pelo Instalador do Visual Studio e segue estas regras gerais:

Se um parâmetro de linha de comando não tiver argumentos (por exemplo, --quiet, --passive, includeRecommended, removeOos, useLatestInstaller, allowUnsignedExtensionsetc.), o valor no arquivo de resposta deverá ser true/false.
Se o parâmetro usa um argumento (por exemplo, --installPath <dir>, --config <*.vsconfig file>), o valor no arquivo de resposta deve ser uma cadeia de caracteres.
Se o parâmetro usa um argumento e pode aparecer na linha de comando mais de uma vez (por exemplo, --add <id>), o valor no arquivo de resposta deve ser uma matriz de cadeias de caracteres.

Os parâmetros especificados na linha de comando substituem as configurações incluídas no arquivo de resposta, exceto quando os parâmetros recebem várias entradas (por exemplo, --add). Quando você tem várias entradas, as entradas fornecidas na linha de comando são mescladas com as configurações do arquivo de resposta.

Configurar o arquivo de resposta usado para instalar a partir de um layout

Se você criar um layout usando o comando --layout, um arquivo de response.json padrão será criado na raiz da pasta de layout. Espera-se que os administradores modifiquem e personalizem o arquivo de resposta adequadamente antes de instalar em um computador cliente. Dessa forma, eles podem controlar as configurações iniciais do cliente.

As configurações no arquivo response.json são referenciadas somente ao executar um carregador de inicialização (por exemplo, vs_enterprise.exe). Normalmente, os bootstrappers são usados para executar a instalação inicial no cliente, mas às vezes eles também são usados para atualizar um cliente. O response.json nunca é usado quando você inicia o instalador localmente no cliente.

Se o administrador criou um layout parcial, o arquivo de response.json padrão no layout especifica apenas as cargas de trabalho e os idiomas incluídos no layout parcial.

Se o layout for criado passando um arquivo --config *.vsconfig, o arquivo *.vsconfig será copiado para o diretório de layout como layout.vsconfig e esse arquivo de configuração será referenciado no arquivo response.json. Dessa forma, você pode usar arquivos de configuração para inicializar as instalações do cliente provenientes de um layout.

Preste atenção especial à configuração channelUri, que configura onde o cliente procura atualizações. A configuração padrão é que o cliente examine os servidores hospedados pela Microsoft na Internet para obter atualizações. Você precisa alterar o valor de channelUri e apontá-lo para o layout se quiser que os clientes obtenham atualizações do layout. Exemplos de como fazer isso estão detalhados abaixo. Você sempre pode alterar onde um cliente procura atualizações no futuro executando o instalador no cliente e invocando o comando modifySettings.

Se a instalação do cliente não for feita usando o modo --quiet ou --passive, os usuários poderão substituir os padrões especificados no response.json e selecionar ou desmarcar cargas de trabalho e componentes adicionais para instalar.

Aviso

Tenha muito cuidado ao editar propriedades no response.json definido quando o layout foi criado, pois alguns dos itens são necessários para instalação.

O arquivo response.json base em um layout deve ser semelhante ao exemplo a seguir, exceto pelo fato de que a productID refletiria a edição em seu layout.

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

{
  "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"
}

Quando você cria ou atualiza um layout, um arquivo response.template.json também é criado. Esse arquivo contém todas as IDs de carga de trabalho, componente e idioma que podem ser usadas. Esse arquivo é fornecido como um modelo para o que tudo pode ser incluído em uma instalação personalizada. Os administradores podem usar esse arquivo como ponto de partida para um arquivo de resposta personalizado. Basta remover as IDs para as coisas que você não deseja instalar e salvá-la no arquivo response.json ou em seu próprio arquivo de resposta. Não personalize o arquivo response.template.json ou suas alterações serão perdidas sempre que o layout for atualizado.

Exemplo de conteúdo de arquivo de resposta de layout de exemplo

O exemplo de arquivo response.json a seguir inicializa uma instalação de cliente do Visual Studio Enterprise para selecionar várias cargas de trabalho e componentes comuns, selecionar os idiomas de interface do usuário inglês e francês e ter o local de atualização configurado para procurar fontes em um layout hospedado de rede. Para o Visual Studio 2019, o local de atualização (channelUri) só pode ser configurado durante a instalação inicial e não pode ser alterado posteriormente , a menos que você use a funcionalidade no instalador mais recente. Confira Configurar políticas para implantações corporativas do Visual Studio e Configurar o layout para sempre incluir e fornecer o instalador mais recente para obter informações sobre como configurá-lo.

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

  "installPath": "C:\\VS2019",
  "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"
    ]
}

O exemplo de arquivo response.json a seguir inicializa uma instalação de cliente do Visual Studio Enterprise para selecionar várias cargas de trabalho e componentes comuns, selecionar os idiomas de interface do usuário inglês e francês e ter o local de atualização configurado para procurar fontes em um layout hospedado de rede. Confira Configurar políticas para implantações corporativas do Visual Studio e Configurar o layout para sempre incluir e fornecer o instalador mais recente para obter informações sobre como configurá-lo.

{
  "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"
    ]
}

No exemplo a seguir, o arquivo response.json inicializa uma instalação de cliente do Visual Studio Enterprise que:

Usa um arquivo de configuração *.vsconfig que define quais cargas de trabalho, componentes e extensões instalar
Seleciona os idiomas inglês e francês da interface do usuário
Configura o local de atualização para buscar fontes em um layout hospedado via http
Permite o carregamento programático de extensões não atribuídas
Remove os componentes que foram movidos para um estado sem suporte durante a atualização do cliente. Veja a lista de componentes sem suporte aqui.

{
  "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"
    ]

}

Aviso

Se você estiver usando layouts hospedados na Web da intranet, a definição de “noWeb”: true no response.json não funcionará. Isso desabilitará o protocolo http e impedirá que o cliente acesse o site.

Solução de problemas

Se você encontrar um problema com o bootstrapper do Visual Studio gerando um erro ao emparelhá-lo com um arquivo response.json, consulte a página Solucionar problemas de erros relacionados à rede ao instalar ou usar o Visual Studio para obter mais informações.

Suporte ou solução de problemas

Às vezes, as coisas podem dar errado. Se a instalação do Visual Studio falhar, consulte Solucionar problemas de instalação e atualização do Visual Studio para obter diretrizes passo a passo.

Aqui estão mais algumas opções de suporte:

Use a opção de suporte de chat de instalação (somente em inglês) para problemas relacionados à instalação.
Relate problemas do produto para nós por meio da ferramenta Relatar um Problema, exibida no Visual Studio Installer e no IDE do Visual Studio. Se você for um Administrador de TI e não tiver o Visual Studio instalado, poderá enviar comentários do Administrador de TI.
Sugira um recurso, acompanhe os problemas do produto e encontre respostas no da Comunidade de Desenvolvedores do Visual Studio.

Comentários

Esta página foi útil?