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

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

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

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

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

Для выполнения команд в неинтерактивном режиме можно использовать--passive или --quiet. Дополнительные сведения об этих параметрах см. на странице команд и параметров командной строки .

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

Установка с помощью --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 на одном шаге с помощью установщика на клиенте. Обратите внимание, что вы не можете программно инициировать установщик из того же каталога, в котором находится установщик.

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

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

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

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

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

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

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

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

  или

    $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	--channelId
Стабильный канал Visual Studio 2026	https://aka.ms/vs/stable/channel	VisualStudio.18.Stable
Канал инсайдеров Visual Studio 2026	https://aka.ms/vs/insiders/channel	VisualStudio.18.Insiders
Текущий канал Visual Studio 2022	https://aka.ms/vs/17/release/channel	VisualStudio.17.Release
Visual Studio 2022 версия 17.0, канал LTSC	https://aka.ms/vs/17/release.LTSC.17.0/channel	VisualStudio.17.Release.LTSC.17.0
Канал предварительной версии Visual Studio 2022	https://aka.ms/vs/17/pre/channel	VisualStudio.17.Preview
Канал выпуска Visual Studio 2019	https://aka.ms/vs/16/release/channel	VisualStudio.16.Release
Канал выпуска Visual Studio 2017	https://aka.ms/vs/15/release/channel	VisualStudio.15.Release
Настраиваемый макет — частный канал	\\layoutserver\share\path\channelmanifest.json	VisualStudio.17.Release (или то, на чем основан макет)

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

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

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

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

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify ^
 --installPath "C:\Program Files\Microsoft Visual Studio\18\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\18\Enterprise" ^
 --removeOos true ^
 --passive

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

  "C:\Program Files (x86)\Microsoft Visual studio\Installer\setup.exe" modify ^
  --channelURI https://aka.ms/vs/stable.18.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"

Использование экспорта

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

  "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.18.Stable --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. Чтобы настроить установку и указать другие рабочие нагрузки и компоненты, можно использовать параметр --override winget вместе с командой winget install и передать экспортируемый файл vsconfig следующим образом:

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

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

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

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

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

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

Связанное содержимое

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