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

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

• Начните установку на клиенте с заранее выбранными параметрами и предустановленным поведением.
• Автоматизация процесса установки или обновления.
• Создайте или сохраните сетевой макет файлов продуктов для установки или обновления клиентских компьютеров.

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

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

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

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

издание	загрузчик
Visual Studio 2022 Корпоративная	vs_enterprise.exe
Visual Studio 2022 Профессиональный	vs_professional.exe
Сообщество Visual Studio 2022	vs_community.exe
Средства сборки Visual Studio 2022	vs_buildtools.exe

Совет

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

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

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

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

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

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

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

Важный

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

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

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

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

параметры макета	описание
--layout <dir>	Указывает каталог для создания или обновления автономного кэша установки. Дополнительные сведения см. в статье Создание сетевой установки Visual Studio.
--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 Installer на клиентском компьютере, подключенном к Интернету, от проверки обновлений, если клиент настроен на поиск обновлений на серверах, размещенных Microsoft. В этом случае --noWeb просто запрещает клиенту скачивание пакетов продуктов.
--verify	Необязательный: Проверьте содержимое макета. Перечислены все поврежденные или отсутствующие файлы.
--fix	Необязательный: Проверьте содержимое макета. Если какие-либо файлы повреждены или отсутствуют, они повторно загружаются. Для исправления макета требуется доступ к Интернету.
--clean <one or more paths to catalogs>	необязательный: удаляет старые версии компонентов из макета, который обновляется до более новой версии.

расширенные параметры макета	описание
--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	необязательный: если он присутствует, предотвращает обновление установщика при использовании тихого режима. Установщик завершит команду с ошибкой и вернет код выхода, отличный от нуля, если параметр noUpdateInstaller указан в тихом режиме, когда требуется обновление установщика.
--path <name>=<path>	Необязательный: используется для указания настраиваемых путей установки. Поддерживаемые имена путей: общий, кэш и установка.
--path cache=<path>	необязательный: использует указанное расположение для скачивания файлов установки. Это расположение можно задать только при первом установке Visual Studio. Пример: --path cache="C:\VS\cache"
--path shared=<path>	Необязательный: содержит общие файлы для параллельной установки Visual Studio. Некоторые средства и пакеты SDK устанавливаются на этот диск, тогда как другие могут изменить эту настройку и установиться на другой диск. Пример: --path shared="C:\VS\shared" Важно: Это можно задать только один раз и при первой установке Visual Studio.
--path install=<path>	Необязательный: эквивалентен –-installPath. В частности, эквивалентны --installPath "C:\VS" и --path install="C:\VS". Одновременно можно использовать только одну из этих команд.

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

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

Команда	описание
modifySettings	Глагол, используемый для изменения параметров обновления определенного экземпляра Visual Studio.

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

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

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

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

параметры отката	описание
--installPath <dir>	рекомендуется использовать, чтобы указать, на какой экземпляр Visual Studio следует воздействовать.

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

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

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

Вы можете скачать обновление администратора из каталога обновлений Microsoft и использовать его для обновления либо вашей клиентской установки, либо макета.

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

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

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

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

На клиенте, если скачать обновление администратора в каталог установки на клиентском компьютере, можно просто дважды щелкнуть файл, чтобы применить обновление. Вы также можете открыть командное окно и передать некоторые параметры ниже, чтобы изменить поведение по умолчанию.

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

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

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

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

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

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

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

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

Команда	описание
removeChannel	Команда для удаления канала с клиентского компьютера.

удалить параметры канала	описание
--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

Однако если вы хотите настроить установку и указать дополнительные рабочие нагрузки и компоненты для получения во время начальной установки, можно использовать параметр --override winget вместе с командой winget install и передать экспортируемый файл 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, можно использовать configure команды winget вместе с поставщиком Visual Studio PowerShell DSC, yaml-файлом и VSCONFIG-файлом для добавления компонентов в существующую установку Visual Studio. Команда Winget configure по сути выступает в качестве операции модификации Visual Studio. См. , как создать файл конфигурации WinGet, чтобы лучше понять процесс создания конфигурации winget.

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

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

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

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

Список языковых локалей

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

Коды ошибок

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

значение	результат
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" для получения пошаговых инструкций.

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

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

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

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