Compartilhar via

O comando de origem do WinGet

O comando de origem do WinGet permite que você gerencie fontes. Com o comando de origem , você pode adicionar, listar, atualizar, remover, redefinir ou exportar fontes do WinGet.

Uma fonte do WinGet fornece os dados para você descobrir e instalar aplicativos. Use apenas fontes confiáveis e seguras.

O WinGet especifica as três fontes padrão a seguir, que você pode listar usando winget source list.

  • msstore – o catálogo da Microsoft Store.
  • winget – O Repositório da Comunidade WinGet para aplicativos.
  • winget-font - O Repositório da Comunidade WinGet para fontes.

Uso

winget source <subcommand> <options>

Ajuda de origem do winget

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 fontes padrão msstore, winget e winget-font.
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.

Observação

Quando uma origem é definida como explícita, ela deve ser especificamente direcionada. A fonte de fonte winget é definida como explícita por padrão. Isso significa que qualquer outro comando WinGet deve referenciar diretamente a origem usando "--source winget-font" ou "-s winget-font" para ser incluído.

Uso:

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

Lista de origem do winget

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 de lista por si só winget source listfornece a lista completa de fontes configuradas:

Name        Argument                                      Explicit
------------------------------------------------------------------
msstore     https://storeedgefd.dsx.mp.microsoft.com/v9.0 false
winget      https://cdn.winget.microsoft.com/cache        false
winget-font https://cdn.winget.microsoft.com/fonts        true

listar detalhes da origem

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

winget source list --name winget

Retorna a seguinte saída:

Field       Value
--------------------------------------------------
Name        winget
Type        Microsoft.PreIndexed.Package
Argument    https://cdn.winget.microsoft.com/cache
Data        Microsoft.Winget.Source_8wekyb3d8bbwe
Identifier  Microsoft.Winget.Source_8wekyb3d8bbwe
Trust Level Trusted|StoreOrigin
Explicit    false
Updated     2025-12-11 08:30:25.000
  • Name é o nome da fonte.
  • Type é o tipo de origem.
  • 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 acordos apresentados antes de adicionar ou usar a origem. Se um usuário não aceitar os contratos, o WinGet não poderá acessar a origem.

Você pode usar a opção --accept-source-agreements para aceitar os contratos de origem e evitar o prompt.

Muitos comandos do WinGet avaliam todas as fontes configuradas. Se qualquer fonte configurada exigir contratos, o WinGet solicitará antes de usar essas fontes. Os contratos de origem são necessários para serem aceitos antes do uso. Se uma fonte atualizar os termos do contrato ou se uma fonte for removida e for adicionada novamente (como no caso de winget source reset --force) os contratos serão apresentados novamente.

Contrato de origem winget

  • Last updated on