pin comando (winget)

Il wingetpin comando consente di limitare l'Windows Gestione pacchetti dall'aggiornamento di un pacchetto a intervalli specifici di versioni oppure può impedire completamente l'aggiornamento di un pacchetto. Un pacchetto aggiunto può comunque upgrade essere aggiornato autonomamente e aggiornato dall'esterno del Windows Gestione pacchetti.

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>, è necessario rimuovere il pacchetto per consentire a WinGet di eseguire un .upgrade L'opzione --force può essere usata per eseguire l'override del pincomportamento del .

  • 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 pincomportamento del .

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 pin comando supporta i sottocomandi seguenti.

Sottocomando Descrizione
aggiungi Aggiungere un nuovo pinoggetto .
rimuovere Rimuovere un pacchetto pin.
elenco Elencare i segnaposti correnti.
reimpostare Reimpostare i segnaposti

add (aggiungi)

Il sottocomando add aggiunge un nuovo pinoggetto . Per questo sottocomando è necessario specificare il pacchetto esatto in pin. 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
-D--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.
-Presso --version Consente di specificare una versione esatta per pin. Il carattere jolly * può essere usato come ultima parte della versione. Modifica pin il comportamento in modo che sia 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 Impedisci l'aggiornamento fino a quando non pin viene rimosso, impedendo gli argomenti di override. Modifica pin il comportamento in modo che sia 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 aggiunto un oggetto pin per un'applicazione. L'aggiunta di questa opzione pin impedirà l'aggiornamento di questo pacchetto durante la chiamata 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 blocco pin per un'applicazione usando il relativo ID. L'aggiunta di un blocco pin 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 oggetto upgrade.

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

L'esempio seguente aggiunge un controllo pin per un'applicazione usando il relativo ID. L'aggiunta di un controllo pin impedisce gli aggiornamenti che upgrade la versione del pacchetto non rientra in una versione specifica o nell'intervallo di caratteri jolly gated.

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

togliere

Il sottocomando remove rimuove un oggetto pin. Per questo sottocomando è necessario specificare il pacchetto pin esatto 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 oggetto pin per un'applicazione.

winget pin remove powertoys

Nell'esempio seguente viene rimosso un oggetto pin 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 pacchetto pinspecifico.

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