settings comando (winget)

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

O settings comando 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.

Apelidos

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

• config

Subcomandos

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

Opções

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

Use o comando wingetsettings

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

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

O snippet de código abaixo mostra um exemplo de como seu settings arquivo 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 settings arquivo. Isso permite que você use TAB para descobrir settings e sintaxe se o editor JSON der suporte a esquemas JSON.

Atualização settings

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

Fonte settings

Os sourcesettings envolvem a configuração da 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.

visual settings

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

Ativar enableSixels

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

registro settings

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

channels

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

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

arquivo

file settings controlam a limpeza automática dos arquivos de log no diretório de log padrão. A limpeza é executada no início de cada processo do WinGet e se aplica apenas ao local de log padrão.

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

preferências e requisitos settings

Alguns dos settings sã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 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 afeta quais tipos de instalador serão selecionados ao instalar um pacote. Ele também pode determinar qual tipo instalar por padrão se um manifesto tiver vários tipos: a lista está em ordem de prioridade, com o primeiro tipo listado sendo preferencial em relação aos outros e assim por diante. Isso é conveniente para usuários que, por exemplo, preferem pacotes portáteis ou instalações MSIX/AppX. O parâmetro correspondente é --installer-type, que substituirá o settings.

Os valores permitidos a partir da versão 1.12.470 incluem: appx, , burn, exe, font, inno, msi, msix, , msstore, nullsoft, , portable, , wix, zip

Por padrão, e com todas as outras propriedades sendo iguais, o WinGet usa como padrão o tipo de instalador listado primeiro no YAML do instalador do manifesto se o pacote ainda não tiver sido instalado. Se ele já estiver instalado, o mesmo tipo de instalador será necessário para garantir uma atualização adequada.

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

installBehavior settings

Os installBehaviorsettings controlam o comportamento padrão ao instalar e atualizar 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 portablePackageMachineRoot configuração define o diretório padrão raiz para instalação de pacotes dentro do escopo de 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

Os downloadBehaviorsettings controlam o diretório padrão onde 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"
    },

Telemetria settings

O telemetrysettings determina 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.

Rede settings

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

experimentalFeatures settings envolvem a configuração desses recursos "experimentais". Os recursos individuais podem ser habilitados neste nó:

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

directMSI

Esse recurso permite que o Gerenciador de Pacotes do Windows instale diretamente pacotes MSI com as APIs MSI em vez de por meio do msiexec. Observe que quando a instalação silenciosa é usada, isso já está em vigor, pois os pacotes MSI que exigem elevação falharão nesse cenário sem ele.

"experimentalFeatures": {
    "directMSI": true
}

continuar

Esse recurso permite que o suporte para alguns comandos seja retomado após uma reinicialização.

"experimentalFeatures": {
    "resume": true
}

Fontes

Esse recurso habilita o suporte para fontes por meio de winget settings. O winget font list comando listará as famílias de fontes instaladas e o número de faces de fonte instaladas.

"experimentalFeatures": {
    "fonts": true
}

PrioridadeFonte

Esse recurso permite que as fontes tenham um valor de prioridade atribuído. Fontes com prioridade mais alta aparecerão anteriormente nos resultados da pesquisa e serão selecionadas para instalar novos pacotes quando várias fontes tiverem um pacote correspondente.

Observe que a ordenação dos resultados de pesquisa depende de vários fatores, e a prioridade da fonte tem o menor peso atualmente (a qualidade da correspondência e o campo são mais importantes).

"experimentalFeatures": {
    "sourcePriority": true
}