Команда install (winget)

Команда install программы winget устанавливает указанное приложение. Чтобы указать приложение, которое нужно установить, используйте команду search.

Для команды install необходимо указать точную строку для установки. В случае какой-либо неоднозначности вам будет предложено дополнительно отфильтровать команду install для уточнения приложения.

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

winget install [[-q] \<query> ...] [\<options>]

install command

Aliases

Для этой команды доступны следующие псевдонимы:

  • add

Аргументы

Доступные аргументы перечислены ниже.

Аргумент Description
-q,--query Запрос, используемый для поиска приложения.

Примечание.

Аргумент запроса является позиционным. Синтаксис с использованием подстановочных знаков не поддерживается. Чаще всего это строка символов, которая должна уникальным образом идентифицировать пакет, который вы хотите установить.

Параметры

Эти параметры позволяют настроить функцию установки в соответствии со своими потребностями.

Вариант Описание
-m, --manifest За этим параметром должен следовать путь к файлу манифеста (YAML). Манифест можно использовать для запуска функции установки из локального файла YAML.
--id Ограничивает установку приложением с определенным идентификатором.
--name Ограничивает поиск приложением с определенным именем.
--moniker Ограничивает поиск моникером, указанным для приложения.
-v, --version Позволяет указать точную версию для установки. Если параметр не задан, будет установлено приложение с наибольшим номером версии.
-s, --source Ограничивает поиск источником с указанным именем. За этим параметром должно следовать имя источника.
--scope Позволяет указать, должен ли установщик использовать область пользователя или компьютера. Ознакомьтесь с известными проблемами, связанными с установкой пакетов область.
-a, --architecture Выбор архитектуры для установки.
--installer-type Выберите тип установщика для установки. См. поддерживаемые типы установщиков для клиента WinGet.
-e, --exact Ищет точное совпадение со строкой в запросе, выполняя при этом проверку на учет регистра. Поведение по умолчанию для подстроки не используется.
-i, --interactive Запускает установщик в интерактивном режиме. При взаимодействии по умолчанию отображается ход выполнения установщика.
-h, --silent Запускает установщик в автоматическом режиме. Блокирует весь пользовательский интерфейс. При взаимодействии по умолчанию отображается ход выполнения установщика.
--locale Указывает используемый языковой стандарт (формат BCP47).
-o, --log Направляет данные журнала в файл журнала. Необходимо указать путь к файлу, для которого у вас есть права на запись.
--Пользовательские Аргументы, передаваемые установщику в дополнение к значениям по умолчанию.
--override Строка, которая будет передана непосредственно в установщик.
-l, --location Расположение для установки (если поддерживается).
--ignore-security-hash Игнорировать сбой хэша установщика проверка. Не рекомендуется.
--ignore-local-archive-malware-scan Игнорировать сканирование вредоносных программ, выполняемое в рамках установки пакета типа архива из локального манифеста.
--dependency-source Найдите зависимости пакета с помощью указанного источника.
--accept-package-agreements Используется для принятия лицензионного соглашения и позволяет избежать появления запроса.
--accept-source-agreements Используется для принятия исходного лицензионного соглашения и позволяет избежать появления запроса.
--no-upgrade Пропускает обновление, если установленная версия уже существует.
--header Необязательный заголовок HTTP источника REST Windows-Package-Manager.
-r, --rename Значение для переименования исполняемого файла (переносимый)
--uninstall-previous Удаление предыдущей версии пакета во время обновления
--force Прямо выполните команду и продолжайте работу с проблемами, связанными с безопасностью.
-?, --help Позволяет получит дополнительную справку по этой команде.
--Подожди Предложит пользователю нажать любой ключ перед выходом.
--logs,--open-logs Откройте расположение журналов по умолчанию.
--verbose, --verbose-logs Используется для переопределения параметра ведения журнала и создания подробного журнала.
--disable-interactivity Отключите интерактивные запросы.

Примеры запросов

В следующем примере устанавливается определенная версия приложения.

winget install powertoys --version 0.15.2

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

winget install --id Microsoft.PowerToys

В следующем примере выполняется установка приложения по версии и идентификатору.

winget install --id Microsoft.PowerToys --version 0.15.2

Множественный выбор

Если по запросу, отправленному программе winget, найдено несколько приложений, winget отобразит результаты поиска. Это даст вам дополнительные данные, необходимые для уточнения условий поиска и правильной установки.

Лучший способ ограничить выбор одним файлом — использовать идентификатор приложения в сочетании с параметром точного запроса. Например:

winget install --id Git.Git -e

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

winget install --id Git.Git -e --source winget

Источник msstore использует уникальные идентификаторы в качестве значения Id для пакетов. Для них не требуется параметр запроса exact. Например:

winget install XP9KHM4BK9FZ7Q -s msstore

Локальная установка

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

Использование: winget install --manifest \<path>

Вариант Описание
-m, --manifest Путь к манифестам устанавливаемого приложения.

Примечание.

Установка пакетов из локальных файлов манифеста может быть связана с определенными рисками. Администратор должен включить эту функцию в качестве дополнительной меры предосторожности. Чтобы включить эту функцию, выполните winget settings --enable LocalManifestFiles. Чтобы отключить эту функцию, выполните winget settings --disable LocalManifestFiles.

Файлы журналов

Если файлы журналов для winget не перенаправлены, они будут находиться в следующей папке: %temp%\AICLI\*.log

Лицензионные соглашения

Некоторые приложения в начале установке потребуют от пользователя принять условия лицензии или других соглашений, прежде чем установка будет продолжена. В этом случае Диспетчер пакетов Windows предложит пользователю принять условия соглашений. Если пользователь не примет условия, приложение не будет установлено.

Image of agreement

В командной строке можно включить автоматическое принятие условий соглашений, передав в командной строке параметр --accept-package-agreements. Это может быть полезно при создании скрипта для Диспетчера пакетов Windows.