settings Comando (winget)

O comando settings de WinGet permite-lhe personalizar a sua experiência Windows Gestor de Pacotes cliente. Você pode alterar os padrões e experimentar os recursos experimentais disponíveis em seu cliente.

O settings comando vai lançar o 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:

• config

Subcomandos

Os seguintes subcomandos estão disponíveis.

Opções

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

Usa o wingetsettings comando

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

Quando iniciar o settings pela primeira vez, não haverá nenhum settings especificado. No topo do ficheiro JSON, disponibilizamos uma ligação para Definições da CLI do WinGet, onde pode descobrir as funcionalidades experimentais mais recentes disponíveis e settings.

O excerto de código abaixo mostra um exemplo de como o seu settings ficheiro poderá parecer com modificações visuais de saída e funcionalidades experimentais ativadas.

{
    "$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 settings ficheiro. Isto permite-lhe usar o TAB para descobrir settings e sintaxe se o seu editor JSON suportar esquemas JSON.

Atualização settings

Os seguintes settings estão disponíveis para a versão 1.28 do Windows Gestor de Pacotes.

fonte settings

source settings envolvem a configuração da origem do 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 .

visual settings

Os visualsettings são elementos visuais apresentados 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.

registo settings

Os loggingsettings controlam o nível de detalhe nos ficheiros 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

Os filesettings controlam a limpeza automática dos ficheiros de registo no diretório de registos predefinido. A limpeza é executada no início de cada processo WinGet e aplica-se apenas ao diretório padrão dos logs.

"logging": {
    "level": "verbose",
    "file": {
        "ageLimitInDays": 7,
        "totalSizeLimitInMB": 128,
        "countLimit": 0,
        "individualSizeLimitInMB": 16
    }
}

Preferências e requisitos settings

Alguns dos settings estão duplicados 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 o settings.

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"]
        }
    },

installBehavior settings

Controlam installBehaviorsettings o comportamento padrão da 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 é 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

Os downloadBehaviorsettings controlam o diretório predefinido para onde os instaladores são transferidos.

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"
    },

Telemetria settings

O telemetrysettings controla se o WinGet escreve eventos ETW que podem ser enviados para Microsoft numa instalação padrão de 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.

Rede settings

A networksettings influência sobre 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 as funcionalidades experimentais disponíveis, visite https://aka.ms/wingethttps://aka.ms/winget-settings onde pode ver as funcionalidades experimentais disponíveis.

As experimentalFeaturessettings 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
}