Команда winget source

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

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

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

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

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

winget source <subcommand> <options>

Аргументы

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

Аргумент	Description
-?, --help	Позволяет получить дополнительную справку по этой команде.

На следующем изображении показана справка для команды source:

Параметры

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

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

Подкоманды

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

Подкоманда	Description
добавление	Добавляет новый источник.
список	Перечисляет список активных источников.
обновить	Обновляет источник.
remove	Удаляет источник.
reset;	Сбрасывает winget и msstore до начальной конфигурации.
Экспорт	Экспортирует текущие источники.

add

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

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

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

Аргументы

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

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

Параметры

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

Параметр	Описание
--header	Необязательный заголовок HTTP источника REST Windows-Package-Manager.
--accept-source-agreements	Используется для принятия исходного лицензионного соглашения и позволяет избежать появления запроса.
-?, --help	Позволяет получит дополнительную справку по этой команде.
--Подожди	Предложит пользователю нажать любой ключ перед выходом.
--logs,--open-logs	Откройте расположение журналов по умолчанию.
--verbose, --verbose-logs	Используется для переопределения параметра ведения журнала и создания подробного журнала.
--disable-interactivity	Отключите интерактивные запросы.

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

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

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

Тип	Описание
Microsoft.PreIndexed.Package	Тип источника по умолчанию.

список

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

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

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

Aliases

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

• ls

Аргументы

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

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

Параметры

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

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

list all

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

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

list source details

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

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] <name>]

Aliases

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

• refresh

Аргументы

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

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

Параметры

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

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

update all

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

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

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

remove

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

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

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

Aliases

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

• rm

Аргументы

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

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

Параметры

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

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

Примеры

winget source remove --name Contoso

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

reset

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

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

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

winget source reset --force

Аргументы

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

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

Параметры

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

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

экспорт

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

Аргументы

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

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

Параметры

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

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

Примеры

winget source export winget

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

{"Arg":"https://winget.azureedge.net/cache","Data":"Microsoft.Winget.Source_8wekyb3d8bbwe","Identifier":"Microsoft.Winget.Source_8wekyb3d8bbwe","Name":"winget","Type":"Microsoft.PreIndexed.Package"}

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

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

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

См. также

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