Partilhar via


O comando de origem WinGet

O comando WinGetsource permite-lhe gerir fontes. Com o comando source , pode adicionar, listar, atualizar, remover, reiniciar ou exportar fontes WinGet.

Uma fonte WinGet fornece os dados para que possa descobrir e instalar aplicações. Use apenas fontes seguras e de confiança.

O WinGet especifica as seguintes três fontes por defeito, que pode listar usando winget source list.

  • msstore - O catálogo da Microsoft Store.
  • winget - O Repositório Comunitário WinGet para aplicações.
  • winget-font - O Repositório Comunitário WinGet para fontes.

Utilização

winget source <subcommand> <options>

Ajuda com a fonte do winget

Sub-Commands

Estão disponíveis os seguintes argumentos.

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 Reinicia as fontes padrão msstore, winget e winget-font.
exportação Exporta fontes atuais.

Opções

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

Opção Descrição
-?,--ajuda Mostra a ajuda sobre o comando selecionado.
--aguarde Solicita que o usuário pressione qualquer tecla antes de sair.
pt-PT: --logs,--open-logs Abra o local de logs padrão.
--detalhado, --registos-detalhados Usado para anular a configuração de registo e criar um registo detalhado.
--nowarn,--ignore-avisos Suprime mensagens de aviso.
--desabilitar-interatividade Desative os prompts interativos.
--procuração Defina um proxy a ser usado para essa execução.
--sem procuração Desative o uso de proxy para esta execução.

adicionar

O adicionar subcomando adiciona uma nova fonte. Este subcomando requer as opções --name e --arg. Como o comando altera o acesso do usuário, usar adicionar requer privilégios de administrador.

Utilização:

winget source add [-n] <name> [-a] <arg> [[-t] <type>] [<options>]

Argumentos

Estão disponíveis os seguintes argumentos.

Argumento Descrição
-n, --nome O nome pelo qual identificar a fonte.
-a, --arg O URL ou UNC da fonte.
-t, --tipo O tipo de fonte.

Opções

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

Opção Descrição
--nível de confiança Nível de confiança da fonte (nenhum ou confiável).
--cabeçalho Cabeçalho HTTP de origem REST opcional para Windows-Package-Manager.
--aceitar-acordos-de-fonte Usado para aceitar o contrato de licença original e evitar o aviso.
--explícito
-?, --ajuda Obtenha ajuda adicional sobre este comando.
--aguarde Solicita que o usuário pressione qualquer tecla antes de sair.
pt-PT: --logs,--open-logs Abra o local de logs padrão.
--detalhado, --registos-detalhados Usado para anular a configuração de registo e criar um registo detalhado.
--nowarn,--ignore-avisos Suprime mensagens de aviso.
--desabilitar-interatividade Desative os prompts interativos.
--procuração Defina um proxy a ser usado para essa execução.
--sem procuração Desative o uso de proxy para esta execução.

Por exemplo, winget source add --name Contoso https://www.contoso.com/cache adiciona o repositório da Contoso em URL https://www.contoso.com/cache.

Parâmetro de tipo opcional

O subcomando add suporta o parâmetro opcional type, que informa ao cliente a que tipo de repositório ele está se conectando. Os seguintes tipos são suportados.

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

lista

O subcomando lista enumera as fontes atualmente habilitadas ou fornece detalhes sobre uma fonte específica.

Observação

Quando uma fonte é definida para ser explícita, deve ser especificamente direcionada. A fonte winget está definida como explícita por defeito. Isto significa que quaisquer outros comandos WinGet devem referenciar diretamente a fonte, incluindo "--source winget-font" ou "-s winget-font".

Utilização:

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

Lista de fontes do winget

Apelidos

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

  • ls

Argumentos

Estão disponíveis os seguintes argumentos.

Argumento Descrição
-n, --nome O nome pelo qual identificar a fonte.

Opções

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

Opção Descrição
-?, --ajuda Obtenha ajuda adicional sobre este comando.
--aguarde Solicita que o usuário pressione qualquer tecla antes de sair.
pt-PT: --logs,--open-logs Abra o local de logs padrão.
--detalhado, --registos-detalhados Usado para anular a configuração de registo e criar um registo detalhado.
--nowarn,--ignore-avisos Suprime mensagens de aviso.
--desabilitar-interatividade Desative os prompts interativos.
--procuração Defina um proxy a ser usado para essa execução.
--sem procuração Desative o uso de proxy para esta execução.

listar tudo

O subcomando list por si só, winget source list, fornece 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 fonte da lista

Para obter detalhes completos sobre uma fonte, passe o nome da fonte. 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 fonte.
  • Arg é o URL ou caminho que a fonte usa.
  • Data é o nome do pacote opcional, se apropriado.
  • Updated é a última data e hora em que a fonte foi atualizada.

actualização

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

Utilização:

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

Apelidos

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

  • actualizar

Argumentos

Estão disponíveis os seguintes argumentos.

Argumento Descrição
-n, --nome O nome pelo qual identificar a fonte.

Opções

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

Opção Descrição
-?, --ajuda Obtenha ajuda adicional sobre este comando.
--aguarde Solicita que o usuário pressione qualquer tecla antes de sair.
pt-PT: --logs,--open-logs Abra o local de logs padrão.
--detalhado, --registos-detalhados Usado para anular a configuração de registo e criar um registo detalhado.
--nowarn,--ignore-avisos Suprime mensagens de aviso.
--desabilitar-interatividade Desative os prompts interativos.
--procuração Defina um proxy a ser usado para essa execução.
--sem procuração Desative o uso de proxy para esta execução.

atualizar tudo

O atualização subcomando por si só, winget source update, solicita atualizações para todos os repositórios.

atualizar fonte

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

remover

O remover subcomando remove uma fonte. Este subcomando requer a opção --name para identificar a origem. Como o comando altera o acesso do usuário, usar remover requer privilégios de administrador.

Utilização:

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

Apelidos

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

  • RM

Argumentos

Estão disponíveis os seguintes argumentos.

Argumento Descrição
-n, --nome O nome pelo qual identificar a fonte.

Opções

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

Opção Descrição
-?, --ajuda Obtenha ajuda adicional sobre este comando.
--aguarde Solicita que o usuário pressione qualquer tecla antes de sair.
pt-PT: --logs,--open-logs Abra o local de logs padrão.
--detalhado, --registos-detalhados Usado para anular a configuração de registo e criar um registo detalhado.
--nowarn,--ignore-avisos Suprime mensagens de aviso.
--desabilitar-interatividade Desative os prompts interativos.
--procuração Defina um proxy a ser usado para essa execução.
--sem procuração Desative o uso de proxy para esta execução.

Exemplos

winget source remove --name Contoso

Este comando remove o repositório da Contoso.

redefinir

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

Como o comando reset remove todas as fontes, você deve forçar a ação usando a opção --force.

Utilização:

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

Argumentos

Estão disponíveis os seguintes argumentos.

Argumento Descrição
-n, --nome O nome pelo qual identificar a fonte.

Opções

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

Opção Descrição
--força Força a redefinição das fontes.
-?, --ajuda Obtenha ajuda adicional sobre este comando.
--aguarde Solicita que o usuário pressione qualquer tecla antes de sair.
pt-PT: --logs,--open-logs Abra o local de logs padrão.
--detalhado, --registos-detalhados Usado para anular a configuração de registo e criar um registo detalhado.
--nowarn,--ignore-avisos Suprime mensagens de aviso.
--desabilitar-interatividade Desative os prompts interativos.
--procuração Defina um proxy a ser usado para essa execução.
--sem procuração Desative o uso de proxy para esta execução.

exportar

O subcomando export exporta os detalhes específicos de uma origem para a saída JSON. Isso é útil para configurar a Diretiva de Grupo para gerenciamento de código-fonte.

Utilização:

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

Argumentos

Estão disponíveis os seguintes argumentos.

Argumento Descrição
-n, --nome O nome pelo qual identificar a fonte.

Opções

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

Opção Descrição
-?, --ajuda Obtenha ajuda adicional sobre este comando.
--aguarde Solicita que o usuário pressione qualquer tecla antes de sair.
pt-PT: --logs,--open-logs Abra o local de logs padrão.
--detalhado, --registos-detalhados Usado para anular a configuração de registo e criar um registo detalhado.
--nowarn,--ignore-avisos Suprime mensagens de aviso.
--desabilitar-interatividade Desative os prompts interativos.
--procuração Defina um proxy a ser usado para essa execução.
--sem procuração Desative o uso de proxy para esta 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"}

Acordo de origem

Uma fonte individual pode pedir que o utilizador concorde com acordos apresentados antes de adicionar ou usar a fonte. Se um utilizador não aceitar os acordos, o WinGet não poderá aceder à fonte.

Podes usar a opção --acceptar-acordos-fonte-para aceitar os acordos de origem e evitar o prompt.

Muitos comandos WinGet avaliam todas as fontes configuradas. Se qualquer fonte configurada exigir acordos, o WinGet irá solicitar antes de usar essas fontes. Os acordos de origem devem ser aceites antes do uso. Se uma fonte atualiza os termos do acordo, ou se uma fonte for removida e readicionada (como no caso de winget source reset --force), os acordos serão apresentados novamente.

Acordo de Fonte Winget