Команда install (winget)
Команда install программы winget устанавливает указанное приложение. Чтобы указать приложение, которое нужно установить, используйте команду search.
Для команды install необходимо указать точную строку для установки. В случае какой-либо неоднозначности вам будет предложено дополнительно отфильтровать команду install для уточнения приложения.
Использование
winget install [[-q] <query> ...] [<options>]
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 | Пропустить сбой проверки хэша установщика. Не рекомендуется. |
| --allow-reboot | Разрешает перезагрузку, если применимо. |
| --skip-dependencies | Пропускает зависимости пакетов обработки и функции Windows. |
| --ignore-local-archive-malware-scan | Игнорировать сканирование вредоносных программ, выполняемое в рамках установки пакета типа архива из локального манифеста. |
| --dependency-source | Найдите зависимости пакета с помощью указанного источника. |
| --accept-package-agreements | Используется для принятия лицензионного соглашения и позволяет избежать появления запроса. |
| --no-upgrade | Пропускает обновление, если установленная версия уже существует. |
| --header | Необязательный заголовок HTTP источника REST Windows-Package-Manager. |
| --authentication-mode | Укажите предпочтения окна проверки подлинности (автоматическое, автоматическое или интерактивное). |
| --authentication-account | Укажите учетную запись, используемую для проверки подлинности. |
| --accept-source-agreements | Используется для принятия исходного лицензионного соглашения и позволяет избежать появления запроса. |
| -r, --rename | Значение для переименования исполняемого файла (переносимого). |
| --uninstall-previous | Удалите предыдущую версию пакета во время обновления. |
| --force | Прямо выполните команду и продолжайте работу с проблемами, связанными с безопасностью. |
| -?, --help | Позволяет получит дополнительную справку по этой команде. |
| --ждать | Предложит пользователю нажать любой ключ перед выходом. |
| --logs,--open-logs | Откройте расположение журналов по умолчанию. |
| --verbose, --verbose-logs | Используется для переопределения параметра ведения журнала и создания подробного журнала. |
| --nowarn,--ignore-warnings | Подавляет выходные данные предупреждений. |
| --disable-interactivity | Отключите интерактивные запросы. |
| --доверенность | Задайте для этого выполнения прокси-сервер. |
| --no-proxy | Отключите использование прокси-сервера для этого выполнения. |
Примеры запросов
В следующем примере устанавливается определенная версия приложения.
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 предложит пользователю принять условия соглашений. Если пользователь не примет условия, приложение не будет установлено.
В командной строке можно включить автоматическое принятие условий соглашений, передав в командной строке параметр --accept-package-agreements. Это может быть полезно при создании скрипта для Диспетчера пакетов Windows.
См. также
Windows developer