Использование параметров командной строки для установки, обновления и управления Visual Studio

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

  • запуск установки на клиенте с рядом предварительно выбранных параметров и действий;
  • автоматизация процесса установки или обновления;
  • создание и поддержка сетевого макета файлов продукта для установки или обновления клиентских компьютеров.

Следующие команды командной строки и параметры можно использовать со следующими исполняемыми файлами или программами:

  • Загрузчик установки, который является небольшим (~1 МБ) файлом (например, vs_enterprise.exe), который инициирует процесс скачивания и начальную установку.
  • Установщик Visual Studio, который уже может быть установлен на компьютере и находится в папке C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe. Необходимо программно инициировать установщик из другого каталога, в котором находится установщик. Установщик обычно используется для обновления или изменения команд.
  • С помощью команды winget с помощью переключателя --override winget.
  • С пакетом обновления Администратор istrator, который доступен для скачивания из каталога центра обновления Майкрософт, чтобы программно обновить макет сети. Дополнительные сведения можно найти в статье об обновлении или изменении макета .

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

Загрузчики Visual Studio 2019 можно получить из следующей таблицы. Кроме того, если требуется определенная версия Visual Studio 2019, см . страницу выпусков Visual Studio 2019. Эта страница содержит ссылки на фиксированные загрузчики версии для выбранной версии и выпуска Visual Studio.

Выпуск Загрузчика
Visual Studio 2019 Enterprise версии 16.11 vs_enterprise.exe
Visual Studio 2019 Professional версии 16.11 vs_professional.exe
Visual Studio 2019 Build Tools версии 16.11 vs_buildtools.exe

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

Выпуск Загрузчика
Visual Studio 2022 Enterprise vs_enterprise.exe
Visual Studio 2022 Professional vs_professional.exe
Visual Studio 2022 Community vs_community.exe
Visual Studio 2022 Build Tools vs_buildtools.exe

Совет

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

Совет

Если вы ранее скачали файл начального загрузчика и хотите проверить, какую версию он установит, см. следующие инструкции. В Windows откройте проводник, щелкните правой кнопкой мыши файл начального загрузчика, выберите Свойства и перейдите на вкладку Подробности. Поле Версия продукта отобразит канал и версию, которые установит начальный загрузчик. Номер версии следует читать как "последняя обслуживаемая конкретная версия", а канал является текущим, если явно не указано иное. Таким образом, начальный загрузчик с версией продукта канала LTSC 17.0 установит последний обслуживаемый выпуск 17.0.x, доступный на канале LTSC 17.0. Начальный загрузчик с версией продукта, указанной как "Visual Studio 2022", установит последнюю версию Visual Studio 2022 с текущего канала.

Команды установки, обновления, изменения, удаления и экспорта и параметры командной строки

При вызове загрузчика Visual Studio или установщика программным способом для установки продукта или поддержания макета:

  • Первый параметр — это команда (глагол), описывающая операцию для выполнения.
  • Последующие необязательные параметры командной строки, все префиксы с двумя дефисами (--) далее определяют, как должна происходить эта операция.

Все параметры командной строки Visual Studio не учитывает регистр, а дополнительные примеры можно найти на странице примеров параметров командной строки.

Пример синтаксиса: vs_enterprise.exe [command] <optional parameters>...

Command Description
(пусто) Команда по умолчанию устанавливает продукт и используется для всех операций обслуживания макета.
modify Изменяет установленный продукт.
update Обновляет установленный продукт.
updateall Обновления все установленные продукты в последовательном порядке. Работает с --quiet и --passive параметрами.
repair Восстанавливает установленный продукт.
uninstall Удаляет установленный продукт.
export Экспорт конфигурации установки в *.vsconfig файл.

Внимание

При указании множества разных рабочих нагрузок, компонентов или языков необходимо повторять параметр командной строки --add или --remove для каждого элемента.

Параметры Description
--installPath <dir> Для команды установки по умолчанию этот параметр является необязательным и описывает, где экземпляр установлен на клиентском компьютере. Для других команд, таких как update или modify, этот параметр является обязательным и определяет каталог установки для экземпляра.
--productId <id> Необязательный: идентификатор экземпляра продукта, который изменяется и используется с --channelId. Параметр productID — это что-то вроде "Microsoft.VisualStudio.Product.Enterprise".
--channelUri Необязательно. Во время команды обновления можно передать новое --channelUri , чтобы изменить расположение параметров обновления. Рекомендуется связать с --installPath параметром, чтобы он был явным, какой экземпляр Visual Studio вы настраиваете. См. примеры синтаксиса --channelUri
--channelId <id> Идентификатор канала, например VisualStudio.17.Release. См . примеры синтаксиса --channelId. channelId требуется для операций изменения, а также --productID для либо --installPath.
--add <one or more workload or component IDs> Необязательно. В команде install или modify этот параметр (который можно указывать многократно) задает идентификаторы рабочих нагрузок и компонентов для добавления. Необходимые компоненты артефакта установлены, однако не установлены рекомендуемые или необязательные компоненты. Вы можете управлять другими компонентами глобально с помощью --includeRecommended и (или) --includeOptional параметров. Чтобы включить несколько рабочих нагрузок или компонентов, повторите команду --add (например, --add Workload1 --add Workload2). Для более детального контроля можно добавить к идентификатору ;includeRecommended или ;includeOptional (например, --add Workload1;includeRecommended или --add Workload2;includeRecommended;includeOptional). Дополнительные сведения см. в статье о рабочей нагрузке и идентификаторах компонента.
--all Необязательно. В команде install или modify этот параметр обеспечивает установку всех рабочих нагрузок и компонентов продукта.
--allWorkloads Необязательно. В команде install или modify этот параметр устанавливает все рабочие нагрузки и компоненты, кроме рекомендуемых или необязательных компонентов.
--includeRecommended Необязательно. Во время команды установки или изменения этот параметр включает рекомендуемые компоненты для всех установленных рабочих нагрузок. Он не включает необязательные компоненты. Рабочие нагрузки указываются с помощью параметра --allWorkloads или --add.
--includeOptional Необязательно. Во время команды установки или изменения этот параметр включает необязательные компоненты для всех установленных рабочих нагрузок. Он не включает рекомендуемые компоненты. Рабочие нагрузки указываются с помощью параметра --allWorkloads или --add.
--addProductLang <language-locale> Обязательно. В команде install или modify этот параметр (который можно указывать многократно) задает языковые пакеты пользовательского интерфейса для установки вместе с продуктом. Если он отсутствует, при установке используется языковой пакет, который соответствует языковому стандарту компьютера. Дополнительные сведения см. в разделе [Список языковых стандартов языка]
--remove <one or more workload or component IDs> Необязательно. В команде modify этот параметр (который можно указывать многократно) задает идентификаторы рабочих нагрузок и компонентов для удаления. Он дополняет параметр --add и действует схожим образом.
(#list языкового стандарта) на этой странице.
--removeProductLang <language-locale> Обязательно. В команде install или modify этот параметр (который можно указывать многократно) задает языковые пакеты пользовательского интерфейса, которые необходимо удалить из продукта. Он дополняет параметр --addProductLang и действует схожим образом.
--in <path> Необязательно. Универсальный код ресурса (URI) или путь к файлу ответов, который может содержать параметры конфигурации.
--quiet Необязательно. Этот параметр используется с любой командой и скрывает пользовательский интерфейс во время ее выполнения. Недоступно для программного использования стандартными пользователями независимо от того, как задана политика AllowStandardUserControl.
--passive, -p Необязательно. Этот параметр обеспечивает отображение пользовательского интерфейса в неинтерактивном режиме. Этот параметр исключает и фактически переопределяет параметр --quiet. Кроме того, недоступен для программного использования стандартными пользователями независимо от того, как задана политика AllowStandardUserControl.
--norestart Необязательно. Этот параметр должен использоваться в паре с параметром --passive или --quiet. Во время установки, обновления или изменения команды добавление --norestart параметра задерживает любую необходимую перезагрузку.
--force Необязательно. Этот параметр принудительно закрывает Visual Studio, даже если какой-то процесс этой среды еще используется. Принудительное завершение работы Visual Studio может привести к потере работы, поэтому используйте этот процесс с осторожностью.
--installWhileDownloading Необязательно. В командах install, update или modify этот параметр позволяет Visual Studio параллельно скачивать и устанавливать продукт. Это поведение по умолчанию.
--downloadThenInstall Необязательно. В командах install, update или modify этот параметр требует Visual Studio загружать все файлы перед их установкой. Он является взаимоисключающим по отношению к параметру --installWhileDownloading.
--nickname <name> Необязательно. В команде install этот параметр определяет псевдоним, присваиваемый устанавливаемому продукту. Длина псевдонима не может превышать 10 символов.
--productKey Необязательно. В команде install этот параметр определяет ключ устанавливаемого продукта. Ключ продукта состоит из 25 буквенно-цифровых символов в формате xxxxxxxxxxxxxxxxxxxxxxxxx.
--removeOos true Необязательно. При установке, обновлении или изменении команды этот параметр, за которым следует true или false, указывает установщику Visual Studio удалить все установленные компоненты, перенесенные в состояние вне поддержки. Это поведение применимо к одному событию. Если вы хотите сделать это поведение постоянным, примените этот параметр к команде modify Параметры, описанной далее, или настройте глобальную политику removeOOS. Полезно для обеспечения безопасности компьютера.
--config <path to *.vsconfig file> Необязательно. Во время операции установки или изменения можно передать файл конфигурации с помощью --config параметра, чтобы указать рабочие нагрузки, компоненты или расширения для добавления на основе ранее сохраненного файла конфигурации установки. Эта операция является аддитивной только; Он не удаляет ничего, что не указано в файле. Кроме того, элементы, указанные в файле конфигурации, которые не применяются к продукту, не добавляются. Настоятельно рекомендуется указать полный путь к файлу конфигурации. Во время операции экспорта этот параметр определяет расположение для сохранения файла конфигурации установки.
--allowUnsignedExtensions Необязательно. Во время выполнения операции установки или изменения в файле или --quiet контексте --config с помощью файла, если расширения указаны в --passive файле конфигурации, этот параметр необходим для загрузки расширений без цифровой подписи.
--installerOnly Необязательно. Во время операции установки или обновления этот параметр сообщает Visual Studio Installer установить только себя (установщик) и не продукт Visual Studio. Его функциональность эквивалентна параметру --update , но более интуитивно понятным. Предназначено для использования при подготовке и предварительной настройке клиентских компьютеров.
--help, --?, -h, -? Отображает автономную версию этой страницы.

Команда и параметры командной строки для макета

Все операции управления макетами, такие как создание или обновление макета, выполняются с помощью загрузчика exe и предполагают, что команда является установкой по умолчанию (пустой). Все операции управления макетами должны начинаться с требуемого --layout начального параметра. В следующей таблице описаны другие параметры, которые можно использовать для создания или обновления макета с помощью командной строки.

Параметры макета Description
--layout <dir> Определяет каталог для создания или обновления автономного кэша установки. Дополнительные сведения см. в статье Создание сетевой установки Visual Studio 2017.
--lang <one or more language-locales> Необязательно. Используется для --layout подготовки автономного кэша установки с пакетами ресурсов с указанными одним или несколькими указанными языками. Дополнительные сведения см. в разделе Список языковых стандартов на этой странице.
--add <one or more workload or component IDs> Необязательно. Один или несколько идентификаторов рабочих нагрузок или компонентов, которые нужно добавить. Необходимые компоненты артефакта установлены, однако не установлены рекомендуемые или необязательные компоненты. Вы можете управлять большими компонентами глобально с помощью --includeRecommended и(или) --includeOptional. Для более детального контроля можно добавить к идентификатору ;includeRecommended или ;includeOptional (например, --add Workload1;includeRecommended или --add Workload2;includeOptional). Дополнительные сведения см. в статье о рабочей нагрузке и идентификаторах компонента.
Примечание. Если используется --add, будут скачаны только указанные рабочие нагрузки, компоненты и их зависимости. Если параметр --add не указан, в макет будут скачаны все рабочие нагрузки и компоненты.
--includeRecommended Необязательно. Включает в установку рекомендуемые компоненты для всех устанавливаемых рабочих нагрузок, но не дополнительные компоненты. Рабочие нагрузки указываются с помощью параметра --allWorkloads или --add.
--includeOptional Необязательно. Включает рекомендуемые и дополнительные компоненты для любой рабочей нагрузки, которая включена в макет. Рабочие нагрузки указываются с помощью параметра --add.
--wait Необязательно. Процесс ожидает завершения установки перед возвратом кода выхода. wait полезно при автоматизации установок, когда необходимо дождаться завершения установки для обработки возвращаемого кода из этой установки. Параметр --wait можно передать только в загрузчик. Установщик (setup.exe) не поддерживает его. Полезно при обновлении макетов. Дополнительные примеры см . здесь.
--useLatestInstaller Необязательно. Устаревшие функции, применимые только для загрузчиков Visual Studio старше апреля 2023 года. Все, что поставляется после апреля 2023 года, использует последний установщик по умолчанию. Если этот параметр присутствует, то последняя версия Установщика Visual Studio включена в макет, даже если она принадлежит к более новой основной версии продукта. Последний установщик может быть полезен, если вы хотите воспользоваться преимуществами новых функций или исправлений ошибок, доступных в последней версии. Дополнительные сведения см. в разделе Настройка макета так, чтобы всегда использовался последний установщик.
--config <path to *.vsconfig file> Необязательно. При наличии Visual Studio использует содержимое файла конфигурации для настройки макета. Укажите полный путь к файлу конфигурации.
--noWeb Необязательно. При наличии программа установки Visual Studio использует файлы в каталоге макета для установки Visual Studio и не загружает пакеты из Интернета. Если пользователь пытается установить компоненты, отсутствующие в макете, установка завершается ошибкой. Не используйте этот параметр, если вы пытаетесь развернуть макет, размещенный на внутреннем веб-сайте интрасети. Дополнительные сведения см. в разделе "Установка на клиенте, который не имеет доступа к Интернету".

Важно. Параметр --noWeb не останавливает установщик Visual Studio на клиентском компьютере, подключенном к Интернету, от проверка обновлений, если клиент настроен на просмотр размещенных корпорацией Майкрософт серверов для обновлений. В этом случае --noWeb просто запрещает клиенту скачивание пакетов продуктов.
--verify Необязательно. Проверка содержимого макета. Перечисляет все поврежденные и отсутствующие файлы.
--fix Необязательно. Проверка содержимого макета. Если какие-либо файлы повреждены или отсутствуют, они скачиваются повторно. Для исправления макета требуется подключение к Интернету.
--clean <one or more paths to catalogs> Необязательно. Удаляет старые версии компонентов из макета, обновляемого до более новой версии.
Расширенные параметры макета Description
--channelId <id> Необязательный: идентификатор канала для установленного экземпляра, представленный следующим образом VisualStudio.17.Release. ChannelId требуется для команды установки и игнорируется для других команд, если --installPath он указан. См . примеры синтаксиса --channelId.
--channelUri <uri> Необязательно. Универсальный код ресурса (URI) манифеста канала. Это значение управляет исходным расположением обновлений, а начальное значение настраивается в файле response.json макета. Дополнительные значения см. в примерах синтаксиса --channelUri . Если обновления нежелательны, --channelUri может указывать на несуществующий файл (например, --channelUri C:\doesntExist.chman). Этот параметр можно использовать для команды установки; другие команды игнорируют его.
--installChannelUri <uri> Необязательно. Универсальный код ресурса (URI) манифеста канала, используемого для установки. Универсальный код ресурса (URI), указанный с помощью параметра --channelUri (который является обязательным при наличии параметра --installChannelUri), используется для обнаружения обновлений. Этот параметр можно использовать для команды установки; другие команды игнорируют его.
--installCatalogUri <uri> Необязательно. Универсальный код ресурса (URI) манифеста каталога, используемого для установки. Если этот параметр задан, диспетчер канала будет сначала пытаться скачать манифест каталога по этому коду URI, прежде чем использовать URI, указанный в манифесте канала установки. Этот параметр используется для поддержки автономной установки, в которой кэш макета создается с уже скачанным каталогом продуктов. Этот параметр можно использовать для команды установки; другие команды игнорируют его.
--productId <id> Необязательно. Идентификатор продукта для установленного экземпляра. Этот параметр предварительно заполняется в обычных условиях установки. Параметр productID — это что-то вроде "Microsoft.VisualStudio.Product.Enterprise".
--arch all Необязательно. По умолчанию макеты создаются только с двоичными файлами продуктов x64. Чтобы включить двоичные файлы ARM для применимых рабочих нагрузок вместе с двоичными файлами x64 в макете, используйте --arch all или --arch * параметр. Чтобы создать макет только двоичных файлов ARM, используйте --arch arm64
--keepLayoutVersion Необязательно. Применение изменений к макету без обновления версии продукта, включенного в макет.
--locale <language-locale> Необязательно. Изменяет язык пользовательского интерфейса самого установщика. Настройка сохраняется. Дополнительные сведения см. в разделе Список языковых стандартов на этой странице.
--cache Необязательно. При наличии этого параметра пакеты после установки будут сохраняться для последующих исправлений. Это значение переопределяет глобальную политику, настроенную для последующих установок, восстановлений или изменений. По умолчанию кэш пакетов используется. Этот параметр игнорируется для команды удаления. Дополнительные сведения см. в статье об отключении или перемещении кэша пакетов.
--nocache Необязательно. При наличии этого параметра пакеты после установки или исправления будут удаляться. Они будут загружены только в том случае, если потребуются еще раз, и будут снова удалены после использования. Это значение переопределяет глобальную политику, настроенную для последующих установок, восстановлений или изменений. По умолчанию кэш пакетов используется. Этот параметр игнорируется для команды удаления. Дополнительные сведения см. в статье об отключении или перемещении кэша пакетов.
--noUpdateInstaller Необязательно. При наличии этого параметра установщик не обновляет сам себя при указании режима quiet. Программа установки завершает команду со сбоем и возвращает ненулевой код выхода, если noUpdateInstaller с параметром quiet указан, когда требуется обновление установщика.
--path <name>=<path> Необязательно. Используется для указания настраиваемых путей установки. Поддерживаемые имена пути используются совместно, кэшируются и устанавливаются.
--path cache=<path> Необязательно. Использует заданное вами расположение для скачивания установочных файлов. Расположение можно задать только при первой установке Visual Studio. Пример: --path cache="C:\VS\cache"
--path shared=<path> Необязательно. Содержит общие файлы для параллельных установок Visual Studio. Некоторые средства и пакеты SDK устанавливаются на этот диск. Этот параметр можно переопределить, чтобы установить другие средства и пакеты SDK на другой диск. Пример: --path shared="C:\VS\shared"

Важно. Этот параметр можно задать только один раз — при первой установке Visual Studio.
--path install=<path> Необязательно. Эквивалентно –-installPath. --installPath "C:\VS" и --path install="C:\VS" эквивалентны. Нельзя одновременно использовать обе команды.

Изменение Параметры параметров командной строки и командной строки

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

Command Description
modifySettings Команда, используемая для изменения параметров обновления определенного экземпляра Visual Studio.
Параметры modifySettings Description
--installPath <dir> Рекомендуется использовать для указания экземпляра Visual Studio для работы.
--newChannelUri Обязательно. Универсальный код ресурса (URI) манифеста канала. Это значение указывает, где будут находиться следующие исходные расположения обновлений. Дополнительные значения см. в примерах синтаксиса --channelUri . Если обновления нежелательны, --channelUri может указывать на несуществующий файл (например, --channelUri C:\doesntExist.chman).
--channelUri Универсальный код ресурса (URI) старого манифеста канала. Может использоваться, если параметр --installPath неизвестен. Должен использоваться в сочетании с productID, чтобы указать нужный экземпляр для работы.
--productId <id> Должен использоваться, если указан параметр --channelUri; используется для указания нужного экземпляра для работы. Параметр productID — это что-то вроде "Microsoft.VisualStudio.Product.Enterprise".
--quiet Необязательно. Этот параметр скрывает пользовательский интерфейс во время ее выполнения. Недоступно для программного использования стандартными пользователями.
--removeOos true Необязательно. При изменении Параметры команде этот параметр (который должен иметь слово true или false сразу после него) сообщает установщику Visual Studio постоянно удалять (или не удалять) все установленные компоненты, которые перешли в состояние вне поддержки. Полезно для обеспечения безопасности компьютера.

Примеры синтаксиса

C:\>"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modifySettings --installPath "C:\Program Files\Microsoft\Visual Studio\2022\Enterprise" --newChannelUri https://aka.ms/vs/17/release.LTSC.17.0/channel --removeOos true
 C:\>"C:\Program Files\Microsoft\Visual Studio\2022\Enterprise\vs_enterprise.exe" modifySettings --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

Параметры команды отката и командной строки

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

Command Description
rollback Команда для отката определенного экземпляра Visual Studio в ранее установленное обновление. Эта команда не будет работать, если включена DisableRollback эта команда.
Параметры отката Description
--installPath <dir> Рекомендуется использовать для указания экземпляра Visual Studio для работы.

Примеры синтаксиса

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" rollback -–installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise"

Команда и параметры командной строки для обновлений администратора

Вы можете загрузить обновление администратора из каталога Центра обновления Майкрософт и использовать его для обновления установки клиента или макета.

Обновление макета

Если вы обновляете макет до определенной версии Visual Studio, просто скачайте обновление Администратор istrator на компьютер, на котором размещен макет, откройте командную строку на этом компьютере и выполните следующую команду:

visualstudioupdate-17.0.0to17.1.5.exe layout --layoutPath c:\VSLayout

Обновление клиента

Если вы загружаете обновление администратора из каталога Центра обновления Майкрософт в каталог установки на клиентском компьютере, на клиенте можно просто дважды щелкнуть файл, чтобы применить обновление. Для изменения действий по умолчанию можно открыть окно командной строки и передать какие-то из параметров ниже.

Настройка обновления Администратор istrator в SCCM

При развертывании обновления администратора с помощью Microsoft Endpoint Manager (SCCM) можно изменить пакет, чтобы настроить поведение с помощью приведенных ниже параметров. Управлять параметрами также можно через файл конфигурации на клиентском компьютере. Дополнительные сведения см. в разделе Способы настройки обновления администратора

Обратите внимание, что все параметры обновления администратора по умолчанию выполняются в контексте "update", если не указана команда макета.

Параметры обновления администратора Description
--installerUpdateArgs [optional parameters] Этот параметр функционирует как передаваемый массив определенных параметров, относящихся к сценариям обновления администратора. Необязательные параметры, включенные для этой цели:

--quiet: это используемый по умолчанию режим для обновлений администратора, который указан здесь для полноты информации.
--passive: этот параметр переопределяет параметр --quiet. Он обеспечивает отображение пользовательского интерфейса в неинтерактивном режиме.
--norestart: этот параметр должен использоваться в сочетании с --quiet или --passive и позволяет задержать требуемую перезагрузку.
--noWeb: этот параметр не позволяет Visual Studio проверять наличие обновлений продукта в Интернете.
--force: этот параметр заставляет Visual Studio закрывать, даже если Visual Studio используется. Используйте его с осторожностью, чтобы не потерять текущую работу. Этот параметр должен использоваться только в том случае, если обновление Администратор istrator выполняется в контексте пользователя; оно игнорируется, если обновление Администратор istrator выполняется в системном контексте.
--installWhileDownloading: этот параметр позволяет Visual Studio параллельно скачивать и устанавливать продукт. Такой режим используется для обновлений администратора по умолчанию, и он приведен здесь для полноты информации.
--keepWindowsUpdateOn: этот параметр запрещает установщику отключать агент Обновл. Windows на клиенте. Этот параметр следует использовать при импорте обновления Администратор istrator из каталога в SCCM. Кроме того, может потребоваться задать время ожидания пакета SCCM дольше, чем значение по умолчанию 10 минут. Изменение типа развертывания SCCM, который должен быть обязательным, делает этот параметр ненужным.
--downloadThenInstall: этот параметр заставляет Visual Studio скачивать все файлы перед их установкой. Он является взаимоисключающим по отношению к параметру --installWhileDownloading.
--checkPendingReboot Обновление будет прервано, если на компьютере ожидается перезагрузка, какое бы приложение ее ни вызвало. По умолчанию проверка ожидающих перезагрузок не выполняется.

Пример синтаксиса для передачи параметров в обновление Администратор istrator:

visualstudioupdate-16.9.0to16.9.4.exe --installerUpdateArgs=--force,--noWeb,--keepWindowsUpdateOn --checkPendingReboot

Удаление параметров команды канала и командной строки

Каналы, доступные для обновления, кэшируются на клиенте, и с течением времени они могут загромождать вещи. Каналы обновления можно удалить вручную, разместив установщик Visual Studio, переключившись на вкладку "Доступно" и щелкнув X в правом верхнем углу продукта карта. Вы можете программно удалить каналы (например, старые расположения макета removeChannel ) с помощью команды. Вы можете запускать vswhere программным способом на клиентском компьютере, чтобы определить, какие каналы кэшируются на клиентском компьютере.

Command Description
removeChannel Команда для удаления канала с клиентского компьютера.
removeChannel parameters Description
--channelUri Обязательный универсальный код ресурса (URI) старого манифеста канала.
--quiet Необязательный параметр Этот параметр предотвращает отображение пользовательского интерфейса во время выполнения команды.
--passive Необязательный параметр переопределяет --quiet параметр. Он обеспечивает отображение пользовательского интерфейса в неинтерактивном режиме.

Пример синтаксиса:

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" removeChannel --channelUri "\\\\server\\share\\layoutdirectory\\ChannelManifest.json"

Установка или изменение Visual Studio с помощью winget

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

По умолчанию winget просто устанавливает основную рабочую нагрузку Visual Studio.

winget install --id Microsoft.VisualStudio.2022.Community

Однако если вы хотите настроить установку и указать дополнительные рабочие нагрузки и компоненты для получения во время начальной установки, можно использовать параметр winget вместе с командой Winget --overrideinstall и передать экспортируемый vsconfig-файл , содержащий рабочие нагрузки и компоненты, которые необходимо добавить:

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

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

 winget install --id Microsoft.VisualStudio.2022.Community --override "--quiet --add Microsoft.Visualstudio.Workload.Azure"

Если на компьютере уже установлен Visual Studio, можно использовать команду winget configure вместе с поставщиком Visual Studio PowerShell DSC, yaml-файлом и VSCONFIG-файлом для добавления компонентов в существующую установку Visual Studio. Команда Winget configure по сути выступает в качестве операции "изменить" Visual Studio.

Невозможно использовать --override переключатель или поставщик Visual Studio DSC вместе с командой Winget upgrade , так как upgrade , по сути, просто действует как операция обновления Visual Studio и устанавливает последнюю версию компонентов, которые вы уже выбрали. Невозможно добавить компоненты с помощью обновления или обновления. Необходимо использовать winget configure для добавления компонентов.

Обратите внимание, что в настоящее время для операций установщика Visual Studio требуются права администратора, поэтому winget предложит вам повысить привилегии при необходимости для выполнения команды. Кроме того, в настоящее время невозможно использовать winget для установки нескольких выпусков (то есть разных номеров SKU) или нескольких экземпляров одного номера SKU одновременно на клиентском компьютере. Наконец, Visual Studio должен быть закрыт, если вы собираетесь настроить (изменить) его для добавления компонентов или обновления до последней версии.

Список идентификаторов рабочих нагрузок и компонентов

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

Список языковых стандартов

Язык-языковой стандарт Язык
Cs-cz чешский
De-de Немецкий
En-us Английский
Es-es Испанский
Fr-fr Французский
It-it Итальянский
Ja-jp Японский
Ko-kr Корейский
Pl-pl Польский
Pt-br Португальский — Бразилия
Ru-ru русский
Tr-tr Турецкий
Zh-cn Китайский (упрощенное письмо)
Zh-tw Китайский — традиционное письмо

Коды ошибок

В зависимости от результата операции переменной среде %ERRORLEVEL% присваивается одно из следующих значений:

Value Результат
0 Операция выполнена успешно.
740 Требуется повышение прав
1001 Процесс установки Visual Studio сейчас выполняется.
1003 Visual Studio сейчас используется.
1602 Операция отменена
1618 Запущена другая установка
1641 Операция успешно завершена; начата перезагрузка
3010 Операция выполнена успешно, но перед началом работы необходимо выполнить перезагрузку.
5003 Не удалось скачать установщик в начальном загрузчике
5004 Операция отменена
5005 Ошибка синтаксического анализа командной строки начального загрузчика
5007 Операция была заблокирована — компьютер не соответствует требованиям
8001 Сбой проверки компьютера ARM
8002 Сбой предварительной проверки фоновой загрузки
8003 Сбой неподдерживаемого выделения
8004 Сбой целевого каталога
8005 Сбой проверки исходных полезных данных
8006 Выполняются процессы Visual Studio
8010 Операционная система не поддерживается. Сведения о требованиях к системе
-1073720687 Сбой подключения
–1073741510 Работа установщика Microsoft Visual Studio была прервана (пользователем или внешним процессом)
Другие
(например,
–1, 1, 1603)
Произошел сбой — проверьте журналы для получения дополнительных сведений

Каждая операция создает в каталоге %TEMP% несколько файлов журнала, которые показывают ход выполнения установки. Отсортируйте содержимое папки по дате и найдите файлы, которые начинаются с dd_bootstrapper, dd_client и dd_setup (для программы начальной загрузки, установщика и модуля установки соответственно).

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

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

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