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