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.

Argumento	Descrição
-?, --help	Obtém ajuda adicional sobre esse comando.

A imagem a seguir mostra a ajuda do comando source:

Opções

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

Opção	Descrição
-?,--help	Mostra a ajuda sobre o comando selecionado.
--wait	Solicita que o usuário pressione qualquer tecla antes de sair.
--logs,--open-logs	Abre o local de logs padrão.
--verbose, --verbose-logs	Usado para substituir a configuração de registro em log e criar um log detalhado.
--disable-interactivity	Desabilitar prompts interativos.

Subcomandos

O comando source dá suporte aos subcomandos a seguir.

Subcomando	Descrição
add	Adiciona uma nova fonte.
list	Enumera a lista de fontes habilitadas.
update	Atualiza uma fonte.
remove	Remove uma fonte.
reset	Redefine winget e msstore para a configuração inicial.
export	Exportar fontes atuais.

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] <name> [-a, --arg] <url> [[-t, --type] <type>]

Argumentos

Os argumentos a seguir estão disponíveis.

Argumento	Descrição
-n, --name	O nome pelo qual identificar a fonte.
-a, --arg	A URL ou o UNC da fonte.
-t, --type	O tipo de fonte.

Opções

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

Opção	Descrição
--header	O cabeçalho HTTP de origem REST opcional Windows-Package-Manager.
--accept-source-agreements	Usado para aceitar o contrato de licença de origem e evitar o prompt.
-?, --help	Obtêm ajuda adicional sobre esse comando.
--wait	Solicita que o usuário pressione qualquer tecla antes de sair.
--logs,--open-logs	Abre o local de logs padrão.
--verbose, --verbose-logs	Usado para substituir a configuração de registro em log e criar um log detalhado.
--disable-interactivity	Desabilitar prompts interativos.

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.

Tipo	Descrição
Microsoft.PreIndexed.Package	O tipo de fonte padrão.

list

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

Uso:

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

Aliases

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

• ls

Argumentos

Os argumentos a seguir estão disponíveis.

Argumento	Descrição
-n, --name	O nome pelo qual identificar a fonte.

Opções

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

Opção	Descrição
-?, --help	Obtêm ajuda adicional sobre esse comando.
--wait	Solicita que o usuário pressione qualquer tecla antes de sair.
--logs,--open-logs	Abre o local de logs padrão.
--verbose, --verbose-logs	Usado para substituir a configuração de registro em log e criar um log detalhado.
--disable-interactivity	Desabilitar prompts interativos.

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

Aliases

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

• refresh

Argumentos

Os argumentos a seguir estão disponíveis.

Argumento	Descrição
-n, --name	O nome pelo qual identificar a fonte.

Opções

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

Opção	Descrição
-?, --help	Obtêm ajuda adicional sobre esse comando.
--wait	Solicita que o usuário pressione qualquer tecla antes de sair.
--logs,--open-logs	Abre o local de logs padrão.
--verbose, --verbose-logs	Usado para substituir a configuração de registro em log e criar um log detalhado.
--disable-interactivity	Desabilitar prompts interativos.

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

Aliases

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

• rm

Argumentos

Os argumentos a seguir estão disponíveis.

Argumento	Descrição
-n, --name	O nome pelo qual identificar a fonte.

Opções

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

Opção	Descrição
-?, --help	Obtêm ajuda adicional sobre esse comando.
--wait	Solicita que o usuário pressione qualquer tecla antes de sair.
--logs,--open-logs	Abre o local de logs padrão.
--verbose, --verbose-logs	Usado para substituir a configuração de registro em log e criar um log detalhado.
--disable-interactivity	Desabilitar prompts interativos.

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 --force

Argumentos

Os argumentos a seguir estão disponíveis.

Argumento	Descrição
-n, --name	O nome pelo qual identificar a fonte.

Opções

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

Opção	Descrição
-?, --help	Obtêm ajuda adicional sobre esse comando.
--wait	Solicita que o usuário pressione qualquer tecla antes de sair.
--logs,--open-logs	Abre o local de logs padrão.
--verbose, --verbose-logs	Usado para substituir a configuração de registro em log e criar um log detalhado.
--disable-interactivity	Desabilitar prompts interativos.

exportar

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

Argumentos

Os argumentos a seguir estão disponíveis.

Argumento	Descrição
-n, --name	O nome pelo qual identificar a fonte.

Opções

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

Opção	Descrição
-?, --help	Obtêm ajuda adicional sobre esse comando.
--wait	Solicita que o usuário pressione qualquer tecla antes de sair.
--logs,--open-logs	Abre o local de logs padrão.
--verbose, --verbose-logs	Usado para substituir a configuração de registro em log e criar um log detalhado.
--disable-interactivity	Desabilitar prompts interativos.

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