upgrade команда (winget)

Команда upgrade средства winget обновляет указанное приложение. При необходимости можно использовать команду list, чтобы указать приложение, которое вы хотите upgrade.

Команда upgrade требует указать точную строку в upgrade. Если есть неоднозначность, вам будет предложено дополнительно отфильтровать upgrade команду до точного приложения.

Псевдонимы

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

• update

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

winget upgrade [[-q] <query> ...] [<options>]

Изображение аргументов команды Снимок экрана с вводом команды в командной строке Терминал Windows.

Аргументы

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

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

Примечание.

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

Параметры

Эти параметры позволяют настроить upgrade интерфейс в соответствии с вашими потребностями.

Вариант	Описание
-m, --manifest	За этим параметром должен следовать путь к файлу манифеста (YAML). С помощью манифеста можно запустить upgrade среду из локального YAML-файла.
--id	Ограничивает upgrade идентификатором приложения.
--name	Ограничивает поиск приложением с определенным именем.
--moniker	Ограничивает поиск моникером, указанным для приложения.
-v, --version	Позволяет указать точную версию для upgrade. Если не указано иное, latest будет upgrade приложение с самой высокой версией.
-s, --source	Ограничивает поиск источником с указанным именем. За этим параметром должно следовать имя источника.
-e, --exact	Ищет точное совпадение со строкой в запросе, выполняя при этом проверку на учет регистра. Поведение по умолчанию подстроки не будет использоваться.
-i, --interactive	Запускает установщик в интерактивном режиме. Интерфейс по умолчанию показывает ход выполнения установщика.
-h, --silent	Запускает установщик в тихом режиме. Блокирует весь пользовательский интерфейс. Интерфейс по умолчанию показывает ход выполнения установщика.
--purge	Удаляет все файлы и каталоги в каталоге пакета (переносимый)
-o, --log	Направляет логи в файл журнала. Необходимо указать путь к файлу, для которого у вас есть права на запись.
--custom	Аргументы, передаваемые установщику в дополнение к значениям по умолчанию.
--override	Строка, которая будет передана непосредственно инсталлятору.
-l, --location	Расположение в upgrade (если поддерживается).
--scope	Выберите фильтр области установки пакета (для пользователя или компьютера).
-a, --architecture	Выбор архитектуры для установки.
--installer-type	Выберите тип upgradeустановщика. См. поддерживаемые типы установщиков для клиента WinGet.
--locale	Указывает используемую локаль (формат BCP47).
--ignore-security-hash	Игнорировать сбой проверки хэша установщика. Не рекомендуется.
--allow-reboot	Разрешает перезагрузку, если применимо.
--skip-dependencies	Пропускает зависимости пакетов обработки и функции Windows.
--ignore-local-archive-malware-scan	Игнорировать сканирование вредоносных программ, выполняемое в рамках установки пакета типа архива из локального манифеста.
--accept-package-agreements	Используется для принятия лицензионного соглашения и позволяет избежать появления запроса.
--accept-source-agreements	Используется для принятия исходного лицензионного соглашения и избегает появления запроса на подтверждение.
--header	Необязательный HTTP-заголовок для источника REST Windows-Package-Manager.
--authentication-mode	Укажите предпочтения окна проверки подлинности (тихий, предпочтительно тихий или интерактивный).
--authentication-account	Укажите учетную запись, используемую для проверки подлинности.
-r, --recurse, --all	Обновите все установленные пакеты до последней версии, если она доступна.
-u, --unknown, --include-unknown	Обновляет пакеты, даже если их текущую версию невозможно определить.
--pinned, --include-pinned	Обновление пакетов, даже если они имеют неблокирующий пин-код.
--uninstall-previous	Удалите предыдущую версию пакета при upgrade. Поведение зависит от отдельного пакета. Некоторые установщики предназначены для установки новых версий параллельно. Некоторые установщики включают манифест, указывающий "uninstallPrevious", поэтому более ранние версии удаляются без необходимости использовать этот флаг команды. В этом случае, используя winget upgrade --uninstall-previous команду, winGet удалит предыдущую версию независимо от того, что находится в манифесте пакета. Если манифест пакета не содержит "uninstallPrevious" и --uninstall-previous флаг не используется, то будет применено поведение по умолчанию для установщика.
--force	Выполните команду напрямую и продолжайте с вопросами, не связанными с безопасностью.
-?, --help	Отображает справку по выбранной команде.
--wait	Предложит пользователю нажать любой ключ перед выходом.
--logs, --open-logs	Откройте расположение журналов по умолчанию.
--verbose, --verbose-logs	Используется для переопределения параметра ведения журнала и создания подробного журнала.
--nowarn, --ignore-warnings	Подавляет выходные данные предупреждений.
--disable-interactivity	Отключите интерактивные запросы.
--proxy	Задайте для этого выполнения прокси-сервер.
--no-proxy	Отключите использование прокси-сервера для этого выполнения.

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

В следующем примере перечислены приложения, для которых доступен upgrade.

winget upgrade

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

winget upgrade powertoys --version 0.15.2

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

winget upgrade --id Microsoft.PowerToys

В следующем примере показано обновление всех приложений.

winget upgrade --all

В следующем примере будет upgrade несколько приложений.

winget upgrade Microsoft.Edit Microsoft.NuGet

С использованием upgrade

Чтобы определить, какие приложения требуются update, просто используйте upgrade без каких-либо аргументов для отображения всех доступных обновлений.

upgrade --all

upgrade --all все upgrade установленные приложения, для которых доступно update. При запуске winget upgrade --allWindows диспетчер пакетов ищет все приложения с доступными обновлениями и пытается установить обновления. Сначала используйте upgrade без каких-либо аргументов, чтобы предварительно посмотреть, какие приложения будут обновлены.

Примечание.

Некоторые приложения не предоставляют версию. Они всегда актуальны. Поскольку Windows диспетчер пакетов не может определить, существует ли более новая версия приложения, upgrade будет невозможно, если не указан параметр -u, --unknown, --include-unknown

Примечание.

Некоторые приложения могут быть закреплены с помощью WinGet и не будут обновлены, если указан параметр --all, если только не указан также параметр --include-pinned. В этом случае будут обновлены только неблокирующие пин-коды приложений.

upgrade --uninstall-previous

upgrade --uninstall-previous Удалите предыдущую версию перед установкой более новой версии пакета. При использовании --uninstall-previousповедение будет зависеть от отдельного пакета. Некоторые установщики предназначены для установки новых версий рядом с существующими, а другие включают манифест, в котором uninstallPrevious указано как поведение upgrade по умолчанию (поэтому более ранние версии удаляются без использования флага командной строки).

Если в манифесте пакета не указано uninstallPrevious в качестве поведения upgrade и флаг --uninstall-previous не используется с командой upgrade, то будет применяться поведение установщика по умолчанию.