Команда winget source

Команда источникаWinGet позволяет управлять источниками для диспетчера пакетов Windows. С помощью команды source можно добавлять, перечислять, обновлять, удалять, сбрасывать или экспортировать репозитории.

Исходный репозиторий предоставляет данные для обнаружения и установки приложений. Используйте только безопасные и надежные исходные расположения.

Диспетчер пакетов Windows указывает следующие два репозитория по умолчанию, которые можно перечислить с помощью winget source list.

• msstore — каталог Microsoft Store.
• winget — репозиторий приложений в Диспетчере пакетов Windows.

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

winget source <subcommand> <options>

Sub-Commands

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

Sub-Command	Описание
добавление	Добавляет новый источник.
список	Выводит список текущих источников.
обновить	Обновляет текущие источники.
удалить	Удаляет текущие источники.
reset;	Сбрасывает источники по умолчанию winget и msstore.
Экспорт	Экспортирует текущие источники.

Параметры

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

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

добавить

Вложенная подкоманда add добавляет новый источник. Для этой подкоманды требуются параметры --name и --arg. Команда add изменяет разрешения на доступ пользователя, поэтому для ее использования требуются права администратора.

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

winget source add [-n] <name> [-a] <arg> [[-t] <type>] [<options>]

Аргументы

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

Аргумент	Описание
-n, --имя	Имя, по которому определяется источник.
-a, --arg	URL-адрес или UNC-путь источника.
-t, --тип	Тип источника .

Параметры

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

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

Например, winget source add --name Contoso https://www.contoso.com/cache добавляет репозиторий Contoso по URL-адресу https://www.contoso.com/cache.

Необязательный параметр type

Подкоманда add поддерживает необязательный параметр type, который сообщает клиенту тип репозитория, к которому он подключается. Поддерживаются следующие типы.

Тип	Описание
Microsoft.PreIndexed.Package	Тип источника по умолчанию.
Microsoft.Rest	Источник REST API Майкрософт.

список

Подкоманда list перечисляет включенные источники или предоставляет сведения о конкретном источнике.

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

winget source list [[-n] <name>] [<options>]

Псевдонимы

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

• ЛС

Аргументы

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

Аргумент	Описание
-n, --имя	Имя, по которому определяется источник.

Параметры

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

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

список всех

Сама по себе подкоманда list (winget source list) выводит полный список поддерживаемых источников.

Name   Arg
-----------------------------------------
winget https://winget.azureedge.net/cache

список сведений об источнике

Чтобы получить полные сведения об источнике, передайте его имя. Например:

winget source list --name Contoso

Возвращает следующие выходные данные:

Name   : Contoso
Type   : Microsoft.PreIndexed.Package
Arg    : https://pkgmgr-int.azureedge.net/cache
Data   : AppInstallerSQLiteIndex-int_g4ype1skzj3jy
Updated: 2020-4-14 17:45:32.000

• Name — имя источника.
• Type — тип репозитория.
• Arg — URL-адрес или путь, который использует источник.
• Data — необязательное имя пакета, используемое при необходимости.
• Updated — дата и время последнего обновления источника.

обновить

Подкоманда update принудительно начинает обновление отдельного источника или всех источников.

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

winget source update [[-n] <name>] [<options>]

Псевдонимы

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

• освежать

Аргументы

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

Аргумент	Описание
-n, --имя	Имя, по которому определяется источник.

Параметры

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

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

обновление всех

Сама по себе подкоманда update (winget source update) запрашивает обновления для всех репозиториев.

Источник обновления

Подкоманда update с параметром --name направляет обновление в именованный источник. Например, winget source update --name Contoso принудительно начинает обновление репозитория Contoso.

удалять

Подкоманда remove удаляет источник. Для указания источника этой подкоманде требуется параметр --name. Команда remove изменяет разрешения на доступ пользователя, поэтому для ее использования требуются права администратора.

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

winget source remove [-n] <name> [<options>]

Псевдонимы

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

• rm

Аргументы

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

Аргумент	Описание
-n, --имя	Имя, по которому определяется источник.

Параметры

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

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

Примеры

winget source remove --name Contoso

Эта команда удаляет репозиторий Contoso.

сброс

Подкоманда reset восстанавливает исходную конфигурацию клиента и удаляет все источники, кроме источников по умолчанию. Используйте эту подкоманда только в редких случаях. Команда reset изменяет разрешения на доступ пользователя, поэтому для ее использования требуются права администратора.

Так как команда reset удаляет все источники, необходимо принудительно выполнить это действие с помощью аргумента --force.

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

winget source reset [[-n] <name>] [<options>]

Аргументы

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

Аргумент	Описание
-n, --имя	Имя, по которому определяется источник.

Параметры

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

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

экспорт

Подкоманда export экспортирует определенные сведения об источнике в выходные данные JSON. Это полезно для настройки групповой политики для управления источниками.

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

winget source export [[-n] <name>] [<options>]

Аргументы

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

Аргумент	Описание
-n, --имя	Имя, по которому определяется источник.

Параметры

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

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

Примеры

winget source export winget

Возвращает следующие выходные данные:

{"Arg":"https://cdn.winget.microsoft.com/cache","Data":"Microsoft.Winget.Source_8wekyb3d8bbwe","Explicit":false,"Identifier":"Microsoft.Winget.Source_8wekyb3d8bbwe","Name":"winget","TrustLevel":["Trusted","StoreOrigin"],"Type":"Microsoft.PreIndexed.Package"}

Соглашение источника

Отдельный источник может запросить согласие пользователя с представленными условиями перед добавлением или использованием репозитория. Если пользователь не принимает условия соглашения или не подтверждает согласие, он не сможет получить доступ к источнику.

Вы можете воспользоваться параметром --accept-source-agreements, чтобы принять лицензионное соглашение источника и отменить появление запроса.

См. также

• Использование программы winget для установки приложений и управления ими