Comando di origine winget

Il comando source dello strumento winget consente di gestire le origini per Gestione pacchetti di Windows. Con il comando source è possibile aggiungere, elencare, aggiornare, rimuovere,reimpostare o esportare repository.

Un'origine fornisce i dati per individuare e installare le applicazioni. Usare solo percorsi di origine sicuri e attendibili.

Gestione pacchetti di Windows specifica i due repository predefiniti seguenti, che è possibile elencare usando winget source list.

  • msstore: catalogo di Microsoft Store.
  • winget: repository di app di Gestione pacchetti di Windows.

Utilizzo

winget source <subcommand> <options>

Argomenti

Sono disponibili gli argomenti seguenti.

Argomento Descrizione
-?, --help Ottiene informazioni aggiuntive su questo comando.

L'immagine seguente mostra la Guida per il comando source:

Screenshot showing help for the source command.

Opzioni

Sono disponibili le seguenti opzioni.

Opzione Descrizione
-?,--help Mostra la Guida sul comando selezionato.
--wait Chiede all'utente di premere un tasto qualsiasi prima di uscire.
--logs,--open-logs Aprire il percorso dei log predefinito.
--verbose, --verbose-logs Usato per eseguire l'override dell'impostazione di registrazione e creare un log dettagliato.
--disable-interactivity Disabilita le richieste interattive.

Sottocomandi

Il comando di source supporta le seguenti opzioni.

Sottocomando Descrizione
add Aggiunge una nuova origine.
list Enumera l'elenco di origini abilitate.
update Aggiorna un'origine.
remove Rimuove un'origine.
reset Reimposta winget e msstore alla configurazione iniziale.
export Esporta le origini correnti.

add (aggiungi)

Il sottocomando add aggiunge una nuova origine. Questo sottocomando richiede le opzioni --name e --arg. Poiché il comando modifica l'accesso utente, l'uso di add richiede privilegi di amministratore.

Utilizzo:

winget source add [-n, --name] <name> [-a, --arg] <url> [[-t, --type] <type>]

Argomenti

Sono disponibili gli argomenti seguenti.

Argomento Descrizione
-n,--name Nome in base a cui identificare l'origine.
-a,--arg URL o UNC dell'origine.
-t,--type Tipo di origine .

Opzioni

Sono disponibili le seguenti opzioni.

Opzione Descrizione
--header Intestazione HTTP di origine REST di Windows-Package-Manager facoltativa.
--accept-source-agreements Usato per accettare il contratto di licenza di origine ed evitare la richiesta.
-?, --help Ottiene informazioni aggiuntive su questo comando.
--wait Chiede all'utente di premere un tasto qualsiasi prima di uscire.
--logs,--open-logs Aprire il percorso dei log predefinito.
--verbose, --verbose-logs Usato per eseguire l'override dell'impostazione di registrazione e creare un log dettagliato.
--disable-interactivity Disabilitare le richieste interattive.

Ad esempio, winget source add --name Contoso https://www.contoso.com/cache aggiunge il repository Contoso all'URL https://www.contoso.com/cache.

Parametro di tipo facoltativo

Il sottocomando add supporta il parametro di tipo facoltativo, che indica al client il tipo di repository a cui si sta connettendo. È supportato il tipo seguente.

Type Description
Microsoft.PreIndexed.Package Tipo di origine predefinito.

list (elenca)

Il sottocomando list enumera le origini attualmente abilitate o fornisce dettagli su un'origine specifica.

Utilizzo:

winget source list [[-n, --name] <name>]

Alias

Per questo sottocomando sono disponibili gli alias seguenti:

  • ls

Argomenti

Sono disponibili gli argomenti seguenti.

Argomento Descrizione
-n,--name Nome in base a cui identificare l'origine.

Opzioni

Sono disponibili le seguenti opzioni.

Opzione Descrizione
-?, --help Ottiene informazioni aggiuntive su questo comando.
--wait Chiede all'utente di premere un tasto qualsiasi prima di uscire.
--logs,--open-logs Aprire il percorso dei log predefinito.
--verbose, --verbose-logs Usato per eseguire l'override dell'impostazione di registrazione e creare un log dettagliato.
--disable-interactivity Disabilitare le richieste interattive.

list all

Il sottocomando list, winget source list, fornisce l'elenco completo delle origini supportate:

Name   Arg
-----------------------------------------
winget https://winget.azureedge.net/cache

list source details

Per ottenere dettagli completi su un'origine, passare il nome dell'origine. Ad esempio:

winget source list --name Contoso

Restituisce l'output seguente:

Name   : Contoso
Type   : Microsoft.PreIndexed.Package
Arg    : https://pkgmgr-int.azureedge.net/cache
Data   : AppInstallerSQLiteIndex-int_g4ype1skzj3jy
Updated: 2020-4-14 17:45:32.000
  • Name è il nome dell'origine.
  • Type è il tipo di repository.
  • Arg è l'URL o il percorso usato dall'origine.
  • Data è il nome del pacchetto facoltativo, se appropriato.
  • Updated è la data e l'ora dell'ultimo aggiornamento dell'origine.

update

Il sottocomando di aggiornamento forza un aggiornamento a una singola origine o a tutte le origini.

Utilizzo:

winget source update [[-n, --name] <name>]

Alias

Per questo sottocomando sono disponibili gli alias seguenti:

  • refresh

Argomenti

Sono disponibili gli argomenti seguenti.

Argomento Descrizione
-n,--name Nome in base a cui identificare l'origine.

Opzioni

Sono disponibili le seguenti opzioni.

Opzione Descrizione
-?, --help Ottiene informazioni aggiuntive su questo comando.
--wait Chiede all'utente di premere un tasto qualsiasi prima di uscire.
--logs,--open-logs Aprire il percorso dei log predefinito.
--verbose, --verbose-logs Usato per eseguire l'override dell'impostazione di registrazione e creare un log dettagliato.
--disable-interactivity Disabilitare le richieste interattive.

update all

Il sottocomando di aggiornamento, winget source update, richiede aggiornamenti a tutti i repository.

aggiornare l'origine

Il sottocomando di aggiornamento con l'opzione --name indirizza un aggiornamento all'origine denominata. Ad esempio: winget source update --name Contoso forza un aggiornamento al repository Contoso.

remove

Il sottocomando remove rimuove un'origine. Questo sottocomando richiede l'opzione --name per identificare l'origine. Poiché il comando modifica l'accesso utente, l'uso di remove richiede privilegi di amministratore.

Utilizzo:

winget source remove [-n, --name] <name>

Alias

Per questo sottocomando sono disponibili gli alias seguenti:

  • rm

Argomenti

Sono disponibili gli argomenti seguenti.

Argomento Descrizione
-n,--name Nome in base a cui identificare l'origine.

Opzioni

Sono disponibili le seguenti opzioni.

Opzione Descrizione
-?, --help Ottiene informazioni aggiuntive su questo comando.
--wait Chiede all'utente di premere un tasto qualsiasi prima di uscire.
--logs,--open-logs Aprire il percorso dei log predefinito.
--verbose, --verbose-logs Usato per eseguire l'override dell'impostazione di registrazione e creare un log dettagliato.
--disable-interactivity Disabilita le richieste interattive.

Esempi

winget source remove --name Contoso

Questo comando rimuove il repository Contoso.

reset (ripristina)

Il sottocomando reset ripristina la configurazione originale del client e rimuove tutte le origini ad eccezione del valore predefinito. Utilizzare questo sottocomando solo in rari casi. Poiché il comando modifica l'accesso utente, l'uso di reset richiede privilegi di amministratore.

Poiché il comando reset rimuove tutte le origini, è necessario forzare l'azione usando l'opzione --force.

Utilizzo:

winget source reset --force

Argomenti

Sono disponibili gli argomenti seguenti.

Argomento Descrizione
-n,--name Nome in base a cui identificare l'origine.

Opzioni

Sono disponibili le seguenti opzioni.

Opzione Descrizione
-?, --help Ottiene informazioni aggiuntive su questo comando.
--wait Chiede all'utente di premere un tasto qualsiasi prima di uscire.
--logs,--open-logs Aprire il percorso dei log predefinito.
--verbose, --verbose-logs Usato per eseguire l'override dell'impostazione di registrazione e creare un log dettagliato.
--disable-interactivity Disabilitare le richieste interattive.

esportare

Il sottocomando export esporta i dettagli specifici per un'origine nell'output JSON.

Argomenti

Sono disponibili gli argomenti seguenti.

Argomento Descrizione
-n,--name Nome in base a cui identificare l'origine.

Opzioni

Sono disponibili le seguenti opzioni.

Opzione Descrizione
-?, --help Ottiene informazioni aggiuntive su questo comando.
--wait Chiede all'utente di premere un tasto qualsiasi prima di uscire.
--logs,--open-logs Aprire il percorso dei log predefinito.
--verbose, --verbose-logs Usato per eseguire l'override dell'impostazione di registrazione e creare un log dettagliato.
--disable-interactivity Disabilita le richieste interattive.

Esempi

winget source export winget

Restituisce l'output seguente:

{"Arg":"https://winget.azureedge.net/cache","Data":"Microsoft.Winget.Source_8wekyb3d8bbwe","Identifier":"Microsoft.Winget.Source_8wekyb3d8bbwe","Name":"winget","Type":"Microsoft.PreIndexed.Package"}

Contratto di origine

Una singola source potrebbe richiedere all'utente di accettare le condizioni presentate prima di aggiungere o usare il repository. Se un utente non accetta o conferma il contratto, non sarà in grado di accedere all'origine.

È possibile usare l'opzione --accept-source-agreements per accettare il contratto di licenza di origine ed evitare la richiesta.

Screenshot showing a source license prompt.