O comando source do WinGet

O comando source da ferramenta WinGet permite que você gerencie as fontes do Gerenciador de Pacotes do Windows. Com o comando source, você pode adicionar, listar, atualizar, remover, redefinir ou exportar repositórios.

Um repositório de fontes fornece os dados para você descobrir e instalar aplicativos. Use apenas locais de fontes confiáveis e seguros.

O Gerenciador de Pacotes do Windows especifica os dois repositórios padrão a seguir, que você pode listar usando winget source list.

• msstore – o catálogo da Microsoft Store.
• winget – o repositório de aplicativos do Gerenciador de Pacotes do Windows.

Uso

winget source <subcommand> <options>

Argumentos

Os argumentos a seguir estão disponíveis.

A imagem a seguir mostra a ajuda do comando source:

Opções

As opções a seguir estão disponíveis.

Subcomandos

O comando source dá suporte aos subcomandos a seguir.

add

O subcomando add adiciona uma nova fonte. Esse subcomando exige as opções --name e --arg. Como o comando altera o acesso do usuário, o uso de add exige privilégios de administrador.

Uso:

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

Argumentos

Os argumentos a seguir estão disponíveis.

Opções

As opções a seguir estão disponíveis.

Por exemplo, winget source add --name Contoso https://www.contoso.com/cache adiciona o repositório Contoso à URL https://www.contoso.com/cache.

Parâmetro de tipo opcional

O subcomando add dá suporte ao parâmetro type opcional, que informa ao cliente a que tipo de repositório ele está se conectando. Há suporte para o tipo a seguir.

list

O subcomando list enumera as fontes habilitadas no momento ou fornece detalhes sobre uma fonte específica.

Uso:

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

Aliases

Os seguintes aliases estão disponíveis para este subcomando:

• ls

Argumentos

Os argumentos a seguir estão disponíveis.

Opções

As opções a seguir estão disponíveis.

list all

O subcomando list por si só, winget source list, fornece a lista completa de fontes com suporte:

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

list source details

Para obter detalhes completos sobre uma fonte, forneça o nome da origem. Por exemplo:

winget source list --name Contoso

Retorna a seguinte saída:

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 é o nome da fonte.
• Type é o tipo de repositório.
• Arg é a URL ou o caminho que a fonte usa.
• Data é o nome do pacote opcional usado, conforme o necessário.
• Updated é a data e hora da última atualização da fonte.

atualizar

O subcomando update força uma atualização de uma fonte individual ou de todas as fontes.

Uso:

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

Aliases

Os seguintes aliases estão disponíveis para este subcomando:

• refresh

Argumentos

Os argumentos a seguir estão disponíveis.

Opções

As opções a seguir estão disponíveis.

update all

O subcomando update por si só, winget source update, solicita atualizações de todos os repositórios.

atualizar origem

O subcomando update com a opção --name direciona uma atualização a uma fonte nomeada. Por exemplo: winget source update --name Contoso força uma atualização do repositório Contoso.

remover

O subcomando remove remove uma fonte. Esse subcomando exige a opção --name para identificar a fonte. Como o comando altera o acesso do usuário, o uso de remove exige privilégios de administrador.

Uso:

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

Aliases

Os seguintes aliases estão disponíveis para este subcomando:

• rm

Argumentos

Os argumentos a seguir estão disponíveis.

Opções

As opções a seguir estão disponíveis.

Exemplos

winget source remove --name Contoso

Esse comando remove o repositório Contoso.

reset

O subcomando reset redefine o cliente para a configuração original e remove todas as fontes, exceto a padrão. Use esse subcomando apenas em casos raros. Como o comando altera o acesso do usuário, o uso de reset exige privilégios de administrador.

Como o comando reset remove todas as fontes, você precisa forçar a ação usando a opção --force.

Uso:

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

Argumentos

Os argumentos a seguir estão disponíveis.

Opções

As opções a seguir estão disponíveis.

exportar

O subcomando export permite exportar os detalhes específicos de uma fonte para uma saída JSON.

Uso:

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

Argumentos

Os argumentos a seguir estão disponíveis.

Opções

As opções a seguir estão disponíveis.

Exemplos

winget source export winget

Retorna a seguinte saída:

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

Contrato de fonte

Uma fonte individual pode solicitar que o usuário concorde com os termos apresentados antes de adicionar ou usar o repositório. Se o usuário não aceitar nem reconhecer o contrato, ele não poderá acessar a fonte.

Você pode usar a opção --accept-source-agreements para aceitar o contrato de licença da fonte e evitar o prompt.

Tópicos relacionados

• Usar a ferramenta winget para instalar e gerenciar aplicativos