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

Статья
01/31/2025

Чтобы иллюстрировать, как использовать параметры командной строки для установки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.

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

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

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

Обновление

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

Создание сетевого макета или локального кэша с помощью макета --layout

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

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

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

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

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

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

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

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

Использование пакетного менеджера winget

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

Обратная связь

Дополнительные ресурсы

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

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

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

Обновление

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

Создание сетевого макета или локального кэша с помощью макета --layout

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

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

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

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

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

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

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

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

Использование пакетного менеджера winget

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

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

Обратная связь

Дополнительные ресурсы