Sdílet prostřednictvím

Použití WinGetu k instalaci a správě aplikací

WinGet je nástroj příkazového řádku, který uživatelům umožňuje zjišťovat, instalovat, upgradovat, odebírat a konfigurovat aplikace na počítačích s Windows 10, Windows 11 a Windows Serverem 2025. Tento nástroj je klientské rozhraní pro službu Správce balíčků systému Windows.

Instalace balíčku WinGet

WinGet Správce balíčků systému Windows je k dispozici ve Windows 11, moderních verzích Windows 10 a Windows Serveru 2025 jako součást Instalačního programu aplikací. Instalační služba aplikace je systémová komponenta dodávaná a aktualizovaná Microsoft Storem v desktopových verzích Windows a prostřednictvím aktualizací v systému Windows Server 2025.

Poznámka:

Nástroj příkazového řádku WinGet se podporuje jenom ve Windows 10 verze 1809 (build 17763) nebo novějším. Program WinGet nebude k dispozici, dokud se poprvé nepřihlásíte do Windows jako uživatel, což způsobí, že Microsoft Store zaregistruje Správce balíčků Windows jako součást asynchronního procesu. Pokud jste se nedávno přihlásili jako uživatel poprvé a zjistili, že WinGet ještě není k dispozici, můžete otevřít PowerShell a zadat následující příkaz, který požádá o tuto registraci WinGet: Add-AppxPackage -RegisterByFamilyName -MainPackage Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.

Instalace verze WinGet Preview [Pouze vývojáři]

WinGet je součástí instalačního programu aplikace. Pokud chcete vyzkoušet nejnovější funkce Správce balíčků systému Windows, můžete nainstalovat build Preview jedním z následujících způsobů:

  • Stáhněte si nejnovější verzi WinGet Preview. Přečtěte si poznámky k verzi WinGet Preview a seznamte se s novými funkcemi. Instalací tohoto balíčku získáte verzi Preview klienta WinGet, ale nepovolí se automatické aktualizace nových verzí Preview z Microsoft Storu.

  • Pomocí účtu Microsoft (MSA), pracovního, školního nebo účtu Azure Active Directory (AAD) si zaregistrujte program Windows Insider v kanárských nebo vývojářských kanálech. Kanály Windows Insider Canary a Dev Channels zahrnují automatické aktualizace nových verzí WinGet ve verzi Preview z Microsoft Storu.

  • Pomocí účtu Microsoft (MSA) se zaregistrujte do programu Windows Package Manager Insiders . Po přidání účtu Microsoft (MSA) (několik dní po přijetí e-mailového oznámení) budete dostávat automatické aktualizace nových verzí Preview z Microsoft Storu.

Instalace WinGet ve Windows Sandboxu

Sandbox ve Windows poskytuje jednoduché desktopové prostředí pro bezpečné spouštění aplikací izolovaně. Software nainstalovaný v prostředí Sandbox windows zůstává "v izolovaném prostoru" a běží odděleně od hostitelského počítače. Windows Sandbox neobsahuje WinGet ani aplikaci Microsoft Store, takže si budete muset stáhnout nejnovější balíček WinGet ze stránky vydaných verzí WinGet na GitHubu nebo použít rutinu Repair-WinGetPackageManager.

Pokud chcete nainstalovat stabilní verzi wingetu ve Windows Sandboxu, postupujte podle těchto kroků z příkazového řádku Windows PowerShellu:

$progressPreference = 'silentlyContinue'
Write-Host "Installing WinGet PowerShell module from PSGallery..."
Install-PackageProvider -Name NuGet -Force | Out-Null
Install-Module -Name Microsoft.WinGet.Client -Force -Repository PSGallery | Out-Null
Write-Host "Using Repair-WinGetPackageManager cmdlet to bootstrap WinGet..."
Repair-WinGetPackageManager -AllUsers
Write-Host "Done."

K instalaci modulu WinGet PowerShell v rozsahu počítače můžete použít parametr -Scope AllUsers s příkazem Install-Module. Pokud chcete verzi WinGet ve verzi Preview, můžete parametr přidat -IncludePrerelease pomocí rutiny Repair-WinGetPackageManager. Pokud chcete zobrazit dostupné parametry pro rutinu Repair-WinGetPackageManager, můžete spustit Get-Help Repair-WinGetPackageManager -Full.

Další informace o sandboxu Windows, včetně toho, jak nainstalovat sandbox a co očekávat od jeho využití, najdete v dokumentaci k Windows Sandboxu.

Úvahy správce

Chování instalačního programu se může lišit v závislosti na tom, jestli používáte WinGet s oprávněními správce.

  • Při spuštění programu WinGet bez oprávnění správce můžou některé aplikace vyžadovat zvýšení oprávnění k instalaci. Po spuštění instalačního programu vás systém Windows vyzve, abyste zvýšili oprávnění. Pokud se rozhodnete nezvýšit oprávnění, aplikaci se nepodaří nainstalovat.

  • Při spuštění programu WinGet v příkazovém řádku správce se nezobrazí výzvy ke zvýšení oprávnění , pokud ji aplikace vyžaduje. Při spouštění příkazového řádku jako správce vždy buďte opatrní a nainstalujte jenom aplikace, kterým důvěřujete.

Použijte WinGet

Po instalaci instalačního programu aplikace můžete spustit WinGet zadáním winget z příkazového řádku.

Jedním z nejběžnějších scénářů použití je vyhledání a instalace oblíbeného nástroje.

  1. Pokud chcete nástroj vyhledat, zadejte winget search <appname>.

  2. Po potvrzení, že je nástroj, který chcete, je k dispozici, můžete nástroj nainstalovat zadáním winget install <appname>. Nástroj WinGet spustí instalační program a nainstaluje aplikaci do počítače. příkazového řádku winget

  3. Kromě instalace a vyhledávání poskytuje WinGet řadu dalších příkazů, které umožňují zobrazit podrobnosti o aplikacích, změnách zdrojů a ověřování balíčků. Pokud chcete získat úplný seznam příkazů, zadejte: winget --help. winget nápovědy

Někteří uživatelé hlásili problémy s tím, že klient není na jejich PATH.

Příkazy

Aktuální náhled nástroje WinGet podporuje následující příkazy.

Příkaz Popis
nainstalovat Nainstaluje zadanou aplikaci.
zobrazit Zobrazí podrobnosti pro zadanou aplikaci.
zdroj Přidá, odebere a aktualizuje úložiště Správce balíčků systému Windows, ke které přistupuje WinGet.
hledání Vyhledá aplikaci.
seznam Zobrazí nainstalované balíčky.
aktualizace Upgraduje zadanou aplikaci.
odinstalovat Odinstaluje zadanou aplikaci.
hash Vygeneruje hodnotu hash SHA256 pro instalační program.
ověření Ověří soubor manifestu pro odeslání do úložiště Správce balíčků systému Windows.
nastavení Otevřete nastavení.
funkce Zobrazuje stav experimentálních funkcí.
exportu Exportuje seznam nainstalovaných balíčků.
importu Nainstaluje všechny balíčky do souboru.
špendlík Správa připnutí balíčků
konfigurovat Nakonfiguruje systém do požadovaného stavu.
stáhnout Stáhne instalační program zadané aplikace.
repair Opraví vybranou aplikaci.
dscv3 Příkazy pro prostředky služby Desired State Configuration (DSC) v3 v PowerShellu.

Možnosti

Nástroj WinGet podporuje následující možnosti.

Možnost Popis
-v, --version Vrátí aktuální verzi WinGetu.
--informace Poskytuje všechny podrobné informace o WinGetu, včetně odkazů na licenci, prohlášení o ochraně soukromí a nakonfigurovaných zásad skupiny.
-?--Pomoc Zobrazuje další nápovědu pro WinGet.
--Počkej Před ukončením vyzve uživatele, aby stiskl libovolnou klávesu.
--logy,--otevřít-logy Otevře výchozí umístění protokolů.
--verbose,--verbose-logs Umožňuje verbosní protokolování pro winget.
--nowarn,--ignore-warnings (bez varování, ignorovat varování) Potlačí varovné výstupy.
--zakázat-interaktivitu Zakáže interaktivní výzvy.
--proxy Nastaví proxy server, který se má použít pro toto spuštění.
--no-proxy Zakáže použití proxy serveru pro toto spuštění.

Podporované formáty instalačního programu

WinGet podporuje následující typy instalačních programů:

  • EXE (s příznaky Silent a SilentWithProgress)
  • ZIP
  • INNO
  • NULLSOFT
  • MSI
  • WIX
  • APPX
  • MSIX
  • HOŘET
  • PŘENOSNÝ

Skriptování balíčku WinGet

Modul PowerShell Microsoft.WinGet.Client je k dispozici v PowerShell Gallery.

Ladění a řešení potíží

WinGet poskytuje protokolování, které pomáhá diagnostikovat problémy. Informace o řešení potíží a podrobnosti o protokolování najdete v tématu Ladění a řešení potíží.

Chybějící nástroje

Pokud úložiště komunity neobsahuje váš nástroj nebo aplikaci, odešlete balíček do našeho úložiště. Přidáním svého oblíbeného nástroje ho budete mít k dispozici vy i ostatní.

Přizpůsobení nastavení WinGetu

Můžete nakonfigurovat příkazový řádek WinGet úpravou souborusettings.json. Další informace najdete na stránce příkazu nastavení.

Podrobnosti o open source

Nástroj WinGet je open source software dostupný na GitHubu v úložišti https://github.com/microsoft/winget-cli/. Zdroj pro sestavení klienta se nachází ve složce src.

Zdroj pro WinGet je součástí řešení Visual Studio 2022 C++. Pokud chcete správně sestavit řešení, naklonujte úložiště a spusťte příslušný konfigurační soubor WinGet umístěný v adresáři .github.

Doporučujeme vám přispívat ke zdroji WinGet na GitHubu. Musíte nejprve souhlasit a podepsat Microsoft CLA. Žádosti o přijetí změn by měly pocházet z větve ve vašem vlastním forku.

Řešení problémů

Úložiště winget-cli udržuje seznam běžných problémů a běžných chyb spolu s doporučeními, jak vyřešit: