O comando WinGet source

O wingetsource comando permite que você gerencie fontes. Com o source comando, você pode add, edit, , list, update, remove, resetou export fontes 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>

Sub-Commands

Os argumentos a seguir estão disponíveis.

Sub-Command	Descrição
add	Adiciona um novo source.
edit	Edita um existente source.
list	Lista as fontes atuais.
update	Atualiza as fontes atuais.
remove	Remove as fontes atuais.
reset	Redefine as fontes padrão msstorewinget e winget-font.
export	Exportar fontes atuais.

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.

adicionar

O add subcomando adiciona um novo source. Esse subcomando requer o e --name as --arg opções. Como o comando altera o acesso do usuário, o uso add requer 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, --type	O tipo de source.

Opções

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

Opção	Descrição
--trust-level	Nível de confiança do source (nenhum ou confiável).
--header	Cabeçalho HTTP Windows-Package-Manager REST source opcional.
--accept-source-agreements	Usado para aceitar o source contrato de licença e evitar o prompt.
--explicit	Marca como source explícito, exigindo comandos para direcioná-lo diretamente usando --source.
-?, --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 add subcomando dá suporte ao parâmetro de tipo opcional, que informa ao cliente a qual 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 edit subcomando 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
--explicit	Define como source explícito (true) ou implícito (false). Quando explícitos, os comandos devem direcionar diretamente o source uso --source.
--header	Cabeçalho HTTP Windows-Package-Manager REST source opcional.
--accept-source-agreements	Usado para aceitar o source contrato de licença 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.
--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.

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 list subcomando 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 --source winget-font ou -s winget-font ser incluído.

Uso:

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

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
-?, --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.

listar todos

O list subcomando 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 update subcomando 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
-?, --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.

atualizar tudo

O update subcomando por si só solicita winget source updateatualizações para todos os repositórios.

Atualização source

O update subcomando 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 remove 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 remove requer 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
-?, --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.

redefinir

O reset subcomando redefine o cliente de volta à configuração original e remove todas as fontes, exceto o padrão. Use esse subcomando apenas em casos raros. Como o comando altera o acesso do usuário, o uso reset requer privilégios de administrador.

Como o reset comando remove todas as fontes, você deve 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
--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 export sub-comando 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
-?, --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://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-source-agreements 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.

Tópicos relacionados

• Usar a winget ferramenta para instalar e gerenciar aplicativos