pin команда (winget)

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

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

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

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

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

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

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

winget pin <subcommand> <options>

Параметры

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

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

Подкоманды

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

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

добавить

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

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

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

Аргументы

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

Параметры

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

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

Примеры

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

winget pin add powertoys

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

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

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

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

удалять

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

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

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

Аргументы

Аргумент	Описание
-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	Используется для принятия исходного лицензионного соглашения и позволяет избежать появления запроса.
--installed	Закрепление определенной установленной версии.
-?, --help	Позволяет получит дополнительную справку по этой команде.
--wait	Предложит пользователю нажать любой ключ перед выходом.
--logs, --open-logs	Откройте расположение журналов по умолчанию.
--verbose, --verbose-logs	Используется для переопределения параметра ведения журнала и создания подробного журнала.
--nowarn, --ignore-warnings	Подавляет выходные данные предупреждений.
--disable-interactivity	Отключите интерактивные запросы.
--proxy	Задайте для этого выполнения прокси-сервер.
--no-proxy	Отключите использование прокси-сервера для этого выполнения.

Примеры

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

winget pin remove powertoys

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

winget pin remove --id Microsoft.PowerToys

список

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

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

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

Аргументы

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

Примеры

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

winget pin list

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

winget pin list --id Microsoft.PowerToys

сброс

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

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

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

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

winget pin reset [<options>]

Параметры

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

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

Примеры

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

winget pin reset

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

winget pin reset --force