comando impostazioni (winget)

Il comando delle impostazioni dello strumento winget consente di personalizzare l'esperienza client di Gestione pacchetti di Windows. È possibile modificare le impostazioni predefinite e provare le funzionalità sperimentali abilitate nel client.

Il comando delle impostazioni avvierà l'editor di testo predefinito. Per impostazione predefinita, Windows avvierà Blocco note come opzione. È consigliabile usare uno strumento come Visual Studio Code.

Nota

È possibile installare facilmente Visual Studio Code digitando winget install Microsoft.VisualStudioCode

Alias

Per questo comando sono disponibili gli alias seguenti:

• config

Usare il comando delle impostazioni winget

Avviare lo strumento di modifica JSON predefinito: winget settings

Quando si avviano le impostazioni per la prima volta, non verranno specificate impostazioni. Nella parte superiore del file JSON viene fornito un collegamento in cui è possibile individuare le funzionalità e le impostazioni sperimentali più recenti.

Il frammento di codice riportato di seguito è un esempio di come dovrebbe apparire il file delle impostazioni se si desidera abilitare o modificare alcune di queste funzionalità e impostazioni sperimentali.

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

    // For documentation on these settings, see: https://aka.ms/winget-settings
    "experimentalFeatures": {
	  "dependencies": true,
	  "directMSI": false,
	  "zipInstall": false,
    },
    "visual": {
        "progressBar": "rainbow"
    },
    "source": {
        "autoUpdateIntervalInMinutes": 5
    },
}

È stato definito anche uno schema per il file di impostazioni. In questo modo è possibile usare TAB per individuare le impostazioni e la sintassi se l'editor JSON supporta schemi JSON.

Nota

Le funzionalità sperimentali sono disponibili solo nelle build di anteprima. Le istruzioni per ottenere una build di anteprima sono disponibili nel repository GitHub.

Aggiornamento delle impostazioni

Per la versione 1.0 di Gestione pacchetti di Windows sono disponibili le impostazioni seguenti.

impostazioni origine

Le impostazioni source coinvolgono la configurazione dell'origine WinGet.

"source": {
    "autoUpdateIntervalInMinutes": 3
},

autoUpdateIntervalInMinutes

Un numero intero positivo rappresenta l'intervallo di aggiornamento in minuti. Il controllo degli aggiornamenti si verifica solo quando viene usata un'origine. Uno zero disabiliterà il controllo degli aggiornamenti a un'origine. Tutti gli altri valori non sono validi.

• Disabilita: 0
• Impostazione predefinita: 5

Per aggiornare manualmente l'origine, usare winget source update.

impostazioni oggetto visivo

Le impostazioni visualcoinvolgono elementi visivi visualizzati da WinGet

"visual": {
    "progressBar": "accent"
},

progressBar

Colore dell'indicatore di stato visualizzato da WinGet quando non specificato dagli argomenti.

• accento (impostazione predefinita)
• retro
• arcobaleno

impostazioni installBehavior

Le impostazioni installBehavior influiscono sul comportamento predefinito dell'installazione e dell'aggiornamento (se applicabile) dei pacchetti.

disableInstallNotes

Il comportamento disableInstallNotes influisce sulla visualizzazione delle note di installazione dopo un'installazione riuscita. L'impostazione predefinita è false se il valore non è impostato o non è valido.

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

impostazione portablePackageUserRoot

L'impostazione portablePackageUserRoot influisce sulla directory radice predefinita in cui sono installati i pacchetti nell'ambito User. Questa impostazione si applica solo ai pacchetti con il tipo di programma di installazione portable. L'impostazione predefinita è %LOCALAPPDATA%/Microsoft/WinGet/Packages/ se il valore non è impostato o non è valido.

Nota: questo valore di impostazione deve essere un percorso assoluto.

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

impostazione portablePackageMachineRoot

L'impostazione portablePackageMachineRoot influisce sulla directory radice predefinita in cui i pacchetti vengono installati nell'ambito Machine. Questa impostazione si applica solo ai pacchetti con il tipo di programma di installazione portable. L'impostazione predefinita è %PROGRAMFILES%/WinGet/Packages/ se il valore non è impostato o non è valido.

Nota: questo valore di impostazione deve essere un percorso assoluto.

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

impostazioni relative alle preferenze e ai requisiti

Alcune impostazioni vengono duplicate in preferences e requirements.

• L'impostazione preferences influisce sulla modalità di ordinamento delle varie opzioni disponibili quando si sceglie quella su cui agire. Ad esempio, l'ambito predefinito delle installazioni del pacchetto è per l'utente corrente, ma se non è un'opzione, verrà scelto un programma di installazione a livello di computer.
• L'impostazione requirements filtra le opzioni, causando potenzialmente un elenco vuoto e un errore di installazione. Nell'esempio precedente, un requisito dell'ambito utente non comporterebbe l'assenza di programmi di installazione applicabili e un errore.

Tutti gli argomenti passati nella riga di comando sostituiranno in modo efficace l'impostazione requirement corrispondente per la durata di tale comando.

ambito

Il comportamento scope influisce sulla scelta tra l'installazione di un pacchetto per l'utente corrente o per l'intero computer. Il parametro corrispondente è --scopee usa gli stessi valori (user o machine). Vedere Problemi noti relativi all'ambito di installazione del pacchetto.

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

locale

Il comportamento locale influisce sulla scelta del programma di installazione in base alle impostazioni locali del programma di installazione. Il parametro corrispondente è --localee usa il tag di lingua bcp47.

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

architetture

Il comportamento architectures influisce sulle architetture che verranno selezionate durante l'installazione di un pacchetto. Il parametro corrispondente è --architecture. Si noti che è possibile selezionare solo le architetture compatibili con il sistema.

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

installerTypes

Il comportamento installerTypes influisce sui tipi di programma di installazione che verranno selezionati durante l'installazione di un pacchetto. Il parametro corrispondente è --installer-type.

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

uninstallBehavior

Le impostazioni uninstallBehavior influiscono sul comportamento predefinito della disinstallazione (se applicabile) dei pacchetti.

purgePortablePackage

Il comportamento purgePortablePackage influisce sul comportamento predefinito per la disinstallazione di un pacchetto portabile. Se impostato su true, la disinstallazione rimuoverà tutti i file e le directory rilevanti per il pacchetto portable. Questa impostazione si applica solo ai pacchetti con il tipo di programma di installazione portable. L'impostazione predefinita è false se il valore non è impostato o non è valido.

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

downloadBehavior

Le impostazioni downloadBehavior influiscono sul comportamento predefinito del download dei pacchetti.

defaultDownloadDirectory

L'impostazione defaultDownloadDirectory influisce sulla directory predefinita in cui vengono scaricati i pacchetti. L'impostazione predefinita è %USERPROFILE%/Downloads se il valore non è impostato o non è valido.

Nota: questo valore di impostazione deve essere un percorso assoluto.

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

impostazioni di telemetria

Le impostazioni di telemetry controllano se winget scrive eventi ETW che possono essere inviati a Microsoft in un'installazione predefinita di Windows.

Vedi i dettagli sulla telemetria e l’informativa sulla privacy principale.

disable

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

Se impostato su true, l'impostazione telemetry.disable impedirà la scrittura di qualsiasi evento da parte del programma.

impostazioni di rete

Le impostazioni di network influenzano il modo in cui winget usa la rete per recuperare pacchetti e metadati.

downloader

L'impostazione downloader controlla il codice usato durante il download dei pacchetti. Il valore predefinito è default, che può essere una qualsiasi delle opzioni in base alla determinazione.

wininet usa le API WinINet, mentre do usa il servizio Ottimizzazione recapito.

"network": {
    "downloader": "do"
}

impostazioni di registrazione

Le impostazioni di loggingcontrollano il livello di dettaglio nei file di log. --verbose-logs eseguirà l'override di questa impostazione e creerà sempre un log dettagliato.

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

level

Sono disponibili i livelli di registrazione seguenti. L'impostazione predefinita è info se il valore non è impostato o non è valido.

• verbose
• info
• warning
• Errore
• critical

Abilitazione delle funzionalità sperimentali

Per scoprire quali funzionalità sperimentali sono disponibili, passare a https://aka.ms/winget-settings dove è possibile visualizzare le funzionalità sperimentali disponibili.