Команда upgrade (winget)

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

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

Псевдонимы

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

• обновить

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

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

Аргументы

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

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

Примечание.

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

Параметры

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

Вариант	Описание
-m, --manifest	За этим параметром должен следовать путь к файлу манифеста (YAML). Манифест можно использовать для запуска функции обновления из локального файла YAML.
--идентификатор	Ограничивает обновление до определенного идентификатора приложения.
--имя	Ограничивает поиск приложением с определенным именем.
--идентификатор	Ограничивает поиск моникером, указанным для приложения.
-v, --версия	Позволяет указать точную версию для обновления. Если параметр не задан, будет обновлено приложение с наибольшим номером версии.
-s, --source	Ограничивает поиск источником с указанным именем. За этим параметром должно следовать имя источника.
-e, --exact	Ищет точное совпадение со строкой в запросе, выполняя при этом проверку на учет регистра. Поведение по умолчанию подстроки не будет использоваться.
-i, --interactive	Запускает установщик в интерактивном режиме. Интерфейс по умолчанию показывает ход выполнения установщика.
-h, --тихий	Запускает установщик в тихом режиме. Блокирует весь пользовательский интерфейс. По умолчанию в интерфейсе отображается ход выполнения установщика.
--очистка	Удаляет все файлы и каталоги в каталоге пакета (переносимый)
-o, --log	Направляет логи в файл журнала. Необходимо указать путь к файлу, для которого у вас есть права на запись.
--пользовательский	Аргументы, передаваемые установщику в дополнение к значениям по умолчанию.
--переопределение	Строка, которая будет передана непосредственно инсталлятору.
-l, --местоположение	Расположение для обновления (если поддерживается).
--область	Выберите фильтр области установки пакета (для пользователя или компьютера).
a, --архитектура	Выбор архитектуры для установки.
--тип-установщика	Выберите тип установщика для обновления. См. поддерживаемые типы установщиков для клиента WinGet.
--локаль	Указывает используемую локаль (формат BCP47).
--ignore-security-hash (игнорировать контроль безопасности)	Игнорировать сбой проверки хэша установщика. Не рекомендуется.
--разрешить-перезагрузку	Разрешает перезагрузку, если применимо.
--skip-dependencies	Пропускает зависимости пакетов обработки и функции Windows.
--игнорировать-проверку-на-вредоносное ПО-в-локальном-архиве	Игнорировать сканирование вредоносных программ, выполняемое в рамках установки пакета типа архива из локального манифеста.
--принять-лицензионные-соглашения-на-пакеты	Используется для принятия лицензионного соглашения и позволяет избежать появления запроса.
--принять-исходные-соглашения	Используется для принятия исходного лицензионного соглашения и избегает появления запроса на подтверждение.
--заголовок	Необязательный HTTP-заголовок для источника REST Windows-Package-Manager.
--authentication-mode	Укажите предпочтения окна проверки подлинности (тихий, предпочтительно тихий или интерактивный).
--учетная запись аутентификации	Укажите учетную запись, используемую для проверки подлинности.
-r, --recurse, --all	Обновите все установленные пакеты до последней версии, если она доступна.
-u, --неизвестно, --включить-неизвестное	Обновляет пакеты, даже если их текущую версию невозможно определить.
--закрепленный,--включить-закрепленный	Обновление пакетов, даже если они имеют неблокирующий пин-код.
--удалить-предыдущий	Удалите предыдущую версию пакета во время обновления. Поведение зависит от отдельного пакета. Некоторые установщики предназначены для установки новых версий параллельно. Некоторые установщики включают манифест, указывающий "uninstallPrevious", поэтому более ранние версии удаляются без необходимости использовать этот флаг команды. В этом случае, используя winget upgrade --uninstall-previous команду, winGet удалит предыдущую версию независимо от того, что находится в манифесте пакета. Если манифест пакета не включает "uninstallPrevious" и флаг --uninstall-previous не используется, то поведение по умолчанию для установщика будет применено.
--сила	Выполните команду напрямую и продолжайте с вопросами, не связанными с безопасностью.
-?--Справка	Отображает справку по выбранной команде.
--ждать	Предложит пользователю нажать любой ключ перед выходом.
--logs,--open-logs	Откройте расположение журналов по умолчанию.
--подробно, --детальные-логи	Используется для переопределения параметра ведения журнала и создания подробного журнала.
--nowarn (без предупреждений),--ignore-warnings (игнорировать предупреждения)	Подавляет выходные данные предупреждений.
--отключить-интерактивность	Отключите интерактивные запросы.
--proxy	Задайте для этого выполнения прокси-сервер.
--no-proxy	Отключите использование прокси-сервера для этого выполнения.

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

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

winget upgrade

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

winget upgrade powertoys --version 0.15.2

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

winget upgrade --id Microsoft.PowerToys

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

winget upgrade --all

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

winget upgrade Microsoft.Edit Microsoft.NuGet

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

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

обновить --all

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

Примечание.

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

Примечание.

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

обновить --uninstall-previous

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

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