Compartilhar via

Comando settings (WinGet)

O comando de configurações do WinGet permite personalizar sua experiência de cliente do Gerenciador de Pacotes do Windows. Você pode alterar os padrões e experimentar recursos experimentais que estão disponíveis em seu cliente.

O comando de configurações iniciará seu editor JSON padrão. O Windows, por padrão, iniciará o Bloco de Notas como uma opção. É recomendável usar uma ferramenta como Visual Studio Code.

Observação

Você pode instalar facilmente o Visual Studio Code digitando winget install Microsoft.VisualStudioCode

Apelidos

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

  • configuração

Subcomandos

Os sub-comandos a seguir estão disponíveis.

Subcomando Descrição
export Exporta configurações.
set Define o valor de uma configuração de administrador.
reset Redefine uma configuração de administrador para seu valor padrão.

Opções

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

Argumento Descrição
--habilitar Habilita a configuração de administrador especificada.
--desabilitar Desabilita a configuração de administrador especificada.
-?,--help Mostra a ajuda sobre o comando selecionado.
--esperar Solicita que o usuário pressione qualquer tecla antes de sair.
--logs,--open-logs Abre o diretório padrão de arquivos de log.
--verbose, --verbose-logs Habilite o registro em log detalhado WinGet.
--nowarn,--ignore-warnings Suprime as saídas de aviso.
--disable-interactivity Desabilita prompts interativos
--proxy Define um proxy a ser usado para essa execução.
--no-proxy Desabilita o uso de proxy para essa execução.

Usar o comando de configurações de winget

Inicie sua ferramenta de edição JSON padrão: winget settings

Quando você iniciar as configurações pela primeira vez, não haverá nenhuma configuração especificada. Na parte superior do arquivo JSON, fornecemos um link de Configurações da CLI do WinGet , no qual você pode descobrir os recursos e as configurações experimentais mais recentes.

O snippet de código abaixo mostra um exemplo de como seu arquivo de configurações pode ser com modificações de saída visual e recursos experimentais habilitados.

{
    "$schema": "https://aka.ms/winget-settings.schema.json",

    "visual": {
        "enableSixels": true,
        "progressBar": "rainbow"
    },
    "experimentalFeatures": {
        "experimentalARG": true,
        "experimentalCMD": true
    }
}

Também definimos um esquema para o arquivo de configurações. Isso permite que você use TAB para descobrir configurações e sintaxe se o editor JSON der suporte a esquemas JSON.

Atualizando configurações

As configurações a seguir estão disponíveis para a versão 1.11 do Gerenciador de Pacotes do Windows.

configurações de origem

As configurações de source incluem a configuração de origem do WinGet.

"source": {
    "autoUpdateIntervalInMinutes": 60
},

autoUpdateIntervalInMinutes

Um inteiro positivo representa o intervalo de atualização em minutos. A verificação de atualizações só acontece quando uma origem é usada. Um zero desabilitará a verificação de atualizações em uma fonte. Quaisquer outros valores são inválidos.

  • Desabilitar: 0
  • Padrão: 15

Para atualizar manualmente a fonte, use winget source update.

configurações visuais

As visual configurações envolvem elementos visuais exibidos pelo WinGet

"visual": {
    "enableSixels": true,
    "progressBar": "rainbow"
},

progressBar

Cor da barra de progresso exibida pelo WinGet quando não especificada por argumentos.

  • ênfase (padrão)
  • arco-íris
  • retrô
  • Sixel
  • desabilitado

anonimizarCaminhosExibidos

Substitui alguns caminhos de pasta conhecidos por suas respectivas variáveis de ambiente.

enableSizels

Habilita a saída de imagens sixel em determinados contextos.

configurações de registro em log

As logging configurações controlam o nível de detalhes nos arquivos de log. --verbose-logs substituirá essa configuração e sempre criará um log detalhado.

"logging": {
    "level": "verbose"
}

nível

Os níveis de log a seguir estão disponíveis. Padroniza-se como info se o valor não estiver definido ou for inválido.

  • detalhada
  • informação
  • aviso
  • erro
  • crítico

configurações de preferências e requisitos

Algumas das configurações são duplicadas em preferences e requirements.

  • A preferences configuração controla como as várias opções disponíveis são classificadas ao escolher aquela em que agir. Por exemplo, o escopo padrão das instalações de pacote é para o usuário atual, mas se essa não for uma opção, um instalador de nível de computador será escolhido.
  • A requirements configuração filtra as opções, resultando potencialmente em uma lista vazia e uma falha na instalação. No exemplo anterior, um requisito de escopo de usuário faria com que não haveria instaladores aplicáveis e ocorreria um erro.

Os argumentos passados na linha de comando substituirão de modo efetivo a configuração do requirement de correspondência durante esse comando.

escopo

O scope comportamento controla a opção entre instalar um pacote para o usuário atual ou para todo o computador. O parâmetro correspondente é --scopee usa os mesmos valores (user ou machine). Confira problemas conhecidos relacionados ao escopo de instalação do pacote.

"installBehavior": {
    "preferences": {
        "scope": "user"
    }
},

localidade

O locale comportamento controla a escolha do instalador com base na localidade do instalador. O parâmetro correspondente é --localee usa a marca de idioma bcp47.

"installBehavior": {
    "preferences": {
        "locale": [ "en-US", "fr-FR" ]
    }
},

arquiteturas

O architectures comportamento controla quais arquiteturas serão selecionadas ao instalar um pacote. O parâmetro correspondente é --architecture. Somente arquiteturas compatíveis com seu sistema podem ser selecionadas.

    "installBehavior": {
        "preferences": {
            "architectures": ["x64", "arm64"]
        }
    },

tiposDeInstalador

O installerTypes comportamento controla quais tipos de instalador serão selecionados ao instalar um pacote. O parâmetro correspondente é --installer-type.

    "installBehavior": {
        "preferences": {
            "installerTypes": ["msix", "msi"]
        }
    },

configurações de installBehavior

As installBehavior configurações controlam o comportamento padrão de instalação e atualização de pacotes (quando aplicável).

disableInstallNotes

A disableInstallNotes configuração determina se as notas de instalação são mostradas após uma instalação bem-sucedida. O padrão será false se o valor não for definido ou for inválido.

    "installBehavior": {
        "disableInstallNotes": true
    },

Configuração portablePackageUserRoot

A portablePackageUserRoot configuração define o diretório padrão raiz para instalação de pacotes dentro do escopo de User. Isso se aplica somente a pacotes com o portable tipo de instalador. O padrão será %LOCALAPPDATA%/Microsoft/WinGet/Packages/ se o valor não for definido ou for inválido.

Esse valor de configuração deve ser um caminho absoluto.

    "installBehavior": {
        "portablePackageUserRoot": "C:/Users/FooBar/Packages"
    },

Configuração do portablePackageMachineRoot

A configuração portablePackageMachineRoot define o diretório raiz padrão para instalação de pacotes no escopo Machine. Isso se aplica somente a pacotes com o portable tipo de instalador. Padroniza-se como %PROGRAMFILES%/WinGet/Packages/ se o valor não estiver definido ou for inválido.

Esse valor de configuração deve ser um caminho absoluto.

    "installBehavior": {
        "portablePackageMachineRoot": "C:/Program Files/Packages/Portable"
    },

defaultInstallRoot

A defaultInstallRoot configuração especifica o local de instalação padrão para pacotes que exigem um caminho de instalação explícito, se o local de instalação não for especificado.

maxResumes

A configuração maxResumes especifica o número máximo de tentativas de retomada permitidas para uma única ID de retomada. Isso impede reinicializações contínuas se uma instalação que exige uma reinicialização não for detectada corretamente.

método de extração de arquivo

A archiveExtractionMethod configuração controla como o instalador extrai arquivos. Os valores com suporte são shellApi e tar.

  • shellApi usa a API do Shell do Windows para extrair arquivos.

  • tar usa o comando tar para extrair arquivos.

UninstallBehavior

A uninstallBehavior configuração controla se o processo de desinstalação padrão remove todos os arquivos e diretórios relevantes para esse pacote. Aplica-se somente ao portátil installerType.

purgePortablePackage

A purgePortablePackage configuração controla o comportamento padrão para desinstalar um pacote portátil. Se definido como true, a desinstalação removerá todos os arquivos e diretórios relevantes ao pacote portable. Essa configuração só se aplica a pacotes com o instalador tipo portable. O padrão será false se o valor não for definido ou for inválido.

    "uninstallBehavior": {
        "purgePortablePackage": true
    },

Configurar Comportamento

A ConfigureBehavior configuração especifica o diretório raiz padrão ao qual os módulos do PowerShell são instalados ao aplicar uma configuração.

downloadBehavior

As downloadBehavior configurações controlam o diretório padrão para o qual os instaladores são baixados.

defaultDownloadDirectory

A defaultDownloadDirectory configuração controla o diretório padrão para o qual os pacotes são baixados. O padrão será %USERPROFILE%/Downloads se o valor não for definido ou for inválido.

Esse valor de configuração deve ser um caminho absoluto.

    "downloadBehavior": {
        "defaultDownloadDirectory": "C:/Users/FooBar/Downloads"
    },

Configurações de telemetria

As telemetry configurações controlam se o WinGet grava eventos ETW que podem ser enviados à Microsoft em uma instalação padrão do Windows.

Confira detalhes sobre dados telemétricos e nossa principal política de privacidade.

desabilitar

"telemetry": {
    "disable": true
},

Se definido como true, a telemetry.disable configuração impedirá que qualquer evento seja gravado pelo programa.

Configurações de rede

As network configurações influenciam como o WinGet usa a rede para recuperar pacotes e metadados.

ferramenta de download

A downloader configuração controla qual código é usado ao baixar pacotes. O padrão é do, que pode ser gerenciado pela Política de Grupo.

O wininet usa APIs do WinINet, enquanto o do usa o serviço de Otimização de Entrega.

"network": {
    "downloader": "wininet"
}

doProgressTimeoutInSeconds

O doProgressTimeoutInSeconds especifica o número de segundos a aguardar sem progresso antes da recuperação.

Interatividade

A Interactivity configuração controla se os prompts interativos são mostrados pelo cliente do Gerenciador de Pacotes do Windows.

Habilitando recursos experimentais

Para descobrir quais recursos experimentais estão disponíveis, acesse https://aka.ms/winget-settings onde você pode ver os recursos experimentais disponíveis para você.