O comando WinGet source

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

Um WinGet source 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>

wingetsource Ajuda

Sub-Commands

Os argumentos a seguir estão disponíveis.

Sub-Command Descrição
adicionar Adiciona um novo source.
edit Edita um existente source.
lista Lista as fontes atuais.
atualizar Atualiza as fontes atuais.
remover Remove as fontes atuais.
redefinir Redefine as fontes padrão msstorewinget 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 adicionar adiciona um novo source. 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 a ser identificado source por.
-a, --arg A URL ou UNC do source.
-t, --tipo O tipo de source.

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 do source (nenhum ou confiável).
--cabeçalho Cabeçalho HTTP Windows-Package-Manager REST source opcional.
--accept-agreementssource Usado para aceitar o source contrato de licença e evitar o prompt.
--explícito Marca como source explícito, exigindo comandos para direcioná-lo diretamente usando --source.
-?, --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 padrão source .
Microsoft.Rest Uma API REST Microsoft source.

edição

O subcomando editar modifica uma configuração existente source. O uso primário é alternar se um source é explícito ou implícito. Quando um source é explícito, os comandos do WinGet devem direcioná-lo diretamente usando --source. Quando um source está implícito, ele é incluído em todos os comandos automaticamente.

Uso:

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

Argumentos

Os argumentos a seguir estão disponíveis.

Argumento Descrição
-n, --name O nome da source edição a ser editada.

Opções

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

Opção Descrição
--explícito Define como source explícito (true) ou implícito (false). Quando explícitos, os comandos devem direcionar diretamente o source uso --source.
--cabeçalho Cabeçalho HTTP Windows-Package-Manager REST source opcional.
--accept-agreementssource Usado para aceitar o source contrato de licença e evitar o prompt.
-?, --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.

Exemplo

A wingetfontesource -é explícita por padrão, o que significa que os comandos devem direcioná-la diretamente usando --source winget-font. Para redefini-lo para o estado padrão (implícito) para que ele seja incluído em todos os comandos do WinGet automaticamente, execute:

winget source edit winget-font --explicit false

Para definir um source como explícito:

winget source edit winget-font --explicit true

lista

O subcomando de lista enumera as fontes atualmente habilitadas ou fornece detalhes sobre um determinado source.

Observação

Quando um source é definido como explícito, ele deve ser especificamente direcionado. A wingetfontesource -é definida como explícita por padrão. Isso significa que qualquer outro comando WinGet deve referenciar diretamente o source uso de "--sourcewinget-font" ou "-s-font winget" para ser incluído.

Uso:

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

wingetsource Lista

Apelidos

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 a ser identificado source por.

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

detalhes da lista source

Para obter detalhes completos sobre um source, passe o nome do source. 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 do source.
  • Type é o tipo de source.
  • Arg é a URL ou o caminho usado source .
  • Data é o nome do pacote opcional usado, conforme o necessário.
  • Updated é a última data e hora em que a source atualização foi atualizada.

atualização

O subcomando de atualização força uma atualização para um indivíduo sourceou para todas as fontes.

Uso:

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

Apelidos

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 a ser identificado source por.

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.

Atualização source

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

remover

O subcomando remove um source. Esse subcomando requer a opção --name para identificar o source. 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:

  • rm

Argumentos

Os argumentos a seguir estão disponíveis.

Argumento Descrição
-n, --name O nome a ser identificado source por.

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 a ser identificado source por.

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 subconjunto de exportação exporta os detalhes específicos para uma source saída JSON. Isso é útil para configurar a Política de Grupo para source gerenciamento.

Uso:

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

Argumentos

Os argumentos a seguir estão disponíveis.

Argumento Descrição
-n, --name O nome a ser identificado source por.

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

Um indivíduo source pode solicitar que o usuário concorde com os acordos apresentados antes de adicionar ou usar o source. Se um usuário não aceitar os contratos, o WinGet não poderá acessar o source.

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

Muitos comandos do WinGet avaliam todas as fontes configuradas. Se qualquer configurado source 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 um source contrato atualizar os termos ou se um source for removido e adicionado novamente (como no caso de winget source reset --force) os contratos serão apresentados novamente.

wingetsource Acordo

  • Last updated on