Поделиться через


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

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

Использование --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 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 (или то, на чем основан макет)

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

Использование --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"

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

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

    "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. Чтобы настроить установку и указать другие рабочие нагрузки и компоненты, можно использовать параметр --override winget вместе с командой winget 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, так и в Visual Studio IDE. Если вы администратор ИТ и у вас не установлен Visual Studio, вы можете отправить отзыв как администратор ИТ .
  • Предложите функцию, отслеживайте проблемы с продуктом и найдите ответы в сообществе разработчиков Visual Studio.