Примеры параметров командной строки для установки 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 (или то, на чем основан макет) |
Если вы решили использовать настраиваемый макет в качестве канала обновления, помните о следующих рекомендациях:
-
--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\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.