comando segnaposto (winget)

Il comando winget pin consente di limitare gestione pacchetti di Windows dall'aggiornamento di un pacchetto a intervalli specifici di versioni oppure può impedire completamente l'aggiornamento di un pacchetto. Un pacchetto aggiunto può comunque eseguire l'aggiornamento autonomamente ed essere aggiornato dall'esterno di Gestione pacchetti di Windows.

Tipi di segnaposto

WinGet supporta tre tipi di aggiunte di pacchetto:

  • Aggiunta: il pacchetto viene escluso da winget upgrade --all ma consente winget upgrade <package>. È possibile usare l'argomento --include-pinned per consentire l'inclusione winget upgrade --all di pacchetti aggiunti.

  • Blocco: il pacchetto è bloccato da winget upgrade --all o winget upgrade <package>, dovrai rimuovere il pacchetto per consentire a WinGet di eseguire un aggiornamento. L'opzione --force può essere usata per eseguire l'override del comportamento relativo all’aggiunta.

  • Gating: il pacchetto viene aggiunto a una versione o a un intervallo di versioni specifico. È possibile specificare una versione esatta a cui si vuole aggiungere un pacchetto oppure utilizzare il carattere jolly * come ultima parte della versione per specificare un intervallo di versioni. Ad esempio, se un pacchetto viene aggiunto alla versione 1.2.*, qualsiasi versione tra 1.2.0 a 1.2.x viene considerata valida. L'opzione --force può essere usata per eseguire l'override del comportamento relativo all’aggiunta.

Utilizzo

winget pin <subcommand> <options>

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.
--nowarn,--ignore-warnings Elimina gli output degli avvisi.
--disable-interactivity Disabilita le richieste interattive.
--proxy Impostare un proxy da usare per questa esecuzione.
--no-proxy Disabilitare l'uso del proxy per questa esecuzione.

Sottocomandi

Il comando aggiungere supporta i sottocomandi seguenti.

Sottocomando Descrizione
add Aggiungere un nuovo segnaposto.
remove Rimuovere un segnaposto del pacchetto.
list Elencare i segnaposti correnti.
reset Reimpostare i segnaposti

add (aggiungi)

Il sottocomando aggiungere aggiunge un nuovo segnaposto. Questo sottocomando richiede di specificare il pacchetto esatto da aggiungere. In caso di ambiguità, verrà richiesto di filtrare ulteriormente il comando aggiungere in base a un'applicazione esatta.

Utilizzo:

winget pin add [[-q] <query>] [<options>]

Argomenti

Argomento Descrizione
-q,--query Query usata per cercare un'app.

Opzioni

Le opzioni consentono di personalizzare le aggiunte per soddisfare le proprie esigenze.

Opzione Descrizione
--id Limita la ricerca all'ID dell'applicazione.
--name Limita la ricerca al nome dell'applicazione.
--moniker Limita la ricerca al moniker elencato per l'applicazione.
--tag Limita la ricerca ai tag elencati per l'applicazione.
--cmd, --command Limita la ricerca al comando dell'applicazione.
e, --exact Usa la stringa esatta nella query, inclusa la verifica della distinzione tra maiuscole e minuscole. Non userà il comportamento predefinito di una sottostringa.
-v, --version Consente di specificare una versione esatta da aggiungere. Il carattere jolly * può essere usato come ultima parte della versione. Modifica il comportamento del segnaposto in gating.
-s, --source Limita la ricerca al nome specificato per l'origine. Deve essere seguito dal nome dell'origine.
--header Intestazione HTTP di origine REST di Windows-Package-Manager facoltativa.
--authentication-mode Specificare le preferenze della finestra di autenticazione (invisibile all'utente, silentPreferred o interattivo).
--authentication-account Specificare l'account da usare per l'autenticazione.
--accept-source-agreements Usato per accettare il contratto di licenza di origine ed evitare la richiesta.
--force Eseguire direttamente il comando e continuare con problemi non correlati alla sicurezza.
--blocking Impedire l'aggiornamento fino a quando l’aggiunta non viene rimossa, impedendo gli argomenti di override. Modifica il comportamento relativo all’aggiunta di un segnaposto in blocking.
--installed Aggiungere una versione installata specifica
-?, --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.
--nowarn,--ignore-warnings Elimina gli output degli avvisi.
--disable-interactivity Disabilita le richieste interattive.
--proxy Impostare un proxy da usare per questa esecuzione.
--no-proxy Disabilitare l'uso del proxy per questa esecuzione.

Esempi

Nell'esempio seguente viene eseguita un’aggiunta di un segnaposto per un'applicazione. L'aggiunta di questo segnaposto impedirà l'aggiornamento di questo pacchetto durante la chiamata relativa a winget upgrade --all. Usare l'argomento --include-pinned con winget upgrade --all per includere eventuali pacchetti aggiunti.

winget pin add powertoys

Nell'esempio seguente viene aggiunto un segnaposto di blocco per un'applicazione usando il relativo ID. L'aggiunta di un segnaposto di blocco impedirà l'aggiornamento di questo pacchetto quando si chiama winget upgrade --all o winget upgrade <package>. Sarà necessario sbloccare il pacchetto per consentire a WinGet di eseguire un aggiornamento.

winget pin add --id Microsoft.PowerToys --blocking

Nell'esempio seguente viene aggiunto un segnaposto di gating per un'applicazione usando il relativo ID. L'aggiunta di un segnaposto impedisce gli aggiornamenti che aggiornano la versione del pacchetto all'esterno di una versione specifica o dell'intervallo di caratteri jolly di cui viene eseguito il gating.

winget pin add --id Microsoft.PowerToys --version 0.70.*

remove

Il sottocomando rimuovere rimuove un segnaposto. Per questo sottocomando è necessario specificare il segnaposto esatto del pacchetto da rimuovere. In caso di ambiguità, verrà richiesto di filtrare ulteriormente il comando rimuovere in base a un'applicazione esatta.

Utilizzo:

winget pin remove [[-q] <query>] [<options>]

Argomenti

Argomento Descrizione
-q,--query Query usata per cercare un'app.

Opzioni

Le opzioni consentono di personalizzare la rimozione dei segnaposto in base alle proprie esigenze.

Opzione Descrizione
--id Limita la ricerca all'ID dell'applicazione.
--name Limita la ricerca al nome dell'applicazione.
--moniker Limita la ricerca al moniker elencato per l'applicazione.
-s, --source Limita la ricerca al nome specificato per l'origine. Deve essere seguito dal nome dell'origine.
--tag Limita la ricerca ai tag elencati per l'applicazione.
--cmd, --command Limita la ricerca al comando dell'applicazione.
e, --exact Usa la stringa esatta nella query, inclusa la verifica della distinzione tra maiuscole e minuscole. Non userà il comportamento predefinito di una sottostringa.
--header Intestazione HTTP di origine REST di Windows-Package-Manager facoltativa.
--authentication-mode Specificare le preferenze della finestra di autenticazione (invisibile all'utente, silentPreferred o interattivo).
--authentication-account Specificare l'account da usare per l'autenticazione.
--accept-source-agreements Usato per accettare il contratto di licenza di origine ed evitare la richiesta.
--installed Aggiungere una versione installata specifica.
-?, --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.
--nowarn,--ignore-warnings Elimina gli output degli avvisi.
--disable-interactivity Disabilita le richieste interattive.
--proxy Impostare un proxy da usare per questa esecuzione.
--no-proxy Disabilitare l'uso del proxy per questa esecuzione.

Esempi

Nell'esempio seguente viene rimosso un segnaposto per un'applicazione.

winget pin remove powertoys

Nell'esempio seguente viene rimosso un segnaposto per un'applicazione usando il relativo ID.

winget pin remove --id Microsoft.PowerToys

list (elenca)

Il sottocomando elenco elenca tutti i segnaposti correnti.

Utilizzo:

winget pin list [[-q] <query>] [<options>]

Argomenti

Argomento Descrizione
-q,--query Query usata per cercare un'app.

Opzioni

Le opzioni consentono di personalizzare i segnaposti di presentazione per soddisfare le proprie esigenze.

Opzione Descrizione
--id Limita la ricerca all'ID dell'applicazione.
--name Limita la ricerca al nome dell'applicazione.
--moniker Limita la ricerca al moniker elencato per l'applicazione.
-s, --source Limita la ricerca al nome specificato per l'origine. Deve essere seguito dal nome dell'origine.
--tag Limita la ricerca ai tag elencati per l'applicazione.
--cmd, --command Limita la ricerca al comando dell'applicazione.
e, --exact Usa la stringa esatta nella query, inclusa la verifica della distinzione tra maiuscole e minuscole. Non userà il comportamento predefinito di una sottostringa.
--header Intestazione HTTP di origine REST di Windows-Package-Manager facoltativa.
--authentication-mode Specificare le preferenze della finestra di autenticazione (invisibile all'utente, silentPreferred o interattivo).
--authentication-account Specificare l'account da usare per l'autenticazione.
--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.
--nowarn,--ignore-warnings Elimina gli output degli avvisi.
--disable-interactivity Disabilita le richieste interattive.
--proxy Impostare un proxy da usare per questa esecuzione.
--no-proxy Disabilitare l'uso del proxy per questa esecuzione.

Esempi

Nell'esempio seguente sono elencati tutti i segnaposti correnti.

winget pin list

Nell'esempio seguente viene elencato un segnaposto di pacchetto specifico.

winget pin list --id Microsoft.PowerToys

reset (ripristina)

Il sottocomando di reimpostazione reimposta tutti i segnaposti.

Usando questo sottocomando senza l'argomento --force verranno visualizzati i segnaposti che verrebbero rimossi.

Per reimpostare tutti i segnaposti, includere l'argomento --force.

Utilizzo:

winget pin reset [<options>]

Opzioni

Le opzioni consentono di personalizzare la reimpostazione dei segnaposto in base alle proprie esigenze.

Opzione Descrizione
--force Eseguire direttamente il comando e continuare con problemi non correlati alla sicurezza.
-s, --source Limita la ricerca al nome specificato per l'origine. Deve essere seguito dal nome dell'origine.
-?, --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.
--nowarn,--ignore-warnings Elimina gli output degli avvisi.
--disable-interactivity Disabilita le richieste interattive.
--proxy Impostare un proxy da usare per questa esecuzione.
--no-proxy Disabilitare l'uso del proxy per questa esecuzione.

Esempi

L'esempio seguente mostra tutti i segnaposti che verrebbero reimpostati.

winget pin reset

Nell'esempio seguente vengono reimpostati tutti i segnaposti esistenti.

winget pin reset --force