Udostępnij przez


Polecenie źródłowe WinGet

Polecenie źródłoweWinGet umożliwia zarządzanie źródłami. Za pomocą polecenia źródłowego można dodawać, wyświetlać, aktualizować, usuwać, resetować lub eksportować źródła WinGet.

Źródło WinGet udostępnia dane umożliwiające odnajdywanie i instalowanie aplikacji. Używaj tylko bezpiecznych, zaufanych źródeł.

WinGet określa następujące trzy domyślne źródła, które można wyświetlić za pomocą polecenia winget source list.

  • msstore — katalog sklepu Microsoft Store.
  • winget — repozytorium Społeczności WinGet dla aplikacji.
  • winget-font — repozytorium Społeczności WinGet dla czcionek.

Zastosowanie

winget source <subcommand> <options>

Pomoc źródłowa zestawu skrzydłowego

Sub-Commands

Dostępne są następujące argumenty.

Sub-Command Opis
dodaj Dodaje nowe źródło.
lista Wyświetla listę bieżących źródeł.
aktualizacja Aktualizuje bieżące źródła.
usuń Usuwa bieżące źródła.
resetowanie Resetuje domyślne źródła msstore, winget i winget-font.
eksport Eksportuje bieżące źródła.

Opcje

Dostępne są następujące opcje.

Opcja Opis
-?,--pomoc Wyświetla pomoc dotyczącą wybranego polecenia.
--czekać Nakazuje użytkownikowi naciśnięcie dowolnego klawisza przed zakończeniem programu.
--dzienniki,--otwórz dzienniki Otwórz domyślną lokalizację dzienników.
--gadatliwy, --gadatliwy-dzienniki Służy do zastępowania ustawienia rejestrowania i tworzenia szczegółowego dziennika.
--nowarn (ignoruj ostrzeżenia), --ignore-warnings (ignoruj ostrzeżenia) Tłumi komunikaty ostrzeżeń.
--wyłącz-interaktywność Wyłącz interaktywne komunikaty.
--proxy Ustaw serwer proxy do użycia na potrzeby tego wykonania.
--no-proxy Wyłącz użycie serwera proxy dla tego wykonania.

dodawać

dodać podpolecenia dodaje nowe źródło. To polecenie wymaga opcji --name i --arg. Ponieważ polecenie zmienia dostęp użytkowników, przy użyciu dodaj wymaga uprawnień administratora.

Użycie:

winget source add [-n] <name> [-a] <arg> [[-t] <type>] [<options>]

Argumenty (w programowaniu)

Dostępne są następujące argumenty.

Argumentacja Opis
-n, --name Nazwa identyfikująca źródło według.
-a, --arg Adres URL lub UNC źródła.
-t, --type Typ źródła.

Opcje

Dostępne są następujące opcje.

Opcja Opis
--poziom zaufania Poziom zaufania źródła (brak lub zaufane).
--nagłówek Opcjonalny nagłówek HTTP dla źródła REST w systemie Windows—Package-Manager.
--accept-source-agreement Używany w celu zaakceptowania pierwotnej umowy licencyjnej i uniknięcia monitu.
--wyraźny
-?, --pomoc Uzyskaj dodatkową pomoc dotyczącą tego polecenia.
--czekać Nakazuje użytkownikowi naciśnięcie dowolnego klawisza przed zakończeniem programu.
--dzienniki,--otwórz dzienniki Otwórz domyślną lokalizację dzienników.
--gadatliwy, --gadatliwy-dzienniki Służy do zastępowania ustawienia rejestrowania i tworzenia szczegółowego dziennika.
--nowarn (ignoruj ostrzeżenia), --ignore-warnings (ignoruj ostrzeżenia) Tłumi komunikaty ostrzeżeń.
--wyłącz-interaktywność Wyłącz interaktywne komunikaty.
--proxy Ustaw serwer proxy do użycia na potrzeby tego wykonania.
--no-proxy Wyłącz użycie serwera proxy dla tego wykonania.

Na przykład winget source add --name Contoso https://www.contoso.com/cache dodaje repozytorium Contoso pod adresem URL https://www.contoso.com/cache.

Opcjonalny parametr typu

Dodanie podpolecenia obsługuje opcjonalny typ , który informuje klienta o typie repozytorium, z którym nawiązuje połączenie. Obsługiwane są następujące typy.

Typ Opis
Microsoft.PreIndexed.Package Domyślny typ źródła.
Microsoft.Rest (Wyspa Microsoftu) Źródło interfejsu API REST firmy Microsoft.

lista

Lista podpolecenia wylicza aktualnie włączone źródła lub zawiera szczegółowe informacje na temat określonego źródła.

Uwaga / Notatka

Gdy źródło ma być jawne, musi być specjalnie ukierunkowane. Źródło czcionki winget-font jest domyślnie ustawione na jawne. Oznacza to, że wszystkie inne polecenia WinGet muszą bezpośrednio odwoływać się do źródła przy użyciu polecenia "-source winget-font" lub "-s winget-font" do dołączenia.

Użycie:

winget source list [[-n] <name>] [<options>]

lista źródłowa zestawu winget

Pseudonimy

Następujące aliasy są dostępne dla tego podpolecenia:

  • Ls

Argumenty (w programowaniu)

Dostępne są następujące argumenty.

Argumentacja Opis
-n, --name Nazwa identyfikująca źródło według.

Opcje

Dostępne są następujące opcje.

Opcja Opis
-?, --pomoc Uzyskaj dodatkową pomoc dotyczącą tego polecenia.
--czekać Nakazuje użytkownikowi naciśnięcie dowolnego klawisza przed zakończeniem programu.
--dzienniki,--otwórz dzienniki Otwórz domyślną lokalizację dzienników.
--gadatliwy, --gadatliwy-dzienniki Służy do zastępowania ustawienia rejestrowania i tworzenia szczegółowego dziennika.
--nowarn (ignoruj ostrzeżenia), --ignore-warnings (ignoruj ostrzeżenia) Tłumi komunikaty ostrzeżeń.
--wyłącz-interaktywność Wyłącz interaktywne komunikaty.
--proxy Ustaw serwer proxy do użycia na potrzeby tego wykonania.
--no-proxy Wyłącz użycie serwera proxy dla tego wykonania.

wyświetl listę wszystkich

Podpolecenia listy , winget source list, zawiera pełną listę skonfigurowanych źródeł:

Name        Argument                                      Explicit
------------------------------------------------------------------
msstore     https://storeedgefd.dsx.mp.microsoft.com/v9.0 false
winget      https://cdn.winget.microsoft.com/cache        false
winget-font https://cdn.winget.microsoft.com/fonts        true

szczegóły źródła listy

Aby uzyskać szczegółowe informacje o źródle, przekaż nazwę źródła. Przykład:

winget source list --name winget

Zwraca następujące dane wyjściowe:

Field       Value
--------------------------------------------------
Name        winget
Type        Microsoft.PreIndexed.Package
Argument    https://cdn.winget.microsoft.com/cache
Data        Microsoft.Winget.Source_8wekyb3d8bbwe
Identifier  Microsoft.Winget.Source_8wekyb3d8bbwe
Trust Level Trusted|StoreOrigin
Explicit    false
Updated     2025-12-11 08:30:25.000
  • Name jest nazwą źródła.
  • Type jest typem źródła.
  • Arg jest adresem URL lub ścieżką używaną przez źródło.
  • Data jest opcjonalną nazwą pakietu, jeśli jest to konieczne.
  • Updated jest ostatnią datą i godziną aktualizacji źródła.

aktualizacja

Aktualizacja podpolecenia wymusza aktualizację pojedynczego źródła lub wszystkich źródeł.

Użycie:

winget source update [[-n] <name>] [<options>]

Pseudonimy

Następujące aliasy są dostępne dla tego podpolecenia:

  • odświeżyć

Argumenty (w programowaniu)

Dostępne są następujące argumenty.

Argumentacja Opis
-n, --name Nazwa identyfikująca źródło według.

Opcje

Dostępne są następujące opcje.

Opcja Opis
-?, --pomoc Uzyskaj dodatkową pomoc dotyczącą tego polecenia.
--czekać Nakazuje użytkownikowi naciśnięcie dowolnego klawisza przed zakończeniem programu.
--dzienniki,--otwórz dzienniki Otwórz domyślną lokalizację dzienników.
--gadatliwy, --gadatliwy-dzienniki Służy do zastępowania ustawienia rejestrowania i tworzenia szczegółowego dziennika.
--nowarn (ignoruj ostrzeżenia), --ignore-warnings (ignoruj ostrzeżenia) Tłumi komunikaty ostrzeżeń.
--wyłącz-interaktywność Wyłącz interaktywne komunikaty.
--proxy Ustaw serwer proxy do użycia na potrzeby tego wykonania.
--no-proxy Wyłącz użycie serwera proxy dla tego wykonania.

aktualizuj wszystko

Aktualizacja podpolecenia, winget source update, żąda aktualizacji wszystkich repozytoriów.

zaktualizować źródło

aktualizacji podpolecenia z opcją --name kieruje aktualizację do nazwanego źródła. Na przykład: winget source update --name Contoso wymusza aktualizację repozytorium Contoso.

usuń

usunąć podpolecenia usuwa źródło. To polecenie wymaga opcji --name w celu zidentyfikowania źródła. Ponieważ polecenie zmienia dostęp użytkowników, przy użyciu usuń wymaga uprawnień administratora.

Użycie:

winget source remove [-n] <name> [<options>]

Pseudonimy

Następujące aliasy są dostępne dla tego podpolecenia:

  • Rm

Argumenty (w programowaniu)

Dostępne są następujące argumenty.

Argumentacja Opis
-n, --name Nazwa identyfikująca źródło według.

Opcje

Dostępne są następujące opcje.

Opcja Opis
-?, --pomoc Uzyskaj dodatkową pomoc dotyczącą tego polecenia.
--czekać Nakazuje użytkownikowi naciśnięcie dowolnego klawisza przed zakończeniem programu.
--dzienniki,--otwórz dzienniki Otwórz domyślną lokalizację dzienników.
--gadatliwy, --gadatliwy-dzienniki Służy do zastępowania ustawienia rejestrowania i tworzenia szczegółowego dziennika.
--nowarn (ignoruj ostrzeżenia), --ignore-warnings (ignoruj ostrzeżenia) Tłumi komunikaty ostrzeżeń.
--wyłącz-interaktywność Wyłącz interaktywne komunikaty.
--proxy Ustaw serwer proxy do użycia na potrzeby tego wykonania.
--no-proxy Wyłącz użycie serwera proxy dla tego wykonania.

Przykłady

winget source remove --name Contoso

To polecenie usuwa repozytorium Contoso.

resetować

Resetowanie podpolecenia resetuje klienta z powrotem do oryginalnej konfiguracji i usuwa wszystkie źródła z wyjątkiem domyślnego. Tej podpolecenia należy używać tylko w rzadkich przypadkach. Ponieważ polecenie zmienia dostęp użytkowników, użycie resetowania wymaga uprawnień administratora.

Ponieważ polecenie resetowania usuwa wszystkie źródła, należy wymusić akcję przy użyciu opcji --force.

Użycie:

winget source reset [[-n] <name>] [<options>]

Argumenty (w programowaniu)

Dostępne są następujące argumenty.

Argumentacja Opis
-n, --name Nazwa identyfikująca źródło według.

Opcje

Dostępne są następujące opcje.

Opcja Opis
--siła Wymusza zresetowanie źródeł.
-?, --pomoc Uzyskaj dodatkową pomoc dotyczącą tego polecenia.
--czekać Nakazuje użytkownikowi naciśnięcie dowolnego klawisza przed zakończeniem programu.
--dzienniki,--otwórz dzienniki Otwórz domyślną lokalizację dzienników.
--gadatliwy, --gadatliwy-dzienniki Służy do zastępowania ustawienia rejestrowania i tworzenia szczegółowego dziennika.
--nowarn (ignoruj ostrzeżenia), --ignore-warnings (ignoruj ostrzeżenia) Tłumi komunikaty ostrzeżeń.
--wyłącz-interaktywność Wyłącz interaktywne komunikaty.
--proxy Ustaw serwer proxy do użycia na potrzeby tego wykonania.
--no-proxy Wyłącz użycie serwera proxy dla tego wykonania.

eksportować

Polecenie podrzędne eksportu eksportuje szczegółowe informacje dotyczące źródła do danych wyjściowych JSON. Jest to przydatne w przypadku konfigurowania zasad grupy na potrzeby zarządzania źródłami.

Użycie:

winget source export [[-n] <name>] [<options>]

Argumenty (w programowaniu)

Dostępne są następujące argumenty.

Argumentacja Opis
-n, --name Nazwa identyfikująca źródło według.

Opcje

Dostępne są następujące opcje.

Opcja Opis
-?, --pomoc Uzyskaj dodatkową pomoc dotyczącą tego polecenia.
--czekać Nakazuje użytkownikowi naciśnięcie dowolnego klawisza przed zakończeniem programu.
--dzienniki,--otwórz dzienniki Otwórz domyślną lokalizację dzienników.
--gadatliwy, --gadatliwy-dzienniki Służy do zastępowania ustawienia rejestrowania i tworzenia szczegółowego dziennika.
--nowarn (ignoruj ostrzeżenia), --ignore-warnings (ignoruj ostrzeżenia) Tłumi komunikaty ostrzeżeń.
--wyłącz-interaktywność Wyłącz interaktywne komunikaty.
--proxy Ustaw serwer proxy do użycia na potrzeby tego wykonania.
--no-proxy Wyłącz użycie serwera proxy dla tego wykonania.

Przykłady

winget source export winget

Zwraca następujące dane wyjściowe:

{"Arg":"https://cdn.winget.microsoft.com/cache","Data":"Microsoft.Winget.Source_8wekyb3d8bbwe","Explicit":false,"Identifier":"Microsoft.Winget.Source_8wekyb3d8bbwe","Name":"winget","TrustLevel":["Trusted","StoreOrigin"],"Type":"Microsoft.PreIndexed.Package"}

Umowa źródłowa

Pojedyncze źródło może zażądać, aby użytkownik zgodził się na przedstawione umowy przed dodaniem lub użyciem źródła. Jeśli użytkownik nie akceptuje umów, usługa WinGet nie będzie mogła uzyskać dostępu do źródła.

Możesz użyć opcji --accept-source-agreement , aby zaakceptować umowy źródłowe i uniknąć monitu.

Wiele poleceń WinGet ocenia wszystkie skonfigurowane źródła. Jeśli jakiekolwiek skonfigurowane źródło wymaga umów, przed użyciem tych źródeł zostanie wyświetlony monit WinGet. Umowy źródłowe muszą zostać zaakceptowane przed użyciem. Jeśli warunki umowy dotyczącej aktualizacji źródła lub jeśli źródło zostanie usunięte i odczytane (tak jak w przypadku winget source reset --force) umowy zostaną ponownie przedstawione.

umowa źródłowa skrzydła