Partilhar via

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.

Observação

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

Apelidos

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

  • Configurações

Subcomandos

Os seguintes subcomandos estão disponíveis.

Sub-Command Descrição
exportação Configurações de exportação.
definido Define o valor de uma configuração de administrador.
redefinir Redefine uma configuração de administrador para seu valor padrão.

Opções

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

Argumento Descrição
--ativar Habilita a configuração de administrador especificada.
--desativar Desabilita a configuração de administrador especificada.
-?,--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 Abre a localização padrão dos registos.
--Verbose,--Verbose-Logs Permite o registo detalhado do winget.
--nowarn,--ignore-avisos Suprime mensagens de aviso.
--desabilitar-interatividade Desativa prompts interativos.
--proxy Define um proxy a ser usado para essa execução.
--sem procuração Desabilita o uso de proxy para essa execução.

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 seguintes definições estão disponíveis para a versão 1.28 do Gestor 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.

ativarSixels

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

channels

A channels definição restringe a saída de log a canais de log específicos. Valores default especiais (o conjunto padrão de canais) e all (todos os canais) também são aceites. Os valores inválidos são ignorados.

"logging": {
    "channels": ["default"]
}

ficheiro

As file definições controlam a limpeza automática dos ficheiros de registo no diretório de registo predefinido. A limpeza é executada no início de cada processo WinGet e aplica-se apenas ao diretório padrão dos logs.

Configuração Descrição Predefinido
ageLimitInDays Idade máxima em dias dos ficheiros no diretório de registo; ficheiros antigos são apagados. Defina de 0 para desativar. 7
totalSizeLimitInMB Tamanho total máximo em megabytes de todos os ficheiros no diretório de log; Os ficheiros mais antigos são apagados primeiro. Defina para 0 para desativar. 128
countLimit Número máximo de ficheiros no diretório de log; Os ficheiros mais antigos são apagados primeiro. Para desativar, defina para 0. 0 (desativado)
individualSizeLimitInMB Tamanho máximo em megabytes de um único ficheiro de log. Se um ficheiro ultrapassar este limite, os registos são reiniciados. Defina para 0 para desativar. 16 
"logging": {
    "level": "verbose",
    "file": {
        "ageLimitInDays": 7,
        "totalSizeLimitInMB": 128,
        "countLimit": 0,
        "individualSizeLimitInMB": 16
    }
}

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 afeta que tipos de instaladores serão selecionados ao instalar um pacote. Também pode determinar qual tipo instalar por defeito se um manifesto tiver vários tipos: a lista está por ordem de prioridade, sendo o primeiro tipo listado preferido em relação aos outros, e assim sucessivamente. Isto é conveniente para utilizadores que, por exemplo, preferem pacotes portáteis ou instalações MSIX/AppX. O parâmetro de correspondência é --installer-type, que irá sobrepor as definições.

Os valores permitidos na versão 1.12.470 incluem: appx, burn, exefont, , innomsi, msix, msstore, nullsoftportablewixzip

Por defeito, e com todas as outras propriedades iguais, o WinGet utiliza por defeito o tipo de instalador que está listado primeiro no YAML do instalador do manifesto, caso o pacote ainda não tenha sido instalado. Se já estiver instalado, será necessário o mesmo tipo de instalador para garantir uma atualização adequada.

    "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ê.

As experimentalFeatures definições envolvem a configuração destas funcionalidades "experimentais". Funcionalidades individuais podem ser ativadas neste nó:

"experimentalFeatures": {
    "directMSI": true,
    "resume": true
}

directMSI

Esta funcionalidade permite ao Gestor de Pacotes do Windows instalar diretamente pacotes MSI com as APIs MSI em vez de através do msiexec. Note que, quando a instalação silenciosa é usada, isto já está em vigor, pois os pacotes MSI que exigem elevação falham nesse cenário sem ela.

"experimentalFeatures": {
    "directMSI": true
}

retomar

Esta funcionalidade permite que alguns comandos retomem após um reinício.

"experimentalFeatures": {
    "resume": true
}

Fontes

Esta funcionalidade permite suporte para fontes via winget settings. O comando winget font list irá listar as famílias de fontes instaladas e o número de faces de letras instaladas.

"experimentalFeatures": {
    "fonts": true
}

sourcePriority

Esta funcionalidade permite que as fontes tenham um valor de prioridade atribuído. Fontes com prioridade superior aparecerão mais cedo nos resultados de pesquisa e serão selecionadas para instalar novos pacotes quando múltiplas fontes tiverem um pacote correspondente.

Note que a ordenação dos resultados de pesquisa depende de vários fatores, sendo que a prioridade da fonte é atualmente o fator menos importante. A qualidade da correspondência e o tipo de campo são considerados mais relevantes.

"experimentalFeatures": {
    "sourcePriority": true
}
  • Last updated on