Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
WinGet to narzędzie wiersza polecenia umożliwiające użytkownikom odnajdywanie, instalowanie, uaktualnianie, usuwanie i konfigurowanie aplikacji na komputerach Windows 10, Windows 11 i Windows Server 2025. To narzędzie jest interfejsem klienta usługi Windows Package Manager.
Instalowanie narzędzia WinGet
WinGet Windows Package Manager jest dostępny w Windows 11, nowoczesnych wersjach Windows 10 i Windows Server 2025 w ramach instalatora App. Instalator aplikacji App jest składnikiem systemu dostarczanym i aktualizowanym przez sklep Microsoft w wersjach programu Windows Desktop oraz za pośrednictwem aktualizacji w Windows Server 2025 r.
Uwaga / Notatka
Narzędzie wiersza polecenia WinGet jest obsługiwane tylko w Windows 10 wersji 1809 (kompilacja 17763) lub nowsza. Usługa WinGet nie będzie dostępna, dopóki nie zalogujesz się do systemu Windows jako użytkownik po raz pierwszy, co wywoła w sklepie Microsoft Store rejestrację Windows Package Manager jako część procesu asynchronicznego. Jeśli ostatnio zalogowałeś się jako użytkownik po raz pierwszy i okaże się, że WinGet nie jest jeszcze dostępny, możesz otworzyć program PowerShell i wprowadzić następujące polecenie, aby zarejestrować WinGet: Add-AppxPackage -RegisterByFamilyName -MainPackage Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.
Instalowanie wersji zapoznawczej WinGet [Tylko deweloperzy]
WinGet jest uwzględniony w Instalatorze aplikacji. Aby wypróbować najnowsze funkcje Windows Package Manager, możesz zainstalować jedną z następujących metod kompilacji w wersji zapoznawczej:
Pobierz najnowszą wersję zapoznawcza winGet. Przeczytaj informacje o wersji zapoznawczej usługi WinGet , aby dowiedzieć się więcej o nowych funkcjach. Zainstalowanie tego pakietu spowoduje wyświetlenie wersji zapoznawczej klienta WinGet, ale nie spowoduje włączenia automatycznych aktualizacji nowych wersji zapoznawczych ze Sklepu Microsoft.
Użyj konta Microsoft (MSA), służbowego lub konta Azure Active Directory (AAD), aby zarejestrować się w programie Windows Insider w kanałach Canary lub Dev Channels. Kanały Windows Insider Canary i Dev Channel obejmują automatyczne aktualizacje nowych wersji zapoznawczych WinGet ze Sklepu Microsoft.
Instalowanie narzędzia WinGet w Windows Sandbox
Windows Piaskownica zapewnia lekkie środowisko pulpitu do bezpiecznego uruchamiania aplikacji w izolacji. Oprogramowanie zainstalowane w środowisku piaskownicy Windows pozostaje "w trybie piaskownicy" i działa oddzielnie od maszyny hosta. Windows Sandbox nie zawiera narzędzia WinGet ani aplikacji Sklep Microsoft, dlatego należy pobrać najnowszy pakiet WinGet ze strony wersji WinGet na GitHub, lub użyć polecenia cmdlet Repair-WinGetPackageManager.
Aby zainstalować stabilną wersję narzędzia WinGet w piaskownicy Windows, wykonaj następujące kroki w wierszu polecenia programu PowerShell Windows:
$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."
Aby zainstalować moduł WinGet PowerShell w trybie ogólnosystemowym, możesz użyć parametru -Scope AllUsers z poleceniem Install-Module. Jeśli chcesz wersję zapoznawcza winGet, możesz dodać -IncludePrerelease parametr za pomocą polecenia cmdlet Repair-WinGetPackageManager. Aby wyświetlić dostępne parametry polecenia cmdlet Repair-WinGetPackageManager, możesz uruchomić polecenie Get-Help Repair-WinGetPackageManager -Full.
Aby uzyskać więcej informacji na temat piaskownicy Windows, w tym sposobu instalowania piaskownicy i oczekiwanego użycia, zobacz dokumentację Windows Piaskownica.
Zagadnienia dotyczące administratora
Zachowanie instalatora może się różnić w zależności od tego, czy używasz usługi WinGet z uprawnieniami administratora.
W przypadku uruchamiania narzędzia WinGet bez uprawnień administratora niektóre aplikacje mogą wymagać podniesienia uprawnień do zainstalowania. Po uruchomieniu instalatora Windows wyświetli monit o podniesienie uprawnień. Jeśli zdecydujesz się nie podnieść poziomu uprawnień, instalacja aplikacji zakończy się niepowodzeniem.
Podczas uruchamiania narzędzia WinGet w wierszu polecenia administratora nie będą wyświetlane monity o podniesienie uprawnień , jeśli aplikacja tego wymaga. Zawsze należy zachować ostrożność podczas uruchamiania wiersza polecenia jako administrator i instalować tylko zaufane aplikacje.
Korzystanie z narzędzia WinGet
Po zainstalowaniu Instalatora aplikacji można uruchomić narzędzie WinGet , wpisując polecenie "winget" w wierszu polecenia.
Jednym z najbardziej typowych scenariuszy użycia jest wyszukiwanie i instalowanie ulubionego narzędzia.
Aby wyszukać narzędzie, wpisz
winget search <appname>.Po potwierdzeniu, że żądane narzędzie jest dostępne, możesz zainstalować narzędzie, wpisując
winget install <appname>. Narzędzie WinGet uruchomi instalator i zainstaluje aplikację na komputerze.
Oprócz instalowania i wyszukiwania usługa WinGet udostępnia wiele innych poleceń, które umożliwiają wyświetlanie szczegółów dotyczących aplikacji, źródeł zmian i weryfikowania pakietów. Aby uzyskać pełną listę poleceń, wpisz:
winget --help.
Niektórzy użytkownicy zgłaszali problemy z klientem, który nie jest na ich ścieżce.
Komendy
Bieżąca wersja zapoznawcza narzędzia WinGet obsługuje następujące polecenia.
| Komenda | Opis |
|---|---|
| instalacja | Instaluje określoną aplikację. |
| show | Wyświetla szczegóły określonej aplikacji. |
| źródło | Dodaje, usuwa i aktualizuje repozytoria Windows Package Manager dostępne przez WinGet. |
| wyszukiwanie | Wyszukuje aplikację. |
| list | Wyświetlanie zainstalowanych pakietów. |
| uaktualnianie | Uaktualnia daną określoną aplikację. |
| odinstaluj | Odinstalowuje określoną aplikację. |
| skrótu | Generuje skrót SHA256 dla instalatora. |
| weryfikować | Weryfikuje plik manifestu do przesłania do repozytorium Windows Package Manager. |
| Ustawienia | Otwórz ustawienia. |
| funkcje | Pokazuje stan funkcji eksperymentalnych. |
| export | Eksportuje listę zainstalowanych pakietów. |
| import | Instaluje wszystkie pakiety w pliku. |
| pin | Zarządzanie numerami PIN pakietów. |
| konfigurować | Konfiguruje system w żądanym stanie. |
| Pobierz | Pobiera instalator określonej aplikacji. |
| repair | Naprawia wybraną aplikację. |
| dscv3 | Polecenia zasobów programu PowerShell Desired State Configuration (DSC) w wersji 3. |
Opcje
Narzędzie WinGet obsługuje następujące opcje.
| Opcja | Opis |
|---|---|
| -v, --version | Zwraca bieżącą wersję winGet. |
| --info | Zawiera wszystkie szczegółowe informacje na temat winGet, w tym linki do licencji, zasad zachowania poufności informacji i skonfigurowanych zasad grupy. |
| -?, --pomoc | Pokazuje dodatkową pomoc dla WinGet. |
| --czekać | Nakazuje użytkownikowi naciśnięcie dowolnego klawisza przed zakończeniem programu. |
| --dzienniki,--otwórz dzienniki | Otwiera domyślną lokalizację dzienników. |
| --verbose,--verbose-logs | Włącza szczegółowe logowanie dla winget. |
| --nowarn (ignoruj ostrzeżenia), --ignore-warnings (ignoruj ostrzeżenia) | Tłumi komunikaty ostrzeżeń. |
| --wyłącz-interaktywność | Wyłącza interaktywne komunikaty. |
| --proxy | Ustawia serwer proxy do użycia dla tej operacji. |
| --no-proxy | Wyłącza użycie serwera proxy na potrzeby tego wykonania. |
Obsługiwane formaty instalatora
Usługa WinGet obsługuje następujące typy instalatorów:
- EXE (z flagami dyskretnych i SilentWithProgress)
- KOD POCZTOWY
- INNO
- NULLSOFT
- MSI
- WIX
- appx
- MSIX
- palić
- PRZENOŚNY
Skryptowanie WinGet
Moduł Microsoft.WinGet.Client powerShell jest dostępny w PowerShell Gallery.
Debugowanie i rozwiązywanie problemów
Usługa WinGet udostępnia rejestrowanie, aby ułatwić diagnozowanie problemów. Aby uzyskać szczegółowe informacje na temat rejestrowania i rozwiązywania problemów, zobacz Debugowanie i rozwiązywanie problemów.
Brakujące narzędzia
Jeśli repozytorium społeczności nie zawiera twojego narzędzia lub aplikacji, prześlij pakiet do naszego repozytorium. Dodając ulubione narzędzie, będzie ono dostępne dla Ciebie i wszystkich innych.
Dostosowywanie ustawień winGet
Środowisko wiersza polecenia WinGet można skonfigurować, modyfikując plik settings.json . Aby uzyskać więcej informacji, zobacz stronę polecenia ustawienia.
Szczegóły otwartego źródła
Narzędzie WinGet jest oprogramowaniem open source dostępnym na GitHub w repozytorium https://github.com/microsoft/winget-cli/. Źródło do kompilowania klienta znajduje się w folderze src.
Źródło WinGet znajduje się w rozwiązaniu Visual Studio 2022 C++. Aby poprawnie skompilować rozwiązanie, sklonuj repozytorium i uruchom odpowiedni plik konfiguracji WinGet znajdujący się w katalogu ".github".
Zachęcamy do współtworzenia źródła WinGet w GitHub. Najpierw musisz zaakceptować i podpisać umowę CLA firmy Microsoft. Pull requesty powinny pochodzić z gałęzi na własnym forku.
Rozwiązywanie problemów
Repozytorium winget-cli utrzymuje listę typowych problemów i typowych błędów wraz z zaleceniami dotyczącymi rozwiązywania problemów: