O comando source do WinGet

O comando de origem do WinGet permite que você gerencie fontes para o 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>

Sub-Commands

Os argumentos a seguir estão disponíveis.

Sub-Command	Descrição
adicionar	Adiciona uma nova fonte.
lista	Lista as fontes atuais.
atualizar	Atualiza as fontes atuais.
remover	Remove as fontes atuais.
redefinir	Redefine o winget e o msstore de fontes padrão.
exportar	Exportar fontes atuais.

Opções

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

Opção	Descrição
-?,--ajuda	Mostra a ajuda sobre o comando selecionado.
--esperar	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.
--desativar-interatividade	Desabilitar prompts interativos.
--procuração	Defina um proxy a ser usado para essa execução.
--sem proxy	Desabilite o uso de proxy para essa execução.

adicionar

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, --tipo	O tipo de fonte.

Opções

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

Opção	Descrição
--nível de confiança	Nível de confiança da origem (nenhum ou confiável).
--cabeçalho	O cabeçalho HTTP de origem REST opcional Windows-Package-Manager.
--aceitar-acordos-de-origem	Usado para aceitar o contrato de licença de origem e evitar o prompt.
--explícito
-?, --ajuda	Obtêm ajuda adicional sobre esse comando.
--esperar	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.
--desativar-interatividade	Desabilitar prompts interativos.
--procuração	Defina um proxy a ser usado para essa execução.
--sem 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. Os tipos a seguir são suportados.

Tipo	Descrição
Microsoft.PreIndexed.Package	O tipo de fonte padrão.
Microsoft.Rest	Uma fonte da API REST da Microsoft.

lista

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

Uso:

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

Apelidos

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

• É

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
-?, --ajuda	Obtêm ajuda adicional sobre esse comando.
--esperar	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.
--desativar-interatividade	Desabilitar prompts interativos.
--procuração	Defina um proxy a ser usado para essa execução.
--sem proxy	Desabilite o uso de proxy para essa execução.

listar todos

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

listar detalhes da origem

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.

atualização

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

Uso:

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

Apelidos

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

• atualizar

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
-?, --ajuda	Obtêm ajuda adicional sobre esse comando.
--esperar	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.
--desativar-interatividade	Desabilitar prompts interativos.
--procuração	Defina um proxy a ser usado para essa execução.
--sem proxy	Desabilite o uso de proxy para essa execução.

atualizar tudo

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

Apelidos

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

• comando '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
-?, --ajuda	Obtêm ajuda adicional sobre esse comando.
--esperar	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.
--desativar-interatividade	Desabilitar prompts interativos.
--procuração	Defina um proxy a ser usado para essa execução.
--sem proxy	Desabilite o uso de proxy para essa execução.

Exemplos

winget source remove --name Contoso

Esse comando remove o repositório Contoso.

redefinir

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
--força	Força a redefinição das fontes.
-?, --ajuda	Obtêm ajuda adicional sobre esse comando.
--esperar	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.
--desativar-interatividade	Desabilitar prompts interativos.
--procuração	Defina um proxy a ser usado para essa execução.
--sem 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. Isso é útil para configurar a Política de Grupo para o gerenciamento de origem.

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
-?, --ajuda	Obtêm ajuda adicional sobre esse comando.
--esperar	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.
--desativar-interatividade	Desabilitar prompts interativos.
--procuração	Defina um proxy a ser usado para essa execução.
--sem proxy	Desabilite o uso de proxy para essa execução.

Exemplos

winget source export winget

Retorna a seguinte saída:

{"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"}

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