Настройка параметров установки по умолчанию с помощью файла ответа

  • Статья

В этой статье вы узнаете, как создать файл ответа, который помогает автоматизировать установку Visual Studio. Это чаще всего используется при установке Visual Studio из макета.

Файл ответа Visual Studio — это JSON-файл , содержимое которого содержит настройки, используемые во время первоначальной установки Visual Studio на клиент. Его содержимое зеркало аргументы и параметры командной строки. Используйте файл ответа для следующих параметров конфигурации:

Создание файла ответа

Файл response.json обычно создается, когда администратор создает макет и может находиться в корневой папке макета. Однако вы можете создать собственный файл ответа, используя один из приведенных ниже примеров.

Указание файла ответа

Если администратор развертывает Visual Studio путем вызова загрузчика из макета, файл ответа, найденный в корневом каталоге макета, будет автоматически использоваться. Администратор istrator также может явно указать другой файл ответа с помощью --in параметра, как показано в следующем примере:

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

Содержимое файла ответов

Файл ответа инкапсулирует параметры командной строки, используемые установщиком Visual Studio, и он следует следующим общим правилам:

  • Если параметр командной строки не принимает аргументы (например, --quiet, allowUnsignedExtensions--passiveincludeRecommendedremoveOosuseLatestInstallerи т. д.), значение в файле ответа должно иметь значение true/false.
  • Если параметр принимает аргумент (например, --installPath <dir>, ), --config <*.vsconfig file>то значение в файле ответа должно быть строкой.
  • Если параметр принимает аргумент и может встречаться в командной строке несколько раз (например, --add <id>), значение файла ответов должно содержать массив строк.

Указанные в командной строке параметры переопределяют значения, включенные в файл ответов, за исключением тех параметров, которые принимают несколько входных значений (например, --add). Для таких параметров все значения, переданные в командной строке, объединяются со значениями из файла ответов.

Настройка файла ответа, используемого при установке из макета

Если вы создали макет с помощью --layout команды, файл по умолчанию response.json будет создан в корне папки макета. Администратор istrator, как ожидается, будут изменять и настраивать файл ответа соответствующим образом перед установкой на клиентском компьютере. Таким образом, они могут управлять начальными параметрами конфигурации клиента.

Параметры конфигурации в response.json файле ссылаются только при выполнении загрузчика (например, vs_enterprise.exe). Начальная загрузка обычно используется для выполнения начальной установки на клиенте, но иногда они используются для обновления клиента. Этот response.json параметр никогда не используется при локальном запуске установщика на клиенте.

Если администратор создал частичный макет, то файл по умолчанию response.json в макете будет указывать только рабочие нагрузки и языки, включенные в частичный макет.

Если макет создается путем передачи --config *.vsconfig файла, *.vsconfig файл будет скопирован в каталог макета, как layout.vsconfig и этот файл конфигурации будет ссылаться в response.json файле. Таким образом, можно использовать файлы конфигурации для инициализации установок клиента, поступающих из макета.

Обязательно обратите особое внимание на параметр channelUri, который настраивает , где клиент будет искать обновления. Конфигурация по умолчанию для клиента используется для просмотра размещенных в Майкрософт серверов в Интернете для обновления. Необходимо изменить значение channelUri и указать его макету, если вы хотите, чтобы клиенты получили свои обновления из макета. Примеры выполнения этого действия подробно описаны ниже. Вы всегда можете изменить, где клиент ищет обновления в будущем, выполнив установщик на клиенте и вызвав modifySettings команду.

Если установка клиента не выполняется или --passive не используется--quiet, пользователи могут переопределить значения по умолчанию, указанные в response.json и далее выбрать или отменить выбор дополнительных рабочих нагрузок и компонентов для установки.

Предупреждение

Будьте очень осторожны при редактировании свойств в response.json определенном месте при создании макета, так как некоторые элементы необходимы для установки.

Базовый response.json файл в макете должен выглядеть примерно так, как в следующем примере, за исключением того, что идентификатор продукта будет отражать выпуск в макете.

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

При создании или обновлении макета также создается файл response.template.json. Этот файл содержит все идентификаторы всех рабочих нагрузок, компонентов и языков, которые могут использоваться. Этот файл предоставляется в виде шаблона для всего содержимого, которое может быть включено в настраиваемую установку. Администраторы могут использовать этот файл в качестве отправной точки для пользовательского файла ответов. Просто удалите идентификаторы тех компонентов, которые не нужно устанавливать, и сохраните их в файле response.json или собственном файле ответов. Не настраивайте файл response.template.json файла, или изменения будут потеряны при каждом обновлении макета.

Пример пользовательского содержимого файла ответов макета

response.json Следующий пример файла инициализирует установку клиента Visual Studio 2019 Enterprise для выбора нескольких общих рабочих нагрузок и компонентов, чтобы выбрать языки английского и французского пользовательского интерфейса, а также указать расположение обновления, настроенное для поиска источников в сетевом макете. Обратите внимание, что для Visual Studio 2019 расположение обновления (channelUri) может быть настроено только во время начальной установки и не может быть изменено после того, как вы не используете функциональные возможности в последнем установщике. Ознакомьтесь с политиками настройки корпоративных развертываний Visual Studio и настройка макета, чтобы всегда включать и предоставлять последний установщик для получения сведений о настройке этого.

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

В следующем примере response.json файл инициализирует установку клиента Visual Studio 2022 Enterprise:

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

}

Предупреждение

Если вы используете макеты веб-размещения в интрасети, вы не можете задать "noWeb": true в response.json и ожидать его работы. Это отключит http-протокол и предотвратит доступ клиента к веб-сайту.

Устранение неполадок

Если возникнет проблема с начальным загрузчиком Visual Studio, вызывающим ошибку при связывании с файлом response.json, ознакомьтесь со статьей Исправление ошибок сети при установке или использовании Visual Studio.

Поддержка или устранение неполадок

Иногда возникают проблемы. Если установить Visual Studio не удается, воспользуйтесь пошаговыми указаниями в статье Устранение неполадок при установке и обновлении Visual Studio.

Ниже приведены несколько дополнительных вариантов:

Связанный контент