comando impostazioni (winget)

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

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

Annotazioni

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

Alias

Per questo comando sono disponibili gli alias seguenti:

• configurazione

Sottocom commandi

Sono disponibili i comandi secondari seguenti.

Sub-Command	Descrizione
esportazione	Esporta le impostazioni.
impostare	Imposta il valore di un'impostazione di amministratore.
reimpostare	Reimposta un'impostazione di amministratore sul valore predefinito.

Opzioni

Sono disponibili le opzioni seguenti:

Argomentazione	Descrizione
--abilitare	Abilita l'impostazione di amministratore specificata.
--disabilitare	Disabilita l'impostazione di amministratore specificata.
-?,--aiuto	Mostra aiuto sul comando selezionato.
--aspettare	Chiede all'utente di premere un tasto qualsiasi prima di uscire.
--logs,--open-logs (comandi per visualizzare i log)	Apre il percorso predefinito dei log.
--verbose,--verbose-logs	Abilita la registrazione dettagliata per winget.
--nowarn,--ignore-warnings	Elimina gli output degli avvisi.
--disabilita-interattività	Disabilita le richieste interattive.
--proxy	Imposta un proxy da utilizzare per questa esecuzione.
--no-proxy	Disabilita l'uso del proxy per questa esecuzione.

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 Impostazioni dell'interfaccia della riga di comando di WinGet , in cui è possibile individuare le funzionalità e le impostazioni sperimentali più recenti.

Il frammento di codice seguente mostra un esempio dell'aspetto del file di impostazioni con le modifiche all'output visivo e le funzionalità sperimentali abilitate.

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

    "visual": {
        "enableSixels": true,
        "progressBar": "rainbow"
    },
    "experimentalFeatures": {
        "experimentalARG": true,
        "experimentalCMD": true
    }
}

È 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.

Aggiornamento delle impostazioni

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

impostazioni di origine

Le impostazioni source riguardano la configurazione della fonte WinGet.

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

IntervalloAggiornamentoAutomaticoInMinuti

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

• Disabilita: 0
• Impostazione predefinita: 15

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

impostazioni visive

Le visual impostazioni coinvolgono elementi visivi visualizzati da WinGet

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

barra di avanzamento

Colore della barra di avanzamento che WinGet mostra quando non specificato dai parametri.

• accento (predefinito)
• arcobaleno
• retrò
• sixel
• disattivato

anonimizzaPercorsiVisualizzati

Sostituisce alcuni percorsi di cartelle noti con le rispettive variabili di ambiente.

enableSizels

Abilita l'output di immagini sixel in determinati contesti.

impostazioni di log

Le logging impostazioni controllano 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"
}

livello

Sono disponibili i livelli di registrazione seguenti. Se il valore non è impostato o non è valido, l'impostazione predefinita è info.

• prolisso
• Informazioni
• avvertimento
• Errore
• critico

impostazioni relative alle preferenze e ai requisiti

Alcune impostazioni vengono duplicate in preferences e requirements.

• L'impostazione preferences controlla la 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 genera programmi di installazione non applicabili e un errore.

Tutti gli argomenti passati nella riga di comando sostituiranno effettivamente l'impostazione requirement corrispondente per l'intera durata del comando.

scopo

Il scope comportamento controlla la 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). Consulta i problemi noti relativi all'ambito di installazione del pacchetto.

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

luogo

Il locale comportamento controlla la 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 architectures comportamento controlla quali architetture verranno selezionate durante l'installazione di un pacchetto. Il parametro corrispondente è --architecture. È possibile selezionare solo le architetture compatibili con il sistema.

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

tipi di installatore

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

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

impostazioni installBehavior

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

disattivaNoteDiInstallazione

L'impostazione disableInstallNotes determina se le note sull'installazione vengono visualizzate dopo un'installazione completata. L'impostazione predefinita è false se il valore non è impostato o non è valido.

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

impostazione portablePackageUserRoot

L'impostazione portablePackageUserRoot definisce la directory radice predefinita per l'installazione dei pacchetti nell'ambito di applicazione User . Questo vale solo per i pacchetti con il portable tipo di programma di installazione. L'impostazione predefinita è %LOCALAPPDATA%/Microsoft/WinGet/Packages/ se il valore non è impostato o non è valido.

Questo valore di impostazione deve essere un percorso assoluto.

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

impostazione di portablePackageMachineRoot

L'impostazione portablePackageMachineRoot definisce la directory radice predefinita per l'installazione dei pacchetti nel contesto Machine. Questo vale solo per i pacchetti con il portable tipo di programma di installazione. Se il valore non è impostato o non è valido, l'impostazione predefinita è %PROGRAMFILES%/WinGet/Packages/.

Questo valore di impostazione deve essere un percorso assoluto.

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

defaultInstallRoot

L'impostazione defaultInstallRoot specifica il percorso di installazione predefinito per i pacchetti che richiedono un percorso di installazione esplicito, se il percorso di installazione non è specificato.

maxResumes

L'impostazione maxResumes specifica il numero massimo di tentativi di ripresa consentiti per un singolo ID ripresa. In questo modo si evitano riavvii continui se non viene rilevato correttamente un'installazione che richiede un riavvio.

Metodo di estrazione dell'archivio

L'impostazione archiveExtractionMethod controlla il modo in cui il programma di installazione estrae gli archivi. I valori supportati sono shellApi e tar.

• shellApi usa l'API shell di Windows per estrarre gli archivi.

• tar usa il comando tar per estrarre gli archivi.

UninstallBehavior

L'impostazione uninstallBehavior controlla se il processo di disinstallazione predefinito rimuove tutti i file e le directory rilevanti per questo pacchetto. Si applica solo all'oggetto portatile installerType.

purgePortablePackage

L'impostazione purgePortablePackage controlla il 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 portable pacchetto. Questa impostazione si applica solo ai pacchetti con il portable tipo di programma di installazione. L'impostazione predefinita è false se il valore non è impostato o non è valido.

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

ConfigureBehavior

L'impostazione ConfigureBehavior specifica la directory radice predefinita in cui vengono installati i moduli di PowerShell durante l'applicazione di una configurazione.

comportamento di download

Le downloadBehavior impostazioni controllano la directory predefinita in cui vengono scaricati i programmi di installazione.

directory di download predefinita

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

Questo valore di impostazione deve essere un percorso assoluto.

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

Impostazioni di telemetria

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

Consulta informazioni sui dati di telemetria, nonché la nostra informativa sulla privacy principale .

disabilitare

"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 network impostazioni influenzano il modo in cui WinGet usa la rete per recuperare pacchetti e metadati.

scaricatore

L'impostazione downloader controlla il codice usato durante il download dei pacchetti. Il valore predefinito è do, che può essere gestito da Criteri di gruppo.

usa le API di WinINet , mentre usa il servizio Ottimizzazione recapito .

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

doProgressTimeoutInSeconds

doProgressTimeoutInSeconds Specifica il numero di secondi di attesa senza avanzamento prima del fallback.

Interattività

L'impostazione Interactivity controlla se i prompt interattivi vengono visualizzati dal client di Gestione pacchetti di Windows.

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.