comando de configurações (winget)

O comando settings do WinGet permite que você personalize sua experiência de cliente do Gerenciador de Pacotes do Windows. Você pode alterar os padrões e experimentar os recursos experimentais disponíveis em seu cliente.

O comando settings iniciará seu editor JSON padrão. O Windows, por padrão, iniciará o Bloco de Notas como uma opção. Recomendamos o uso de uma ferramenta como o Visual Studio Code.

Apelidos

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

• Configurações

Subcomandos

Os seguintes subcomandos estão disponíveis.

Opções

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

Utilize o comando winget settings

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

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

O trecho de código abaixo mostra um exemplo de como seu arquivo de configurações pode parecer 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. Permite-lhe usar a tecla TAB para descobrir definições e sintaxe JSON se o seu editor JSON suportar 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 source envolvem a configuração da fonte WinGet.

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

intervaloDeAtualizaçãoAutomáticaEmMinutos

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

• Desativar: 0
• Padrão: 15

Para atualizar manualmente o código-fonte, use winget source updateo .

configurações visuais

As visual configurações envolvem elementos visuais que são exibidos pelo WinGet

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

barra de progresso

Cor da barra de progresso que o WinGet exibe quando não especificado por argumentos.

• acento (padrão)
• arco-íris
• Retrô
• Sixel
• desactivado

anonimizarCaminhosExibidos

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

habilitarSizels

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

configurações de log

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

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

nível

Os seguintes níveis de log estão disponíveis. O padrão é info se o valor não estiver definido ou for inválido.

• verboso
• 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 pacotes é para o usuário atual, mas se isso não for uma opção, um instalador no nível da máquina será escolhido.
• A requirements configuração filtra as opções, potencialmente resultando em uma lista vazia e uma falha na instalação. No exemplo anterior, um requisito de âmbito do utilizador resultaria na ausência de instaladores aplicáveis e num erro.

Todos os argumentos passados na linha de comandos irão efetivamente substituir a configuração correspondente de requirement durante a execução desse comando.

âmbito

O scope comportamento controla a escolha entre instalar um pacote para o usuário atual ou para toda a máquina. O parâmetro correspondente é --scope, e usa os mesmos valores (user ou machine). Consulte os problemas conhecidos relacionados ao escopo de instalação do pacote.

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

região

O locale comportamento controla a escolha do instalador com base na localidade do instalador. O parâmetro correspondente é --locale, e 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. Apenas arquiteturas compatíveis com o seu sistema podem ser selecionadas.

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

tipos de instaladores

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 comportamento de instalação

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

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 é false se o valor não estiver definido ou for inválido.

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

configuração portablePackageUserRoot

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

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

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

configuração portablePackageMachineRoot

A portablePackageMachineRoot configuração define o diretório raiz padrão para instalar pacotes sob o Machine escopo. Isso se aplica apenas a pacotes com o portable tipo de instalador. O padrão é %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.

maxReinícios

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

método de extração de arquivo

A archiveExtractionMethod configuração controla como o instalador extrai arquivos. Os valores suportados 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 este pacote. Aplica-se apenas 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 para o portable pacote. Essa configuração só se aplica a pacotes com o portable tipo de instalador. O padrão é false se o valor não estiver definido ou for inválido.

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

ConfigurarComportamento

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

baixarComportamento

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

diretório padrão de download

A defaultDownloadDirectory configuração controla o diretório padrão para o qual os pacotes são baixados. O padrão é %USERPROFILE%/Downloads se o valor não estiver 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.

Consulte detalhes sobre telemetriae a nossa declaração principal de privacidade .

desactivar

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

Se definida 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.

Gestor de downloads

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

usa o WinINet APIs, enquanto usa o serviço Delivery Optimization.

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

doProgressTimeoutInSeconds

O doProgressTimeoutInSeconds especifica o número de segundos a aguardar sem progresso antes do fallback.

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, vá para https://aka.ms/winget-settings onde você pode ver os recursos experimentais disponíveis para você.