pin příkaz (winget)

Příkaz wingetpin umožňuje omezit Windows Správce balíčků z upgradu balíčku na konkrétní rozsahy verzí nebo může zabránit jeho úplnému upgradu. Připnutý balíček může být stále upgrade sám o sobě a upgradován mimo Windows Správce balíčků.

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 zablokovaný winget upgrade --all nebo winget upgrade <package>, budete muset odepnout balíček, aby WinGet provést .upgrade Tuto --force možnost lze použít k přepsání pinchování uživatele.

• 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. Tuto --force možnost lze použít k přepsání pinchování uživatele.

Použití

winget pin <subcommand> <options>

Možnosti

K dispozici jsou tyto možnosti.

Možnost	Popis
-?, --help	Získá další nápovědu k tomuto příkazu.
--wait	Před ukončením vyzve uživatele, aby stiskl libovolnou klávesu.
--logs, --open-logs	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	Potlačí varovné výstupy.
--disable-interactivity	Zakažte interaktivní výzvy.
--proxy	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
add	Přidat novou pin.
remove	Odeberte balíček pin.
list	Výpis aktuálních špendlíků
reset	Resetování kolíků

přidat

Podpříkaz add přidá nový pin. Tento dílčí příkaz vyžaduje, abyste zadali přesný balíček pro pin. Pokud existuje nějaká nejednoznačnost, zobrazí se výzva k dalšímu filtrování podpříkazu add na přesnou aplikaci.

Použití:

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

Argumenty

Důvod	Popis
-q, --query	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.
--name	Omezí vyhledávání na název aplikace.
--moniker	Omezí vyhledávání na moniker uvedený pro aplikaci.
--tag	Omezí vyhledávání na značku uvedenou pro aplikaci.
--cmd, --command	Omezuje vyhledávání na příkaz aplikace.
-e, --exact	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, --version	Umožňuje určit přesnou verzi pro pin. Zástupný znak * lze použít jako poslední část verze. Změní pin chování.gating
-s, --source	Omezí hledání na zadaný název zdroje. Musí následovat název zdroje.
--header	Volitelná hlavička HTTP zdroje REST pro Windows -Package-Manager.
--authentication-mode	Zadejte předvolbu ověřovacího okna (tiché, silentPreferred nebo interaktivní).
--authentication-account	Zadejte účet, který se má použít k ověřování.
--accept-source-agreements	Používá se k přijetí licenční smlouvy zdroje a vyhnutí se zobrazení výzvy.
--force	Příkaz spusťte přímo a pokračujte problémy nesouvisenými se zabezpečením.
--blocking	Zablokujte upgrade, dokud pin se neodebere, což brání přepsání argumentů. Změní pin chování.blocking
--installed	Připnutí konkrétní nainstalované verze
-?, --help	Získejte další nápovědu k tomuto příkazu.
--wait	Před ukončením vyzve uživatele, aby stiskl libovolnou klávesu.
--logs, --open-logs	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	Potlačí varovné výstupy.
--disable-interactivity	Zakažte interaktivní výzvy.
--proxy	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á pin aplikaci. Přidáním tohoto pin balíčku zabráníte 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á blokování pin pro aplikaci pomocí jeho ID. Přidání blokování pin zabrání upgradu tohoto balíčku při volání winget upgrade --all nebo winget upgrade <package>. Budete muset odblokovat balíček, aby WinGet provedl .upgrade

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

Následující příklad přidá gating pin pro aplikaci pomocí jeho ID. Přidáním gatingu pin zabráníte upgradům, které upgrade verze balíčku mimo konkrétní verzi nebo chráněného rozsahu zástupných znaků.

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

odebrat

Podpříkaz remove odebere .pin Tento dílčí příkaz vyžaduje, abyste zadali přesný balíček pin , který chcete odebrat. Pokud existuje nějaká nejednoznačnost, zobrazí se výzva k dalšímu filtrování podpříkazu remove na přesnou aplikaci.

Použití:

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

Argumenty

Důvod	Popis
-q, --query	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.
--name	Omezí vyhledávání na název aplikace.
--moniker	Omezí vyhledávání na moniker uvedený pro aplikaci.
-s, --source	Omezí hledání na zadaný název zdroje. Musí následovat název zdroje.
--tag	Omezí vyhledávání na značku uvedenou pro aplikaci.
--cmd, --command	Omezuje vyhledávání na příkaz aplikace.
-e, --exact	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.
--header	Volitelná hlavička HTTP zdroje REST pro Windows -Package-Manager.
--authentication-mode	Zadejte předvolbu ověřovacího okna (tiché, silentPreferred nebo interaktivní).
--authentication-account	Zadejte účet, který se má použít k ověřování.
--accept-source-agreements	Používá se k přijetí licenční smlouvy zdroje a vyhnutí se zobrazení výzvy.
--installed	Připněte konkrétní nainstalovanou verzi.
-?, --help	Získejte další nápovědu k tomuto příkazu.
--wait	Před ukončením vyzve uživatele, aby stiskl libovolnou klávesu.
--logs, --open-logs	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	Potlačí varovné výstupy.
--disable-interactivity	Zakažte interaktivní výzvy.
--proxy	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 pin aplikaci.

winget pin remove powertoys

Následující příklad odebere pin aplikaci pomocí id aplikace.

winget pin remove --id Microsoft.PowerToys

seznam

V podpříkazu list jsou uvedeny všechny aktuální špendlíky.

Použití:

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

Argumenty

Důvod	Popis
-q, --query	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.
--name	Omezí vyhledávání na název aplikace.
--moniker	Omezí vyhledávání na moniker uvedený pro aplikaci.
-s, --source	Omezí hledání na zadaný název zdroje. Musí následovat název zdroje.
--tag	Omezí vyhledávání na značku uvedenou pro aplikaci.
--cmd, --command	Omezuje vyhledávání na příkaz aplikace.
-e, --exact	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.
--header	Volitelná hlavička HTTP zdroje REST pro Windows -Package-Manager.
--authentication-mode	Zadejte předvolbu ověřovacího okna (tiché, silentPreferred nebo interaktivní).
--authentication-account	Zadejte účet, který se má použít k ověřování.
--accept-source-agreements	Používá se k přijetí licenční smlouvy zdroje a vyhnutí se zobrazení výzvy.
-?, --help	Získejte další nápovědu k tomuto příkazu.
--wait	Před ukončením vyzve uživatele, aby stiskl libovolnou klávesu.
--logs, --open-logs	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	Potlačí varovné výstupy.
--disable-interactivity	Zakažte interaktivní výzvy.
--proxy	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 uvádí konkrétní balíček pin.

winget pin list --id Microsoft.PowerToys

obnovit

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
--force	Příkaz spusťte přímo a pokračujte problémy nesouvisenými se zabezpečením.
-s, --source	Omezí hledání na zadaný název zdroje. Musí následovat název zdroje.
-?, --help	Získejte další nápovědu k tomuto příkazu.
--wait	Před ukončením vyzve uživatele, aby stiskl libovolnou klávesu.
--logs, --open-logs	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	Potlačí varovné výstupy.
--disable-interactivity	Zakažte interaktivní výzvy.
--proxy	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