команда 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>

Параметры

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

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

Подкоманды

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

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

добавить

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

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

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

Аргументы

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

Параметры

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

Параметр	Описание
--идентификатор	Ограничивает поиск приложением с определенным идентификатором.
--имя	Ограничивает поиск приложением с определенным именем.
--идентификатор	Ограничивает поиск моникером, указанным для приложения.
--тег	Ограничивает поиск тегом, перечисленным для приложения.
--команда, --командная строка	Ограничивает поиск командой приложения.
-e, --exact	Ищет точное совпадение со строкой в запросе, выполняя при этом проверку на учет регистра. Поведение по умолчанию для подстроки не используется.
-v, --версия	Позволяет указать точную версию для закрепления. Подстановочный знак * можно использовать в качестве последней части версии. Изменяет поведение закреплений gating.
-s, --source	Ограничивает поиск источником с указанным именем. За этим параметром должно следовать имя источника.
--заголовок	Необязательный заголовок HTTP источника REST Windows-Package-Manager.
--authentication-mode	Укажите предпочтения окна проверки подлинности (автоматическое, автоматическое или интерактивное).
--учетная запись аутентификации	Укажите учетную запись, используемую для проверки подлинности.
--принять-исходные-соглашения	Используется для принятия исходного лицензионного соглашения и позволяет избежать появления запроса.
--сила	Прямо выполните команду и продолжайте работу с проблемами, связанными с безопасностью.
--блокировка	Блокировать обновление до удаления пин-кода, предотвращая переопределение аргументов. Изменяет поведение закреплений blocking.
--установленный	Закрепление определенной установленной версии
-?--Справка	Позволяет получит дополнительную справку по этой команде.
--ждать	Предложит пользователю нажать любой ключ перед выходом.
--logs, --open-logs	Откройте расположение журналов по умолчанию.
--подробно, --детальные-логи	Используется для переопределения параметра ведения журнала и создания подробного журнала.
--nowarn (без предупреждений),--ignore-warnings (игнорировать предупреждения)	Подавляет выходные данные предупреждений.
--отключить-интерактивность	Отключите интерактивные запросы.
--доверенность	Задайте для этого выполнения прокси-сервер.
--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.*

удалять

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

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

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

Аргументы

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

Параметры

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

Параметр	Описание
--идентификатор	Ограничивает поиск приложением с определенным идентификатором.
--имя	Ограничивает поиск приложением с определенным именем.
--идентификатор	Ограничивает поиск моникером, указанным для приложения.
-s, --source	Ограничивает поиск источником с указанным именем. За этим параметром должно следовать имя источника.
--тег	Ограничивает поиск тегом, перечисленным для приложения.
--команда, --командная строка	Ограничивает поиск командой приложения.
-e, --exact	Ищет точное совпадение со строкой в запросе, выполняя при этом проверку на учет регистра. Поведение по умолчанию для подстроки не используется.
--заголовок	Необязательный заголовок HTTP источника REST Windows-Package-Manager.
--authentication-mode	Укажите предпочтения окна проверки подлинности (автоматическое, автоматическое или интерактивное).
--учетная запись аутентификации	Укажите учетную запись, используемую для проверки подлинности.
--принять-исходные-соглашения	Используется для принятия исходного лицензионного соглашения и позволяет избежать появления запроса.
--установленный	Закрепление определенной установленной версии.
-?--Справка	Позволяет получит дополнительную справку по этой команде.
--ждать	Предложит пользователю нажать любой ключ перед выходом.
--logs, --open-logs	Откройте расположение журналов по умолчанию.
--подробно, --детальные-логи	Используется для переопределения параметра ведения журнала и создания подробного журнала.
--nowarn (без предупреждений),--ignore-warnings (игнорировать предупреждения)	Подавляет выходные данные предупреждений.
--отключить-интерактивность	Отключите интерактивные запросы.
--доверенность	Задайте для этого выполнения прокси-сервер.
--no-proxy	Отключите использование прокси-сервера для этого выполнения.

Примеры

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

winget pin remove powertoys

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

winget pin remove --id Microsoft.PowerToys

список

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

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

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

Аргументы

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

Параметры

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

Параметр	Описание
--идентификатор	Ограничивает поиск приложением с определенным идентификатором.
--имя	Ограничивает поиск приложением с определенным именем.
--идентификатор	Ограничивает поиск моникером, указанным для приложения.
-s, --source	Ограничивает поиск источником с указанным именем. За этим параметром должно следовать имя источника.
--тег	Ограничивает поиск тегом, перечисленным для приложения.
--команда, --командная строка	Ограничивает поиск командой приложения.
-e, --exact	Ищет точное совпадение со строкой в запросе, выполняя при этом проверку на учет регистра. Поведение по умолчанию для подстроки не используется.
--заголовок	Необязательный заголовок HTTP источника REST Windows-Package-Manager.
--authentication-mode	Укажите предпочтения окна проверки подлинности (автоматическое, автоматическое или интерактивное).
--учетная запись аутентификации	Укажите учетную запись, используемую для проверки подлинности.
--принять-исходные-соглашения	Используется для принятия исходного лицензионного соглашения и позволяет избежать появления запроса.
-?--Справка	Позволяет получит дополнительную справку по этой команде.
--ждать	Предложит пользователю нажать любой ключ перед выходом.
--logs, --open-logs	Откройте расположение журналов по умолчанию.
--подробно, --детальные-логи	Используется для переопределения параметра ведения журнала и создания подробного журнала.
--nowarn (без предупреждений),--ignore-warnings (игнорировать предупреждения)	Подавляет выходные данные предупреждений.
--отключить-интерактивность	Отключите интерактивные запросы.
--доверенность	Задайте для этого выполнения прокси-сервер.
--no-proxy	Отключите использование прокси-сервера для этого выполнения.

Примеры

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

winget pin list

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

winget pin list --id Microsoft.PowerToys

сброс

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

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

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

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

winget pin reset [<options>]

Параметры

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

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

Примеры

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

winget pin reset

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

winget pin reset --force