pin polecenie (winget)

Polecenie wingetpin pozwala ograniczyć Windows Menedżer pakietów uaktualniania pakietu do określonych zakresów wersji lub może uniemożliwić jego całkowite uaktualnienie pakietu. Przypięty pakiet może nadal upgrade działać samodzielnie i być uaktualniany spoza Windows Menedżer pakietów.

Typy przypinania

Usługa WinGet obsługuje trzy typy numerów PIN pakietów:

• przypinanie: pakiet jest wykluczony z winget upgrade --all, ale zezwala na winget upgrade <package>. Możesz użyć argumentu --include-pinned, aby umożliwić winget upgrade --all dołączanie przypiętych pakietów.

• Blokowanie: pakiet jest zablokowany lub winget upgrade --allwinget upgrade <package>, należy odpiąć pakiet, aby umożliwić usłudze WinGet wykonanie polecenia upgrade. Za --force pomocą opcji można zastąpić pinzachowanie użytkownika.

• Gating : pakiet jest przypięty do określonej wersji lub zakresu wersji. Możesz określić dokładną wersję, do której ma zostać przypięty pakiet, lub możesz użyć symbolu wieloznacznego * jako ostatniej części wersji, aby określić zakres wersji. Jeśli na przykład pakiet jest przypięty do wersji 1.2.*, każda wersja między 1.2.0 a 1.2.x jest uważana za prawidłową. Za --force pomocą opcji można zastąpić pinzachowanie użytkownika.

Zastosowanie

winget pin <subcommand> <options>

Opcje

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

Opcja	Opis
-?, --help	Otrzymuje dodatkową pomoc dotyczącą tego polecenia.
--wait	Nakazuje użytkownikowi naciśnięcie dowolnego klawisza przed zakończeniem programu.
--logs,--open-logs	Otwórz domyślną lokalizację dzienników.
--verbose, --verbose-logs	Służy do zastępowania ustawienia rejestrowania i tworzenia szczegółowego dziennika.
--nowarn,--ignore-warnings	Tłumi komunikaty ostrzeżeń.
--disable-interactivity	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.

Podpolecenia

Polecenie pin obsługuje następujące polecenia podrzędne.

Podpolecenia	Opis
dodaj	Dodaj nowy pinelement .
usuń	Usuń pakiet pin.
lista	Wyświetl bieżące pinezki.
resetowanie	Resetuj pinezki

dodawać

Dodaj podpolecenia dodaje nowy pinelement . To polecenie wymaga określenia dokładnego pakietu na pin. Jeśli istnieje jakakolwiek niejednoznaczność, zostanie wyświetlony monit o dalsze filtrowanie dodawania podpolecenia do dokładnej aplikacji.

Użycie:

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

Argumenty (w programowaniu)

Argumentacja	Opis
-P--query	Zapytanie używane do wyszukiwania aplikacji.

Opcje

Opcje umożliwiają dostosowanie dodawania numerów PIN w celu spełnienia Twoich potrzeb.

Opcja	Opis
--id	Ogranicza wyszukiwanie do identyfikatora aplikacji.
--name	Ogranicza wyszukiwanie do nazwy aplikacji.
--moniker	Ogranicza wyszukiwanie do pseudonimu przypisanego aplikacji.
--tag	Ogranicza wyszukiwanie do tagu wymienionego dla aplikacji.
--cmd, --command	Ogranicza wyszukiwanie do polecenia aplikacji.
-E --exact	Używa dokładnego ciągu znaków w zapytaniu, w tym sprawdzania rozróżniania wielkości liter. Nie będzie używać domyślnego zachowania funkcji substring.
-v, --version	Umożliwia określenie dokładnej wersji na pin. Symbol wieloznaczny * może być używany jako ostatnia część wersji. Zachowanie zmiany pin to gating.
-S --source	Ogranicza wyszukiwanie do podanej nazwy źródłowej. Należy po nim podać nazwę źródłową.
--header	Opcjonalny nagłówek HTTP dla źródła REST w systemie Windows—Package-Manager.
--authentication-mode	Określ preferencję okna uwierzytelniania (dyskretne, dyskretne lub interaktywne).
--authentication-account	Określ konto, które ma być używane do uwierzytelniania.
--accept-source-agreements	Używany w celu zaakceptowania pierwotnej umowy licencyjnej i uniknięcia monitu.
--force	Uruchom polecenie bezpośrednio i kontynuuj działania niezwiązane z problemami bezpieczeństwa.
--blocking	Blokowanie uaktualniania do momentu pin usunięcia argumentów uniemożliwiających zastąpienie argumentów. Zachowanie zmiany pin to blocking.
--installed	Przypinanie określonej zainstalowanej wersji
-?, --help	Uzyskaj dodatkową pomoc dotyczącą tego polecenia.
--wait	Nakazuje użytkownikowi naciśnięcie dowolnego klawisza przed zakończeniem programu.
--logs, --open-logs	Otwórz domyślną lokalizację dzienników.
--verbose, --verbose-logs	Służy do zastępowania ustawienia rejestrowania i tworzenia szczegółowego dziennika.
--nowarn,--ignore-warnings	Tłumi komunikaty ostrzeżeń.
--disable-interactivity	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

Poniższy przykład dodaje element pin dla aplikacji. Dodanie tego pin elementu uniemożliwi uaktualnienie tego pakietu podczas wywoływania metody winget upgrade --all. Użyj argumentu --include-pinned z winget upgrade --all, aby uwzględnić wszystkie przypięte pakiety.

winget pin add powertoys

W poniższym przykładzie dodano blokadę pin dla aplikacji przy użyciu jej identyfikatora. Dodanie blokady pin uniemożliwi uaktualnienie tego pakietu podczas wywoływania lub winget upgrade --allwinget upgrade <package>. Należy odblokować pakiet, aby umożliwić usłudze WinGet wykonanie polecenia upgrade.

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

Poniższy przykład dodaje gating pin dla aplikacji przy użyciu jego identyfikatora. Dodanie funkcji gating pin uniemożliwi uaktualnienie wersji pakietu poza określoną wersją lub zakresem symboli upgrade wieloznacznych.

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

usuń

Usuń podpolecenia usuwa pinelement . To polecenie wymaga określenia dokładnego pakietu pin do usunięcia. Jeśli istnieje jakakolwiek niejednoznaczność, zostanie wyświetlony monit o dalsze filtrowanie usunąć podpolecenia do dokładnej aplikacji.

Użycie:

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

Argumenty (w programowaniu)

Argumentacja	Opis
-q,--query	Zapytanie używane do wyszukiwania aplikacji.

Opcje

Opcje umożliwiają dostosowanie usuwanych numerów PIN w celu spełnienia Twoich potrzeb.

Opcja	Opis
--id	Ogranicza wyszukiwanie do identyfikatora aplikacji.
--name	Ogranicza wyszukiwanie do nazwy aplikacji.
--moniker	Ogranicza wyszukiwanie do pseudonimu przypisanego aplikacji.
-S --source	Ogranicza wyszukiwanie do podanej nazwy źródłowej. Należy po nim podać nazwę źródłową.
--tag	Ogranicza wyszukiwanie do tagu wymienionego dla aplikacji.
--cmd, --command	Ogranicza wyszukiwanie do polecenia aplikacji.
-E --exact	Używa dokładnego ciągu znaków w zapytaniu, w tym sprawdzania rozróżniania wielkości liter. Nie będzie używać domyślnego zachowania funkcji substring.
--header	Opcjonalny nagłówek HTTP dla źródła REST w systemie Windows—Package-Manager.
--authentication-mode	Określ preferencję okna uwierzytelniania (dyskretne, dyskretne lub interaktywne).
--authentication-account	Określ konto, które ma być używane do uwierzytelniania.
--accept-source-agreements	Używany w celu zaakceptowania pierwotnej umowy licencyjnej i uniknięcia monitu.
--installed	Przypnij określoną zainstalowaną wersję.
-?, --help	Uzyskaj dodatkową pomoc dotyczącą tego polecenia.
--wait	Nakazuje użytkownikowi naciśnięcie dowolnego klawisza przed zakończeniem programu.
--logs, --open-logs	Otwórz domyślną lokalizację dzienników.
--verbose, --verbose-logs	Służy do zastępowania ustawienia rejestrowania i tworzenia szczegółowego dziennika.
--nowarn,--ignore-warnings	Tłumi komunikaty ostrzeżeń.
--disable-interactivity	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

Poniższy przykład usuwa obiekt pin dla aplikacji.

winget pin remove powertoys

Poniższy przykład usuwa pin obiekt dla aplikacji przy użyciu jego identyfikatora.

winget pin remove --id Microsoft.PowerToys

lista

Lista podpolecenia zawiera listę wszystkich bieżących numerów PIN.

Użycie:

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

Argumenty (w programowaniu)

Argumentacja	Opis
-q,--query	Zapytanie używane do wyszukiwania aplikacji.

Opcje

Opcje umożliwiają dostosowanie numerów pin listy w celu spełnienia Twoich potrzeb.

Opcja	Opis
--id	Ogranicza wyszukiwanie do identyfikatora aplikacji.
--name	Ogranicza wyszukiwanie do nazwy aplikacji.
--moniker	Ogranicza wyszukiwanie do pseudonimu przypisanego aplikacji.
-S --source	Ogranicza wyszukiwanie do podanej nazwy źródłowej. Należy po nim podać nazwę źródłową.
--tag	Ogranicza wyszukiwanie do tagu wymienionego dla aplikacji.
--cmd, --command	Ogranicza wyszukiwanie do polecenia aplikacji.
-E --exact	Używa dokładnego ciągu znaków w zapytaniu, w tym sprawdzania rozróżniania wielkości liter. Nie będzie używać domyślnego zachowania funkcji substring.
--header	Opcjonalny nagłówek HTTP dla źródła REST w systemie Windows—Package-Manager.
--authentication-mode	Określ preferencję okna uwierzytelniania (dyskretne, dyskretne lub interaktywne).
--authentication-account	Określ konto, które ma być używane do uwierzytelniania.
--accept-source-agreements	Używany w celu zaakceptowania pierwotnej umowy licencyjnej i uniknięcia monitu.
-?, --help	Uzyskaj dodatkową pomoc dotyczącą tego polecenia.
--wait	Nakazuje użytkownikowi naciśnięcie dowolnego klawisza przed zakończeniem programu.
--logs, --open-logs	Otwórz domyślną lokalizację dzienników.
--verbose, --verbose-logs	Służy do zastępowania ustawienia rejestrowania i tworzenia szczegółowego dziennika.
--nowarn,--ignore-warnings	Tłumi komunikaty ostrzeżeń.
--disable-interactivity	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

W poniższym przykładzie wymieniono wszystkie bieżące pinezki.

winget pin list

Poniższy przykład zawiera listę określonego pakietu pin.

winget pin list --id Microsoft.PowerToys

resetować

Polecenie podrzędne resetowania resetuje wszystkie pinezki.

Użycie tego podpolecenia bez argumentu --force spowoduje wyświetlenie numerów PIN, które zostaną usunięte.

Aby zresetować wszystkie pinezki, dołącz argument --force.

Użycie:

winget pin reset [<options>]

Opcje

Opcje pozwalają dostosować resetowanie pinów do własnych potrzeb.

Opcja	Opis
--force	Uruchom polecenie bezpośrednio i kontynuuj działania niezwiązane z problemami bezpieczeństwa.
-S --source	Ogranicza wyszukiwanie do podanej nazwy źródłowej. Należy po nim podać nazwę źródłową.
-?, --help	Uzyskaj dodatkową pomoc dotyczącą tego polecenia.
--wait	Nakazuje użytkownikowi naciśnięcie dowolnego klawisza przed zakończeniem programu.
--logs, --open-logs	Otwórz domyślną lokalizację dzienników.
--verbose, --verbose-logs	Służy do zastępowania ustawienia rejestrowania i tworzenia szczegółowego dziennika.
--nowarn,--ignore-warnings	Tłumi komunikaty ostrzeżeń.
--disable-interactivity	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

W poniższym przykładzie przedstawiono wszystkie pinezki, które zostaną zresetowane.

winget pin reset

Poniższy przykład resetuje wszystkie istniejące pinezki.

winget pin reset --force