Příkaz PIN (WinSet)

Příkaz wingetpin umožňuje omezit Správce balíčků systému Windows upgrade balíčku na konkrétní rozsahy verzí nebo může zabránit jeho úplnému upgradu. Připnutý balíček se může upgradovat samostatně a upgradovat ho mimo Správce balíčků systému Windows.

Typy připnutí

WinGet podporuje tři typy pinů balíčků:

• připnutí: Balíček je vyloučen z winget upgrade --all, ale umožňuje winget upgrade <package>. Pomocí argumentu --include-pinned můžete umožnit winget upgrade --all zahrnout připnuté balíčky.

• blokování: Balíček je blokován z winget upgrade --all nebo winget upgrade <package>, budete muset odepnout balíček, aby mohl WinGet provést upgrade. Možnost --force lze použít k přepsání chování špendlíku.

• Gating: Balíček je připnutý ke konkrétní verzi nebo rozsahu verzí. Můžete zadat přesnou verzi, ke které chcete balíček připnout, nebo můžete použít zástupný znak * jako poslední část verze k určení rozsahu verzí. Pokud je například balíček připnutý k 1.2.*verze, považuje se za platnou libovolnou verzi mezi 1.2.0 na 1.2.x. Možnost --force lze použít k přepsání chování špendlíku.

Použití

winget pin <subcommand> <options>

Možnosti

K dispozici jsou tyto možnosti.

Možnost	Popis
-?--Pomoc	Získá další nápovědu k tomuto příkazu.
--Počkej	Před ukončením vyzve uživatele, aby stiskl libovolnou klávesu.
--logy,--otevřít-logy	Otevřete výchozí umístění protokolů.
--verbose, --verbose-logs	Slouží k přenastavení nastavení protokolování a vytvoření podrobného protokolu.
--nowarn,--ignore-warnings (bez varování, ignorovat varování)	Potlačí varovné výstupy.
--zakázat-interaktivitu	Zakažte interaktivní výzvy.
--plná moc	Nastavte proxy server, který se má použít pro toto spuštění.
--no-proxy	Zakažte použití proxy serveru pro toto spuštění.

Podpříkazy

Příkaz pin podporuje následující dílčí příkazy.

Podpříkaz	Popis
přidat	Přidejte nový špendlík.
odebrat	Odeberte špendlík balíčku.
seznam	Výpis aktuálních špendlíků
resetování	Resetování kolíků

přidat

přidat dílčí příkaz přidá nový pin. Tento dílčí příkaz vyžaduje, abyste zadali přesný balíček, který se má připnout. Pokud existuje nějaká nejednoznačnost, zobrazí se výzva k dalšímu filtrování přidání podpříkazu do přesné aplikace.

Použití:

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

Argumenty

Důvod	Popis
-q,--dotaz	Dotaz použitý k vyhledání aplikace.

Možnosti

Možnosti umožňují přizpůsobit přidávání špendlíků tak, aby vyhovovaly vašim potřebám.

Možnost	Popis
--id	Omezuje vyhledávání na ID aplikace.
--Jméno	Omezí vyhledávání na název aplikace.
--přezdívka	Omezí vyhledávání na moniker uvedený pro aplikaci.
--značka	Omezí vyhledávání na značku uvedenou pro aplikaci.
--cmd, --příkaz	Omezuje vyhledávání na příkaz aplikace.
-e, --přesný	Používá přesný řetězec v dotazu, včetně zohlednění citlivosti na malá a velká písmena. Nebude používat výchozí chování podřetězího řetězce.
-v, --verze	Umožňuje zadat přesnou verzi, která se má připnout. Zástupný znak * lze použít jako poslední část verze. Změní chování připnutí tak, aby bylo gating.
-s, --zdroj	Omezí hledání na zadaný název zdroje. Musí následovat název zdroje.
--záhlaví	Volitelná hlavička HTTP zdroje REST pro Windows -Package-Manager.
--režim ověřování	Zadejte předvolbu ověřovacího okna (tiché, silentPreferred nebo interaktivní).
--authentizační-účet	Zadejte účet, který se má použít k ověřování.
--přijmout-dohody-o-zdroji	Používá se k přijetí licenční smlouvy zdroje a vyhnutí se zobrazení výzvy.
--síla	Příkaz spusťte přímo a pokračujte problémy nesouvisenými se zabezpečením.
– blokování	Zablokujte upgrade, dokud se pin neodebere, což brání přepsání argumentů. Změní chování připnutí tak, aby bylo blocking.
– nainstalované	Připnutí konkrétní nainstalované verze
-?--Pomoc	Získejte další nápovědu k tomuto příkazu.
--Počkej	Před ukončením vyzve uživatele, aby stiskl libovolnou klávesu.
--protokoly, --otevřené protokoly	Otevřete výchozí umístění protokolů.
--verbose, --verbose-logs	Slouží k přenastavení nastavení protokolování a vytvoření podrobného protokolu.
--nowarn,--ignore-warnings (bez varování, ignorovat varování)	Potlačí varovné výstupy.
--zakázat-interaktivitu	Zakažte interaktivní výzvy.
--plná moc	Nastavte proxy server, který se má použít pro toto spuštění.
--no-proxy	Zakažte použití proxy serveru pro toto spuštění.

Příklady

Následující příklad přidá špendlík pro aplikaci. Přidání tohoto pin kódu zabrání upgradu tohoto balíčku při volání winget upgrade --all. Pokud chcete zahrnout všechny připnuté balíčky, použijte argument --include-pinned s winget upgrade --all.

winget pin add powertoys

Následující příklad přidá blokující pin pro aplikaci pomocí jeho ID. Přidání blokujícího špendlíku zabrání upgradu tohoto balíčku při volání winget upgrade --all nebo winget upgrade <package>. Balíček budete muset odblokovat, aby mohl WinGet provést upgrade.

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

Následující příklad přidá kolík gating pro aplikaci pomocí jeho ID. Přidání kolíku gating zabrání upgradům, které upgradují verzi balíčku mimo určitou verzi nebo zamknutý rozsah zástupných znaků.

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

odstranit

odebere dílčí příkaz odebere špendlík. Tento dílčí příkaz vyžaduje, abyste zadali přesný pin kód balíčku, který se má odebrat. Pokud existuje nějaká nejednoznačnost, zobrazí se výzva k dalšímu filtrování odebrání podpříkazu pro přesnou aplikaci.

Použití:

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

Argumenty

Důvod	Popis
-q,--dotaz	Dotaz použitý k vyhledání aplikace.

Možnosti

Možnosti umožňují přizpůsobit odebírání špendlíků tak, aby vyhovovaly vašim potřebám.

Možnost	Popis
--id	Omezuje vyhledávání na ID aplikace.
--Jméno	Omezí vyhledávání na název aplikace.
--přezdívka	Omezí vyhledávání na moniker uvedený pro aplikaci.
-s, --zdroj	Omezí hledání na zadaný název zdroje. Musí následovat název zdroje.
--značka	Omezí vyhledávání na značku uvedenou pro aplikaci.
--cmd, --příkaz	Omezuje vyhledávání na příkaz aplikace.
-e, --přesný	Používá přesný řetězec v dotazu, včetně zohlednění citlivosti na malá a velká písmena. Nebude používat výchozí chování podřetězího řetězce.
--záhlaví	Volitelná hlavička HTTP zdroje REST pro Windows -Package-Manager.
--režim ověřování	Zadejte předvolbu ověřovacího okna (tiché, silentPreferred nebo interaktivní).
--authentizační-účet	Zadejte účet, který se má použít k ověřování.
--přijmout-dohody-o-zdroji	Používá se k přijetí licenční smlouvy zdroje a vyhnutí se zobrazení výzvy.
– nainstalované	Připněte konkrétní nainstalovanou verzi.
-?--Pomoc	Získejte další nápovědu k tomuto příkazu.
--Počkej	Před ukončením vyzve uživatele, aby stiskl libovolnou klávesu.
--protokoly, --otevřené protokoly	Otevřete výchozí umístění protokolů.
--verbose, --verbose-logs	Slouží k přenastavení nastavení protokolování a vytvoření podrobného protokolu.
--nowarn,--ignore-warnings (bez varování, ignorovat varování)	Potlačí varovné výstupy.
--zakázat-interaktivitu	Zakažte interaktivní výzvy.
--plná moc	Nastavte proxy server, který se má použít pro toto spuštění.
--no-proxy	Zakažte použití proxy serveru pro toto spuštění.

Příklady

Následující příklad odebere špendlík pro aplikaci.

winget pin remove powertoys

Následující příklad odebere špendlík pro aplikaci pomocí jeho ID.

winget pin remove --id Microsoft.PowerToys

seznam

Seznam dílčíchpříkazů obsahuje všechny aktuální špendlíky.

Použití:

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

Argumenty

Důvod	Popis
-q,--dotaz	Dotaz použitý k vyhledání aplikace.

Možnosti

Možnosti umožňují přizpůsobit výpis špendlíků tak, aby vyhovovaly vašim potřebám.

Možnost	Popis
--id	Omezuje vyhledávání na ID aplikace.
--Jméno	Omezí vyhledávání na název aplikace.
--přezdívka	Omezí vyhledávání na moniker uvedený pro aplikaci.
-s, --zdroj	Omezí hledání na zadaný název zdroje. Musí následovat název zdroje.
--značka	Omezí vyhledávání na značku uvedenou pro aplikaci.
--cmd, --příkaz	Omezuje vyhledávání na příkaz aplikace.
-e, --přesný	Používá přesný řetězec v dotazu, včetně zohlednění citlivosti na malá a velká písmena. Nebude používat výchozí chování podřetězího řetězce.
--záhlaví	Volitelná hlavička HTTP zdroje REST pro Windows -Package-Manager.
--režim ověřování	Zadejte předvolbu ověřovacího okna (tiché, silentPreferred nebo interaktivní).
--authentizační-účet	Zadejte účet, který se má použít k ověřování.
--přijmout-dohody-o-zdroji	Používá se k přijetí licenční smlouvy zdroje a vyhnutí se zobrazení výzvy.
-?--Pomoc	Získejte další nápovědu k tomuto příkazu.
--Počkej	Před ukončením vyzve uživatele, aby stiskl libovolnou klávesu.
--protokoly, --otevřené protokoly	Otevřete výchozí umístění protokolů.
--verbose, --verbose-logs	Slouží k přenastavení nastavení protokolování a vytvoření podrobného protokolu.
--nowarn,--ignore-warnings (bez varování, ignorovat varování)	Potlačí varovné výstupy.
--zakázat-interaktivitu	Zakažte interaktivní výzvy.
--plná moc	Nastavte proxy server, který se má použít pro toto spuštění.
--no-proxy	Zakažte použití proxy serveru pro toto spuštění.

Příklady

Následující příklad obsahuje seznam všech aktuálních špendlíků.

winget pin list

Následující příklad obsahuje konkrétní pin kód balíčku.

winget pin list --id Microsoft.PowerToys

resetovat

Podpříkaz resetování resetuje všechny špendlíky.

Použití tohoto podpříkazu bez argumentu --force zobrazí špendlíky, které by byly odebrány.

Pokud chcete resetovat všechny špendlíky, zahrňte argument --force.

Použití:

winget pin reset [<options>]

Možnosti

Tyto možnosti vám umožňují přizpůsobit resetovací kolíky tak, aby vyhovovaly vašim potřebám.

Možnost	Popis
--síla	Příkaz spusťte přímo a pokračujte problémy nesouvisenými se zabezpečením.
-s, --zdroj	Omezí hledání na zadaný název zdroje. Musí následovat název zdroje.
-?--Pomoc	Získejte další nápovědu k tomuto příkazu.
--Počkej	Před ukončením vyzve uživatele, aby stiskl libovolnou klávesu.
--protokoly, --otevřené protokoly	Otevřete výchozí umístění protokolů.
--verbose, --verbose-logs	Slouží k přenastavení nastavení protokolování a vytvoření podrobného protokolu.
--nowarn,--ignore-warnings (bez varování, ignorovat varování)	Potlačí varovné výstupy.
--zakázat-interaktivitu	Zakažte interaktivní výzvy.
--plná moc	Nastavte proxy server, který se má použít pro toto spuštění.
--no-proxy	Zakažte použití proxy serveru pro toto spuštění.

Příklady

Následující příklad ukazuje všechny špendlíky, které by se resetovaly.

winget pin reset

Následující příklad resetuje všechny existující špendlíky.

winget pin reset --force