Примеры параметров командной строки для установки Visual Studio 2017

Чтобы проиллюстрировать использование параметров командной строки для установки Visual Studio на практике, здесь приводится несколько примеров, которые вы можете настроить в соответствии с требуемыми задачами.

В каждом примере vs_enterprise.exeи vs_professional.exevs_community.exe представляет соответствующий выпуск начального загрузчика Visual Studio, который является небольшим (~ 1 МБ), который инициирует процесс скачивания. Если вы используете другой выпуск, замените соответствующее имя начального загрузчика.

Для всех команд требуется повышение прав администратора, и отобразится строка управления учетными записями пользователей, если процесс не запущен из командной строки с повышенными привилегиями.

Чтобы объединить несколько строк в одну команду, используйте символ ^ в конце командной строки. Кроме того, эти строки можно поместить в одну строку. В PowerShell вместо этого используется символ обратного апострофа (`).

Список рабочих нагрузок и компонентов, которые можно установить с помощью командной строки, см. в статье Идентификаторы рабочих нагрузок и компонентов Visual Studio 2017.

Установка с помощью --installPath и --add вместе с загрузчиком

• Установите минимальный экземпляр Visual Studio без интерактивных запросов, но отображается ход выполнения:

  vs_enterprise.exe --installPath C:\minVS ^
  --add Microsoft.VisualStudio.Workload.CoreEditor ^
  --passive --norestart
  

• Выполните автоматическую установку экземпляра Visual Studio для настольных ПК с французским языковым пакетом. Управление должно возвращаться только после завершения установки продукта.

  vs_enterprise.exe --installPath C:\desktopVS ^
  --addProductLang fr-FR ^
  --add Microsoft.VisualStudio.Workload.ManagedDesktop ^
  --includeRecommended --quiet --wait
  

Обновить

• Обновление экземпляра Visual Studio с помощью командной строки с отображением хода выполнения и отсутствием интерактивных запросов. Эти команды можно выполнить в двух шагах с помощью загрузчика, найденного на клиенте или в макете. Первая команда обновляет установщик на клиенте, а вторая команда обновляет продукт Visual Studio. Эти команды необходимо выполнить в командной строке с повышенными привилегиями, так как для обновления установщика требуются разрешения администратора. В следующем примере выполняется имитация обновления клиента с помощью постоянного загрузчика в макете.

  \\layoutserver\share\path\vs_enterprise.exe --update --quiet --wait
  \\layoutserver\share\path\vs_enterprise.exe update --wait --passive --norestart --installPath "C:\installPathVS"
  

Кроме того, можно обновить экземпляр Visual Studio на одном шаге с помощью установщика на клиенте. Стандартные пользователи, если им предоставлены соответствующие разрешения, могут программно выполнить команду обновления с помощью установщика, но они не могут использовать --passive или --quiet переключиться. Обратите внимание, что вы не можете программно инициировать установщик из того же каталога, в котором находится установщик.

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" update --passive --norestart --installPath "C:\installPathVS"

Использование параметра --wait

• Используйте --wait в пакетных файлах или сценариях ожидание завершения начальной команды перед выполнением следующей команды. Для пакетных файлов %ERRORLEVEL% переменная среды содержит возвращаемое значение команды, как описано в параметрах командной строки Use для установки страницы Visual Studio . Для некоторых служебных программ команд требуются другие параметры для ожидания завершения и получения возвращаемого значения установщика.

Параметр --wait поддерживается только загрузчиком.

start /wait vs_professional.exe --installPath "C:\VS" --passive --wait > nul
echo %errorlevel%

Следующая команда — это пример использования --wait с командой Start-Processскрипта PowerShell:

$process = Start-Process -FilePath vs_enterprise.exe -ArgumentList "--installPath", "C:\VS", "--passive", "--wait" -Wait -PassThru
Write-Output $process.ExitCode 

or

 $startInfo = New-Object System.Diagnostics.ProcessStartInfo
 $startInfo.FileName = "vs_enterprise.exe"
 $startInfo.Arguments = "--all --quiet --wait"
 $process = New-Object System.Diagnostics.Process
 $process.StartInfo = $startInfo
 $process.Start()
 $process.WaitForExit()

• Первый --wait используется загрузчиком Visual Studio, а второй -Wait используется start-Process для ожидания завершения. Этот -PassThru параметр используется Start-Process для использования кода выхода установщика для возвращаемого значения.

Использование параметра --layout для создания сетевого макета или локального кэша

• Создайте макет, включающий только редактор ядра Visual Studio (самую минимальную конфигурацию Visual Studio) и языковой пакет английского языка. Дополнительные примеры создания макета можно найти на странице "Создание сетевой установки Visual Studio ".

  vs_professional.exe --layout "C:\VS" ^
  --lang en-US ^
  --add Microsoft.VisualStudio.Workload.CoreEditor ^
  

Использование параметра --all для получения всего продукта

• Запустите интерактивную установку всех рабочих нагрузок и компонентов, доступных для выпуска Visual Studio Enterprise:

  vs_enterprise.exe --all
  

Использование параметра --includeRecommended

• Установите второй экземпляр Visual Studio Professional с использованием псевдонима на компьютер с уже установленным выпуском Visual Studio Community с поддержкой разработки на Node.js:

  vs_professional.exe --installPath C:\VSforNode ^
  --add Microsoft.VisualStudio.Workload.Node --includeRecommended --nickname VSforNode
  

Использование — channelURI

С помощью последнего установщика можно настроить, где Visual Studio ищет обновления. В --channelUri противном случае используется канал обновления или исходное расположение обновлений. В следующей таблице приведены примеры значений для channelId и channelUri и то, что они означают.

Если вы решили использовать настраиваемый макет в качестве канала обновления, помните о следующих рекомендациях:

• необходимо --channelUri указать файл channelmanifest.json в пользовательском макете.
• Администраторы могут настроить отображение пользовательского макета "Частный канал" в пользовательском интерфейсе обновления параметров, задав параметры реестра клиента.

Использование параметра --remove

• Удалите компонент средств профилирования из установленного экземпляра Visual Studio по умолчанию. В этом примере установщик уже установлен на клиентском компьютере. Стандартные пользователи с соответствующими разрешениями могут программно выполнить команду изменения с помощью установщика, но они не могут использовать --passive или --quiet переключиться. Обратите внимание, что вы не можете программно инициировать установщик из того же каталога, в котором находится установщик.

  "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify ^
  --installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise" ^
  --remove Microsoft.VisualStudio.Component.DiagnosticTools ^
  --passive
  

Нельзя использовать --remove в той же команде, что --layoutи . Другими словами, невозможно удалить компоненты из макета.

Использование --removeOos

С помощью последнего установщика можно изменить установку и удалить все компоненты, которые перешли в состояние вне поддержки из установленного экземпляра Visual Studio по умолчанию. В этом примере установщик уже установлен на клиентском компьютере для настройки параметра removeOos. Стандартные пользователи, если им предоставлены соответствующие разрешения, могут программно выполнить команду изменения с помощью установщика, но они не могут использовать --passive или --quiet переключиться. Не удается запустить установщик программным способом из того же каталога, в котором находится установщик.

 "C:\Program Files (x86)\Microsoft Visual studio\Installer\setup.exe" modify ^
 --installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise" ^
 --removeOos true ^
 --passive

• Измените параметры обновления, чтобы постоянно удалять все компоненты, перенесенные в состояние вне поддержки при каждом обновлении продукта:

  "C:\Program Files (x86)\Microsoft Visual studio\Installer\setup.exe" modify ^
  --channelURI https://aka.ms/vs/17/release.LTSC.17.0/channel ^
  --productID Microsoft.VisualStudio.Product.Enterprise ^
  --newChannelURI \\layoutserver\share\path\channelmanifest.json ^
  --removeOos true ^
  --quiet  
  

Использование параметра --path

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

• Используйте пути установки, кэширования и общего доступа:

  vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path cache="C:\VS\cache" --path shared="C:\VS\shared"

• Используйте только пути установки и кэширования:

  vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path cache="C:\VS\cache"

• Используйте только общие пути установки и общего доступа:

  vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path shared="C:\VS\shared"

• Используйте только путь установки:

  vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS"

Использование export

• Используйте экспорт для сохранения выделения из установки. В этом примере установщик уже установлен на клиентском компьютере.

  "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" export --installPath "C:\VS" --config "C:\my.vsconfig"
  

• Используйте экспорт для сохранения пользовательского выбора с нуля. В этом примере установщик уже установлен на клиентском компьютере.

  "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" export --channelId VisualStudio.17.Release --productId Microsoft.VisualStudio.Product.Enterprise --add Microsoft.VisualStudio.Workload.ManagedDesktop --includeRecommended --config "C:\my.vsconfig"
  

Использование --config

• Используйте --config для установки рабочих нагрузок и компонентов из ранее сохраненного файла конфигурации установки:

  vs_enterprise.exe --config "C:\my.vsconfig" --installPath "C:\VS"
  

• Используйте --config для добавления рабочих нагрузок и компонентов в существующую установку. В этом примере установщик уже установлен на клиентском компьютере. Стандартные пользователи с соответствующими разрешениями могут программно выполнить команду изменения с помощью установщика, но они не могут использовать --passive или --quiet переключиться. Не удается запустить установщик программным способом из того же каталога, в котором находится установщик.

  "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify --installPath "C:\VS" --config "C:\my.vsconfig"
  

• Используйте --config для настройки содержимого макета:

  vs_enterprise.exe --layout C:\layout --config "C:\my.vsconfig" 
  

Использование winget

Используйте средство Диспетчер пакетов Windows winget для программной установки или обновления Visual Studio на компьютерах вместе с другими пакетами, управляемыми winget. Чтобы настроить установку и указать другие рабочие нагрузки и компоненты, можно использовать переключатель Winget вместе с командой Winget --override install и передать экспортируемый vsconfig-файл следующим образом:

winget install --id Microsoft.VisualStudio.2022.Community --override "--passive --config C:\my.vsconfig"

Вы также можете использовать winget configure и передать файл .yaml для изменения существующей установки Visual Studio. Этот подход использует поставщик Visual Studio PowerShell DSC, описанный здесь.

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

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

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

• Доступен чат по вопросам установки, где можно получить поддержку при проблемах с установкой (только на английском языке).
• Вы можете сообщить о проблемах с продуктом, используя средство Сообщить о проблеме. Оно доступно как в Visual Studio Installer, так и в IDE Visual Studio. Если вы являетесь ИТ-администратором и у вас не установлена программа Visual Studio, вы можете отправить отзыв ИТ-администратора здесь.
• Вы можете предлагать новые функции, просматривать описания проблем и искать решения в сообществе разработчиков Visual Studio.

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

• Руководство администратора Visual Studio
• Использование параметров командной строки для установки Visual Studio
• Создание сетевой установки Visual Studio
• Идентификаторы рабочих нагрузок и компонентов Visual Studio