pin kommando (winget)

Med wingetpin kommandot kan du begränsa Windows Správca balíkov från att uppgradera ett paket till specifika versionsintervall, eller så kan det hindra det från att uppgradera ett paket helt och hållet. Ett fäst paket kan fortfarande upgrade vara på egen hand och uppgraderas utanför Windows Správca balíkov.

Pin-typer

WinGet stöder tre typer av paketstift:

  • Fäst: Paketet är undantaget från winget upgrade --all men tillåter winget upgrade <package>. Du kan använda argumentet --include-pinned för att låta winget upgrade --all inkludera fästa paket.

  • Blockering: Paketet blockeras från winget upgrade --all eller winget upgrade <package>måste du ta bort paketet så att WinGet kan utföra en upgrade. Alternativet --force kan användas för att åsidosätta pinbeteendet.

  • Gating: Paketet är fäst på en viss version eller ett visst versionsintervall. Du kan ange en exakt version som du vill att ett paket ska fästas på, eller så kan du använda jokertecknet * som den sista versionsdelen för att ange ett versionsintervall. Om ett paket till exempel är fäst på version 1.2.*anses alla versioner mellan 1.2.0 till 1.2.x giltiga. Alternativet --force kan användas för att åsidosätta pinbeteendet.

Användning

winget pin <subcommand> <options>

Alternativ

Följande alternativ är tillgängliga.

Alternativ Beskrivning
-?, --help Får ytterligare hjälp med det här kommandot.
--wait Uppmanar användaren att trycka på valfri tangent innan den avslutas.
--logs, --open-logs Öppna standardloggplatsen.
--verbose, --verbose-logs Används för att åsidosätta loggningsinställningen och skapa en utförlig logg.
--nowarn, --ignore-warnings Undertrycker varningsutdata.
--disable-interactivity Inaktivera interaktiva frågor.
--proxy Ange en proxy som ska användas för den här körningen.
--no-proxy Inaktivera användningen av proxy för den här körningen.

Underkommandon

Kommandot pin stöder följande underkommandon.

Underkommando Beskrivning
add Lägg till en ny pin.
remove Ta bort ett paket pin.
list Visa en lista över aktuella stift.
reset Återställa stift

lägg till

Underkommandot add lägger till en ny pin. Den här underkommandot kräver att du anger det exakta paketet till pin. Om det finns tvetydigheter uppmanas du att ytterligare filtrera add underkommandot till ett exakt program.

Användning:

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

Argumentpunkter

Argumentation Beskrivning
-q, --query Frågan som används för att söka efter en app.

Alternativ

Med alternativen kan du anpassa tilläggsstiften så att de passar dina behov.

Alternativ Beskrivning
--id Begränsar sökningen till programmets ID.
--name Begränsar sökningen till namnet på programmet.
--moniker Begränsar sökningen till den moniker som anges för programmet.
--tag Begränsar sökningen till taggen som anges för programmet.
--cmd, --command Begränsar sökningen till kommandot för programmet.
-e, --exact Använder den exakta strängen i frågan, inklusive att kontrollera skiftlägeskänslighet. Den använder inte standardbeteendet för en delsträng.
-v, --version Gör att du kan ange en exakt version till pin. Jokertecknet * kan användas som den senaste versionsdelen. Ändrar pin beteende till gating.
-s, --source Begränsar sökningen till det angivna källnamnet. Måste följas av källnamnet.
--header Valfritt Windows-Package-Manager REST-källhuvud för HTTP.
--authentication-mode Ange inställningar för autentiseringsfönster (tyst, tystFörhandsvald eller interaktivt).
--authentication-account Ange det konto som ska användas för autentisering.
--accept-source-agreements Används för att acceptera källlicensavtalet och undvika uppmaningen.
--force Kör kommandot direkt och fortsätt med frågor som inte rör säkerhet.
--blocking Blockera från att uppgradera tills den pin har tagits bort, vilket förhindrar åsidosättningsargument. Ändrar pin beteende till blocking.
--installed Fästa en specifik installerad version
-?, --help Få ytterligare hjälp med det här kommandot.
--wait Uppmanar användaren att trycka på valfri tangent innan den avslutas.
--logs, --open-logs Öppna standardloggplatsen.
--verbose, --verbose-logs Används för att åsidosätta loggningsinställningen och skapa en utförlig logg.
--nowarn, --ignore-warnings Undertrycker varningsutdata.
--disable-interactivity Inaktivera interaktiva frågor.
--proxy Ange en proxy som ska användas för den här körningen.
--no-proxy Inaktivera användningen av proxy för den här körningen.

Exempel

I följande exempel läggs en pin för ett program till. Om du lägger till detta pin förhindrar du att det här paketet uppgraderas när du anropar winget upgrade --all. Använd argumentet --include-pinned med winget upgrade --all för att inkludera eventuella fästa paket.

winget pin add powertoys

I följande exempel läggs en blockering pin för ett program till med dess ID. Om du lägger till en blockering pin förhindras det här paketet från att uppgraderas när du anropar winget upgrade --all eller winget upgrade <package>. Du måste avblockera paketet så att WinGet kan utföra en upgrade.

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

I följande exempel läggs en gating pin till för ett program med dess ID. Om du lägger till en gating pin förhindras uppgraderingar av upgrade paketversionen utanför en viss version eller det gated jokerteckenintervallet.

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

avlägsna

Underkommandot remove tar bort en pin. Den här underkommandot kräver att du anger det exakta paketet pin som du vill ta bort. Om det finns tvetydigheter uppmanas du att ytterligare filtrera remove underkommandot till ett exakt program.

Användning:

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

Argumentpunkter

Argumentation Beskrivning
-q, --query Frågan som används för att söka efter en app.

Alternativ

Med alternativen kan du anpassa borttagningsstiften så att de passar dina behov.

Alternativ Beskrivning
--id Begränsar sökningen till programmets ID.
--name Begränsar sökningen till namnet på programmet.
--moniker Begränsar sökningen till den moniker som anges för programmet.
-s, --source Begränsar sökningen till det angivna källnamnet. Måste följas av källnamnet.
--tag Begränsar sökningen till taggen som anges för programmet.
--cmd, --command Begränsar sökningen till kommandot för programmet.
-e, --exact Använder den exakta strängen i frågan, inklusive att kontrollera skiftlägeskänslighet. Den använder inte standardbeteendet för en delsträng.
--header Valfritt Windows-Package-Manager REST-källhuvud för HTTP.
--authentication-mode Ange inställningar för autentiseringsfönster (tyst, tystFörhandsvald eller interaktivt).
--authentication-account Ange det konto som ska användas för autentisering.
--accept-source-agreements Används för att acceptera källlicensavtalet och undvika uppmaningen.
--installed Fäst en specifik installerad version.
-?, --help Få ytterligare hjälp med det här kommandot.
--wait Uppmanar användaren att trycka på valfri tangent innan den avslutas.
--logs, --open-logs Öppna standardloggplatsen.
--verbose, --verbose-logs Används för att åsidosätta loggningsinställningen och skapa en utförlig logg.
--nowarn, --ignore-warnings Undertrycker varningsutdata.
--disable-interactivity Inaktivera interaktiva frågor.
--proxy Ange en proxy som ska användas för den här körningen.
--no-proxy Inaktivera användningen av proxy för den här körningen.

Exempel

I följande exempel tar du bort ett pin för ett program.

winget pin remove powertoys

Följande exempel tar bort ett pin för ett program med dess ID.

winget pin remove --id Microsoft.PowerToys

lista

Underkommandot list visar en lista över alla aktuella stift.

Användning:

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

Argumentpunkter

Argumentation Beskrivning
-q, --query Frågan som används för att söka efter en app.

Alternativ

Med alternativen kan du anpassa liststiften efter dina behov.

Alternativ Beskrivning
--id Begränsar sökningen till programmets ID.
--name Begränsar sökningen till namnet på programmet.
--moniker Begränsar sökningen till den moniker som anges för programmet.
-s, --source Begränsar sökningen till det angivna källnamnet. Måste följas av källnamnet.
--tag Begränsar sökningen till taggen som anges för programmet.
--cmd, --command Begränsar sökningen till kommandot för programmet.
-e, --exact Använder den exakta strängen i frågan, inklusive att kontrollera skiftlägeskänslighet. Den använder inte standardbeteendet för en delsträng.
--header Valfritt Windows-Package-Manager REST-källhuvud för HTTP.
--authentication-mode Ange inställningar för autentiseringsfönster (tyst, tystFörhandsvald eller interaktivt).
--authentication-account Ange det konto som ska användas för autentisering.
--accept-source-agreements Används för att acceptera källlicensavtalet och undvika uppmaningen.
-?, --help Få ytterligare hjälp med det här kommandot.
--wait Uppmanar användaren att trycka på valfri tangent innan den avslutas.
--logs, --open-logs Öppna standardloggplatsen.
--verbose, --verbose-logs Används för att åsidosätta loggningsinställningen och skapa en utförlig logg.
--nowarn, --ignore-warnings Undertrycker varningsutdata.
--disable-interactivity Inaktivera interaktiva frågor.
--proxy Ange en proxy som ska användas för den här körningen.
--no-proxy Inaktivera användningen av proxy för den här körningen.

Exempel

I följande exempel visas alla aktuella stift.

winget pin list

I följande exempel visas ett specifikt paket pin.

winget pin list --id Microsoft.PowerToys

nollställa

Återställningsunderkommandot återställer alla stift.

Om du använder den här underkommandot utan argumentet --force visas de stift som skulle tas bort.

Om du vill återställa alla stift inkluderar du argumentet --force.

Användning:

winget pin reset [<options>]

Alternativ

Alternativen låter dig anpassa återställningsstift för att möta dina behov.

Alternativ Beskrivning
--force Kör kommandot direkt och fortsätt med frågor som inte rör säkerhet.
-s, --source Begränsar sökningen till det angivna källnamnet. Måste följas av källnamnet.
-?, --help Få ytterligare hjälp med det här kommandot.
--wait Uppmanar användaren att trycka på valfri tangent innan den avslutas.
--logs, --open-logs Öppna standardloggplatsen.
--verbose, --verbose-logs Används för att åsidosätta loggningsinställningen och skapa en utförlig logg.
--nowarn, --ignore-warnings Undertrycker varningsutdata.
--disable-interactivity Inaktivera interaktiva frågor.
--proxy Ange en proxy som ska användas för den här körningen.
--no-proxy Inaktivera användningen av proxy för den här körningen.

Exempel

I följande exempel visas alla stift som skulle återställas.

winget pin reset

I följande exempel återställs alla befintliga stift.

winget pin reset --force