Partilhar via


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:

Captura de tela que mostra a ajuda para o comando de origem.

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.
--nowarn,--ignore-warnings Suprime as saídas de aviso.
--disable-interactivity Desabilitar prompts interativos.
--proxy Defina um proxy a ser usado para essa execução.
--no-proxy Desabilite o uso de proxy para essa execução.

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> [-a] <arg> [[-t] <type>] [<options>]

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
--trust-level Nível de confiança da origem (nenhum ou confiável).
--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.
--explicit
-?, --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.
--nowarn,--ignore-warnings Suprime as saídas de aviso.
--disable-interactivity Desabilitar prompts interativos.
--proxy Defina um proxy a ser usado para essa execução.
--no-proxy Desabilite o uso de proxy para essa execução.

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>] [<options>]

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.
--nowarn,--ignore-warnings Suprime as saídas de aviso.
--disable-interactivity Desabilitar prompts interativos.
--proxy Defina um proxy a ser usado para essa execução.
--no-proxy Desabilite o uso de proxy para essa execução.

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.

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.
--nowarn,--ignore-warnings Suprime as saídas de aviso.
--disable-interactivity Desabilitar prompts interativos.
--proxy Defina um proxy a ser usado para essa execução.
--no-proxy Desabilite o uso de proxy para essa execução.

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.

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.
--nowarn,--ignore-warnings Suprime as saídas de aviso.
--disable-interactivity Desabilitar prompts interativos.
--proxy Defina um proxy a ser usado para essa execução.
--no-proxy Desabilite o uso de proxy para essa execução.

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.

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
--force Força a redefinição das fontes.
-?, --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.
--nowarn,--ignore-warnings Suprime as saídas de aviso.
--disable-interactivity Desabilitar prompts interativos.
--proxy Defina um proxy a ser usado para essa execução.
--no-proxy Desabilite o uso de proxy para essa execução.

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.

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.
--nowarn,--ignore-warnings Suprime as saídas de aviso.
--disable-interactivity Desabilitar prompts interativos.
--proxy Defina um proxy a ser usado para essa execução.
--no-proxy Desabilite o uso de proxy para essa execução.

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.

Captura de tela que mostra um prompt de licença de origem.