Поделиться через

команда pin (winget)

  • Статья

Команда pin-кода winget позволяет ограничить Диспетчер пакетов Windows от обновления пакета до определенных диапазонов версий или предотвратить обновление пакета в целом. Закрепленный пакет по-прежнему может обновляться самостоятельно и обновляться за пределами Диспетчер пакетов Windows.

Типы закреплений

WinGet поддерживает три типа закреплений пакетов:

  • Закрепление: пакет исключается, winget upgrade --all но разрешает winget upgrade <package>. Аргумент можно использовать --include-pinned для включения winget upgrade --all закрепленных пакетов.

  • Блокировка: пакет блокируется winget upgrade --all или winget upgrade <package>требуется открепить пакет, чтобы Разрешить WinGet выполнить обновление. Этот --force параметр можно использовать для переопределения поведения пин-кода.

  • Gating: пакет закрепляется в определенном диапазоне версий или версий. Вы можете указать точную версию, к которой нужно закрепить пакет или использовать подстановочный знак * в качестве последней части версии, чтобы указать диапазон версий. Например, если пакет закреплен на версию 1.2.*, любая версия между 1.2.0 ними 1.2.x считается допустимой. Этот --force параметр можно использовать для переопределения поведения пин-кода.

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

winget pin <subcommand> <options>

Параметры

Имеются следующие варианты.

Параметр Описание
-?, --help Позволяет получить дополнительную справку по этой команде.
--ждать Предложит пользователю нажать любой ключ перед выходом.
--logs,--open-logs Откройте расположение журналов по умолчанию.
--verbose, --verbose-logs Используется для переопределения параметра ведения журнала и создания подробного журнала.
--nowarn,--ignore-warnings Подавляет выходные данные предупреждений.
--disable-interactivity Отключите интерактивные запросы.
--доверенность Задайте для этого выполнения прокси-сервер.
--no-proxy Отключите использование прокси-сервера для этого выполнения.

Подкоманды

Команда пин-кода поддерживает следующие подкоманда.

Подкоманда Description
добавление Добавьте новый пин-код.
remove Удалите закрепление пакета.
список Вывод списка текущих закреплений.
reset; Сброс закреплений

add

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

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

winget pin add [[-q] <query>] [<options>]

Аргументы

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

Параметры

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

Вариант Описание
--id Ограничивает поиск приложением с определенным идентификатором.
--name Ограничивает поиск приложением с определенным именем.
--moniker Ограничивает поиск моникером, указанным для приложения.
--tag Ограничивает поиск тегом, перечисленным для приложения.
--cmd, --command Ограничивает поиск командой приложения.
-e, --exact Ищет точное совпадение со строкой в запросе, выполняя при этом проверку на учет регистра. Поведение по умолчанию для подстроки не используется.
-v, --version Позволяет указать точную версию для закрепления. Подстановочный знак * можно использовать в качестве последней части версии. Изменяет поведение закреплений gating.
-s, --source Ограничивает поиск источником с указанным именем. За этим параметром должно следовать имя источника.
--header Необязательный заголовок HTTP источника REST Windows-Package-Manager.
--authentication-mode Укажите предпочтения окна проверки подлинности (автоматическое, автоматическое или интерактивное).
--authentication-account Укажите учетную запись, используемую для проверки подлинности.
--accept-source-agreements Используется для принятия исходного лицензионного соглашения и позволяет избежать появления запроса.
--force Прямо выполните команду и продолжайте работу с проблемами, связанными с безопасностью.
--блокировка Блокировать обновление до удаления пин-кода, предотвращая переопределение аргументов. Изменяет поведение закреплений blocking.
--установленный Закрепление определенной установленной версии
-?, --help Позволяет получит дополнительную справку по этой команде.
--ждать Предложит пользователю нажать любой ключ перед выходом.
--logs, --open-logs Откройте расположение журналов по умолчанию.
--verbose, --verbose-logs Используется для переопределения параметра ведения журнала и создания подробного журнала.
--nowarn,--ignore-warnings Подавляет выходные данные предупреждений.
--disable-interactivity Отключите интерактивные запросы.
--доверенность Задайте для этого выполнения прокси-сервер.
--no-proxy Отключите использование прокси-сервера для этого выполнения.

Примеры

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

winget pin add powertoys

В следующем примере добавляется блокировка пин-кода для приложения с помощью его идентификатора. Добавление блокирующего пин-кода не позволит обновить этот пакет при вызове winget upgrade --all или winget upgrade <package>. Чтобы Разрешить WinGet выполнить обновление, необходимо разблокировать пакет.

winget pin add --id Microsoft.PowerToys --blocking

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

winget pin add --id Microsoft.PowerToys --version 0.70.*

remove

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

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

winget pin remove [[-q] <query>] [<options>]

Аргументы

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

Параметры

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

Вариант Описание
--id Ограничивает поиск приложением с определенным идентификатором.
--name Ограничивает поиск приложением с определенным именем.
--moniker Ограничивает поиск моникером, указанным для приложения.
-s, --source Ограничивает поиск источником с указанным именем. За этим параметром должно следовать имя источника.
--tag Ограничивает поиск тегом, перечисленным для приложения.
--cmd, --command Ограничивает поиск командой приложения.
-e, --exact Ищет точное совпадение со строкой в запросе, выполняя при этом проверку на учет регистра. Поведение по умолчанию для подстроки не используется.
--header Необязательный заголовок HTTP источника REST Windows-Package-Manager.
--authentication-mode Укажите предпочтения окна проверки подлинности (автоматическое, автоматическое или интерактивное).
--authentication-account Укажите учетную запись, используемую для проверки подлинности.
--accept-source-agreements Используется для принятия исходного лицензионного соглашения и позволяет избежать появления запроса.
--установленный Закрепление определенной установленной версии.
-?, --help Позволяет получит дополнительную справку по этой команде.
--ждать Предложит пользователю нажать любой ключ перед выходом.
--logs, --open-logs Откройте расположение журналов по умолчанию.
--verbose, --verbose-logs Используется для переопределения параметра ведения журнала и создания подробного журнала.
--nowarn,--ignore-warnings Подавляет выходные данные предупреждений.
--disable-interactivity Отключите интерактивные запросы.
--доверенность Задайте для этого выполнения прокси-сервер.
--no-proxy Отключите использование прокси-сервера для этого выполнения.

Примеры

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

winget pin remove powertoys

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

winget pin remove --id Microsoft.PowerToys

список

В подкомандах списка перечислены все текущие закрепления.

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

winget pin list [[-q] <query>] [<options>]

Аргументы

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

Параметры

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

Вариант Описание
--id Ограничивает поиск приложением с определенным идентификатором.
--name Ограничивает поиск приложением с определенным именем.
--moniker Ограничивает поиск моникером, указанным для приложения.
-s, --source Ограничивает поиск источником с указанным именем. За этим параметром должно следовать имя источника.
--tag Ограничивает поиск тегом, перечисленным для приложения.
--cmd, --command Ограничивает поиск командой приложения.
-e, --exact Ищет точное совпадение со строкой в запросе, выполняя при этом проверку на учет регистра. Поведение по умолчанию для подстроки не используется.
--header Необязательный заголовок HTTP источника REST Windows-Package-Manager.
--authentication-mode Укажите предпочтения окна проверки подлинности (автоматическое, автоматическое или интерактивное).
--authentication-account Укажите учетную запись, используемую для проверки подлинности.
--accept-source-agreements Используется для принятия исходного лицензионного соглашения и позволяет избежать появления запроса.
-?, --help Позволяет получит дополнительную справку по этой команде.
--ждать Предложит пользователю нажать любой ключ перед выходом.
--logs, --open-logs Откройте расположение журналов по умолчанию.
--verbose, --verbose-logs Используется для переопределения параметра ведения журнала и создания подробного журнала.
--nowarn,--ignore-warnings Подавляет выходные данные предупреждений.
--disable-interactivity Отключите интерактивные запросы.
--доверенность Задайте для этого выполнения прокси-сервер.
--no-proxy Отключите использование прокси-сервера для этого выполнения.

Примеры

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

winget pin list

В следующем примере перечислены определенные закрепление пакета.

winget pin list --id Microsoft.PowerToys

reset

Подкоманда сброса сбрасывает все закрепления.

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

Чтобы сбросить все закрепления, добавьте --force аргумент.

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

winget pin reset [<options>]

Параметры

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

Вариант Описание
--force Прямо выполните команду и продолжайте работу с проблемами, связанными с безопасностью.
-s, --source Ограничивает поиск источником с указанным именем. За этим параметром должно следовать имя источника.
-?, --help Позволяет получит дополнительную справку по этой команде.
--ждать Предложит пользователю нажать любой ключ перед выходом.
--logs, --open-logs Откройте расположение журналов по умолчанию.
--verbose, --verbose-logs Используется для переопределения параметра ведения журнала и создания подробного журнала.
--nowarn,--ignore-warnings Подавляет выходные данные предупреждений.
--disable-interactivity Отключите интерактивные запросы.
--доверенность Задайте для этого выполнения прокси-сервер.
--no-proxy Отключите использование прокси-сервера для этого выполнения.

Примеры

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

winget pin reset

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

winget pin reset --force