Compartilhar via


comando configure (winget)

O comando configure da ferramenta winget usa um arquivo de Configuração do WinGet para começar a configurar seu computador Windows para um estado de ambiente de desenvolvimento desejado.

Aviso

Não execute um arquivo de Configuração do WinGet sem antes examinar o conteúdo do arquivo e verificar a credibilidade dos recursos relacionados. Confira Como verificar a confiabilidade de um arquivo de Configuração do WinGet.

Pré-requisitos

  • Windows 10 versão 1809 (build 17763) ou posterior, ou Windows 11.
  • Versão do WinGet v1.6.2631 ou posterior.

Apelidos

Os aliases a seguir estão disponíveis para este comando:

  • configuração
  • dsc

Uso

winget configure -f <C:/Users/<username>/winget-configs/config-file-name.dsc.winget>

Depois de identificar o arquivo de configuração do WinGet que você está interessado em usar, confirmou a segurança e a confiabilidade desse arquivo e baixou o arquivo para o computador local, você pode usar o winget configure comando para iniciar a configuração da configuração.

Captura de tela listando as opções de comando de configuração do winget.

Argumentos e opções

Os seguintes argumentos estão disponíveis:

Argumento Descrição
-f,--file O caminho para o arquivo de configuração winget.
--module-path Especifica o local do computador para armazenar módulos. Padrão %LOCALAPPDATA%\Microsoft\WinGet\Configuration\Modules.
--processor-path Especifica o caminho para o processador de configuração.
-h,--history Selecione itens do histórico.
--accept-configuration-agreements Aceita o aviso de configuração, impedindo um prompt interativo.
--suppress-initial-details Suprimir mostrando os detalhes iniciais da configuração quando possível.
--enable Habilitar componentes de configuração. Requer acesso à loja.
--disable Desabilite os componentes de configuração. Requer acesso à loja.
-?--Ajuda Mostra a ajuda sobre o comando selecionado.
--wait Solicita que o usuário pressione qualquer tecla antes de sair.
--logs,--open-logs Abra o local de logs padrão.
--verbose,--verbose-logs Habilite o registro em log detalhado WinGet.
--nowarn,--ignore-warnings Suprime as saídas de aviso.
--disable-interactivity Desabilitar avisos interativos.
--proxy Defina um proxy a ser usado para essa execução.
--no-proxy Desabilite o uso de proxy para essa execução.

configurar subcomandos

O winget configure comando inclui vários subcomandos, incluindo:

  • winget configure show: exibe os detalhes de um arquivo de configuração. Uso: winget configure show -f <file>. Executando o comando: winget configuration show configuration.dsc.yaml exibirá os detalhes da configuração no diretório de trabalho atual.
  • winget configure list: mostra os detalhes de alto nível das configurações que foram aplicadas ao sistema. Esses dados podem ser usados com outros configure comandos para obter mais detalhes. Uso: winget configure list [<options>]
  • winget configure test: verifica o sistema em relação ao estado desejado, exibindo se o estado atual do sistema está em conformidade com o estado desejado definido no arquivo de configuração associado. Uso: winget configure test -f <file>.
  • winget configure validate: valida um arquivo de configuração. Uso: winget configure validate [-f] <file> [<options>].
  • winget configure export: exporta recursos de configuração para um arquivo de configuração. Quando usado com --all, exporta todas as configurações de pacote. Quando usado com --packageId, exporta um recurso WinGetPackage do identificador de pacote fornecido. Quando usado com --module e --resource, exporta as configurações do recurso especificado. Se o arquivo de configuração de saída já existir, acrescentará os recursos de configuração exportados. Uso: winget configure export -o <output file> [<options>]