settings polecenie (winget)

Polecenie settingsWinGet umożliwia dostosowanie środowiska klienta Windows Menedżer pakietów. Możesz zmienić wartości domyślne i wypróbować funkcje eksperymentalne, które są dostępne w kliencie.

Polecenie settings spowoduje uruchomienie domyślnego edytora JSON. System Windows domyślnie uruchomi Notatnik jako opcję. Zalecamy używanie narzędzia takiego jak Visual Studio Code.

Uwaga / Notatka

Możesz łatwo zainstalować program Visual Studio Code, wpisując polecenie winget install Microsoft.VisualStudioCode

Pseudonimy

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

  • config

Polecenia podrzędne

Dostępne są następujące polecenia podrzędne.

Sub-Command Opis
eksport Eksportuje settings.
zestaw Ustawia wartość ustawienia administratora.
reset Resetuje ustawienie administratora do wartości domyślnej.

Opcje

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

Argumentacja Opis
--enable Włącza określone ustawienie administratora.
--wyłącz Wyłącza określone ustawienie administratora.
-?,--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 Otwiera domyślną lokalizację dzienników.
--verbose,--verbose-logs Włącza szczegółowe rejestrowanie 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.

Użyj polecenia wingetsettings

Uruchom domyślne narzędzie do edycji JSON: winget settings

Przy pierwszym uruchomieniu elementu settings nie będzie określony żaden element settings. W górnej części pliku JSON udostępniamy link Ustawienia interfejsu wiersza polecenia WinGet , w którym można znaleźć najnowsze funkcje eksperymentalne i settings.

Poniższy fragment kodu przedstawia przykład tego, jak może wyglądać plik settings z włączonymi modyfikacjami wyników wizualnych i funkcjami eksperymentalnymi.

{
    "$schema": "https://aka.ms/winget-settings.schema.json",

    "visual": {
        "enableSixels": true,
        "progressBar": "rainbow"
    },
    "experimentalFeatures": {
        "experimentalARG": true,
        "experimentalCMD": true
    }
}

Zdefiniowaliśmy również schemat dla settings pliku. Dzięki temu można użyć klawisza TAB do odnajdywania settings i składni, jeśli edytor JSON obsługuje schematy JSON.

Aktualizowanie settings

Następujące settings są dostępne w wydaniu 1.28 menedżera pakietów systemu Windows.

Źródło settings

Konfiguracja sourcesettings wymaga połączenia ze źródłem WinGet.

"source": {
    "autoUpdateIntervalInMinutes": 60
},

interwałAutoAktualizacjiWMinutach

Dodatnia liczba całkowita reprezentuje interwał aktualizacji w minutach. Sprawdzanie dostępności aktualizacji odbywa się tylko wtedy, gdy jest używane źródło. Zero spowoduje wyłączenie sprawdzania dostępności aktualizacji źródła. Wszystkie inne wartości są nieprawidłowe.

  • Wyłącz: 0
  • Ustawienie domyślne: 15

Aby ręcznie zaktualizować źródło, użyj polecenia winget source update.

visual settings

visual settings obejmują elementy wizualne wyświetlane przez WinGet

"visual": {
    "enableSixels": true,
    "progressBar": "rainbow"
},

pasek postępu

Kolor paska postępu wyświetlanego przez winGet, gdy nie jest określony przez argumenty.

  • akcent (ustawienie domyślne)
  • tęcza
  • Retro
  • sixel
  • wygaszony

anonimizujWyświetlaneŚcieżki

Zastępuje niektóre znane ścieżki folderów odpowiednimi zmiennymi środowiskowymi.

włącz Sixels

Umożliwia generowanie obrazów w formacie sixel w określonych kontekstach.

rejestrowanie settings

Elementy loggingsettings sterują poziomem szczegółowości w plikach dziennika. --verbose-logs zastąpi to ustawienie i zawsze tworzy pełny dziennik.

"logging": {
    "level": "verbose"
}

poziom

Następujące poziomy rejestrowania są dostępne. Wartość domyślna to info, jeśli wartość nie jest ustawiona lub jest nieprawidłowa.

  • pełny
  • Informacja
  • ostrzeżenie
  • błąd
  • krytyczny

channels

Ustawienie channels ogranicza rejestrowanie danych wyjściowych do określonych kanałów dziennika. Akceptowane są również wartości default specjalne (domyślny zestaw kanałów) i all (wszystkie kanały). Nieprawidłowe wartości są ignorowane.

"logging": {
    "channels": ["default"]
}

plik

Kontrolka filesettings automatycznego czyszczenia plików dziennika w domyślnym katalogu dziennika. Oczyszczanie jest uruchamiane na początku każdego procesu WinGet i ma zastosowanie tylko do domyślnej lokalizacji dziennika.

Setting Opis Wartość domyślna
ageLimitInDays Maksymalny wiek w dniach plików w katalogu dziennika; starsze pliki są usuwane. Ustaw na 0, aby wyłączyć. 7
totalSizeLimitInMB Maksymalny całkowity rozmiar w megabajtach wszystkich plików w katalogu dziennika; najstarsze pliki są najpierw usuwane. Ustaw na 0, aby wyłączyć. 128
countLimit Maksymalna liczba plików w katalogu dziennika; najstarsze pliki są najpierw usuwane. Ustaw na 0, aby wyłączyć. 0 (wyłączone)
individualSizeLimitInMB Maksymalny rozmiar w megabajtach pojedynczego pliku dziennika. Jeśli plik przekroczy ten limit, dzienniki będą zawijane. Ustaw na 0, aby wyłączyć. 16 
"logging": {
    "level": "verbose",
    "file": {
        "ageLimitInDays": 7,
        "totalSizeLimitInMB": 128,
        "countLimit": 0,
        "individualSizeLimitInMB": 16
    }
}

preferencje i wymagania settings

Niektóre elementy settings są zduplikowane w sekcjach preferences i requirements.

  • Ustawienie preferences określa sposób sortowania różnych dostępnych opcji podczas wybierania opcji do działania. Na przykład domyślny zakres instalacji pakietu dotyczy bieżącego użytkownika, ale jeśli nie jest to opcja, zostanie wybrany instalator na poziomie komputera.
  • Ustawienie requirements filtruje opcje, co potencjalnie powoduje pustą listę i niepowodzenie instalacji. W poprzednim przykładzie wymaganie zakresu użytkownika spowodowałoby brak odpowiednich instalatorów i błąd.

Wszystkie argumenty przekazane w wierszu polecenia skutecznie zastąpią pasujące ustawienia requirement na czas trwania tego polecenia.

zakres

Zachowanie scope steruje wyborem między zainstalowaniem pakietu dla bieżącego użytkownika lub dla całej maszyny. Pasujący parametr to --scope, i używa tych samych wartości (user lub machine). Zobacz znane problemy związane z zakresem instalacji pakietu.

"installBehavior": {
    "preferences": {
        "scope": "user"
    }
},

regionalny

Zachowanie locale steruje wyborem instalatora na podstawie ustawień regionalnych instalatora. Pasujący parametr to --locale, i używa tagu języka bcp47.

"installBehavior": {
    "preferences": {
        "locale": [ "en-US", "fr-FR" ]
    }
},

Architektury

Zachowanie architectures steruje architekturami wybranymi podczas instalowania pakietu. Pasujący parametr to --architecture. Można wybrać tylko architektury zgodne z systemem.

    "installBehavior": {
        "preferences": {
            "architectures": ["x64", "arm64"]
        }
    },

typy instalatorów

Zachowanie installerTypes ma wpływ na typy instalatora wybrane podczas instalowania pakietu. Może również określić typ, który ma być instalowany domyślnie, jeśli manifest ma wiele typów: lista jest w kolejności priorytetowej, a pierwszy typ listy jest preferowany przez inne i tak dalej. Jest to wygodne dla użytkowników, którzy na przykład preferują przenośne pakiety lub instalacje MSIX/AppX. Pasujący parametr to --installer-type, który zastąpi parametr settings.

Dozwolone wartości w wersji 1.12.470 obejmują: appx, burn, exe, font, inno, msi, msix, msstore, nullsoft, portable, wix, zip

Domyślnie, przy założeniu, że wszystkie pozostałe właściwości są równe, WinGet wybiera typ instalatora, który jest wymieniony jako pierwszy w pliku YAML manifestu, jeśli pakiet nie został jeszcze zainstalowany. Jeśli jest już zainstalowany, ten sam typ instalatora będzie wymagany w celu zapewnienia odpowiedniego uaktualnienia.

    "installBehavior": {
        "preferences": {
            "installerTypes": ["msix", "msi"]
        }
    },

installBehavior settings

Elementy installBehaviorsettings kontrolują domyślne zachowanie podczas instalacji i aktualizacji pakietów (w stosownych przypadkach).

wyłącz notatki instalacyjne

Ustawienie disableInstallNotes określa, czy notatki dotyczące instalacji są wyświetlane po pomyślnym zainstalowaniu. Domyślnie jest false, jeśli wartość nie jest ustawiona lub jest nieprawidłowa.

    "installBehavior": {
        "disableInstallNotes": true
    },

portablePackageUserRoot — ustawienie

Ustawienie portablePackageUserRoot definiuje domyślny katalog główny do instalowania pakietów w User zakresie. Dotyczy to tylko pakietów z typem portable instalatora. Domyślnie jest %LOCALAPPDATA%/Microsoft/WinGet/Packages/, jeśli wartość nie jest ustawiona lub jest nieprawidłowa.

Ta wartość ustawienia musi być ścieżką bezwzględną.

    "installBehavior": {
        "portablePackageUserRoot": "C:/Users/FooBar/Packages"
    },

portablePackageMachineRoot — ustawienie

Ustawienie portablePackageMachineRoot definiuje domyślny katalog główny do instalowania pakietów w Machine zakresie. Dotyczy to tylko pakietów z typem portable instalatora. Wartość domyślna to %PROGRAMFILES%/WinGet/Packages/, jeśli wartość nie jest ustawiona lub jest nieprawidłowa.

Ta wartość ustawienia musi być ścieżką bezwzględną.

    "installBehavior": {
        "portablePackageMachineRoot": "C:/Program Files/Packages/Portable"
    },

defaultInstallRoot

Ustawienie defaultInstallRoot określa domyślną lokalizację instalacji pakietów, które wymagają jawnej ścieżki instalacji, jeśli lokalizacja instalacji nie jest określona.

maxResumes

Ustawienie maxResumes określa maksymalną liczbę prób wznowienia dozwolonych dla pojedynczego identyfikatora życiorysu. Zapobiega to ciągłym ponownym rozruchom, jeśli instalacja wymagająca ponownego uruchomienia nie zostanie prawidłowo wykryta.

metoda ekstrakcji archiwum

Ustawienie archiveExtractionMethod steruje sposobem wyodrębniania archiwów przez instalator. Obsługiwane wartości to shellApi i tar.

  • shellApi używa interfejsu API powłoki systemu Windows do wyodrębniania archiwów.

  • tar używa polecenia tar do wyodrębniania archiwów.

OdinstalujBehavior

Ustawienie uninstallBehavior określa, czy domyślny proces odinstalowywania usuwa wszystkie pliki i katalogi istotne dla tego pakietu. Dotyczy wyłącznie urządzenia przenośnego installerType.

usuńPrzenośnyPakiet

Ustawienie purgePortablePackage steruje zachowaniem domyślnym podczas odinstalowywania pakietu przenośnego. Jeśli true jest ustawiona, odinstalowanie spowoduje usunięcie wszystkich plików i katalogów związanych z pakietem portable. To ustawienie dotyczy tylko pakietów z typem portable instalatora. Domyślnie jest false, jeśli wartość nie jest ustawiona lub jest nieprawidłowa.

    "uninstallBehavior": {
        "purgePortablePackage": true
    },

KonfigurujZachowanie

Ustawienie ConfigureBehavior określa domyślny katalog główny, w którym instalowane są moduły programu PowerShell podczas stosowania konfiguracji.

zachowanie pobierania

Elementy downloadBehaviorsettings określają domyślny katalog, do którego pobierane są instalatory.

domyślny katalog pobierania

Ustawienie defaultDownloadDirectory określa domyślny katalog, w którym są pobierane pakiety. Domyślnie jest %USERPROFILE%/Downloads, jeśli wartość nie jest ustawiona lub jest nieprawidłowa.

Ta wartość ustawienia musi być ścieżką bezwzględną.

    "downloadBehavior": {
        "defaultDownloadDirectory": "C:/Users/FooBar/Downloads"
    },

Telemetria settings

telemetry settings określają, czy WinGet zapisuje zdarzenia ETW, które mogą być wysyłane do firmy Microsoft w domyślnej instalacji systemu Windows.

Zobacz szczegóły dotyczące telemetrii, oraz naszą podstawową politykę prywatności .

wyłączyć

"telemetry": {
    "disable": true
},

Jeśli ustawienie ma wartość true, telemetry.disable ustawienie uniemożliwi zapisanie jakiegokolwiek zdarzenia przez program.

Sieć settings

Wpływ networksettings na sposób, w jaki usługa WinGet używa sieci do pobierania pakietów i metadanych.

narzędzie pobierania

Ustawienie downloader określa kod używany podczas pobierania pakietów. Wartość domyślna to do, która może być zarządzana przez Zasady grupy.

używa interfejsów API WinINet, a korzysta z usługi Optymalizacji Dostarczania .

"network": {
    "downloader": "wininet"
}

doProgressTimeoutInSeconds

Określa doProgressTimeoutInSeconds liczbę sekund oczekiwania bez postępu przed przejściem awaryjnym.

Interaktywność

Ustawienie Interactivity kontroluje, czy wyświetlane są interaktywne komunikaty przez klienta Menedżera pakietów Windows.

Włączanie funkcji eksperymentalnych

Aby dowiedzieć się, które funkcje eksperymentalne są dostępne, przejdź do https://aka.ms/wingethttps://aka.ms/winget-settings gdzie można zobaczyć dostępne funkcje eksperymentalne.

experimentalFeatures settings dotyczą konfiguracji tych „eksperymentalnych” funkcji. Poszczególne funkcje można włączyć w tym węźle:

"experimentalFeatures": {
    "directMSI": true,
    "resume": true
}

directMSI

Ta funkcja umożliwia Menedżerowi pakietów systemu Windows bezpośrednie instalowanie pakietów MSI przy użyciu interfejsów API MSI, a nie za pomocą pliku msiexec. Należy pamiętać, że w przypadku korzystania z instalacji dyskretnej jest to już stosowane, ponieważ pakiety MSI wymagające podniesienia uprawnień nie powiedzą się w tym scenariuszu.

"experimentalFeatures": {
    "directMSI": true
}

wznawiać

Ta funkcja umożliwia wznawianie niektórych poleceń po ponownym uruchomieniu.

"experimentalFeatures": {
    "resume": true
}

Czcionki

Ta funkcja umożliwia obsługę czcionek za pomocą polecenia winget settings. Polecenie winget font list wyświetli listę zainstalowanych rodzin czcionek i liczbę zainstalowanych twarzy czcionek.

"experimentalFeatures": {
    "fonts": true
}

priorytetŹródła

Ta funkcja umożliwia przypisanie źródeł wartości priorytetu. Źródła o wyższym priorytcie będą wyświetlane wcześniej w wynikach wyszukiwania i zostaną wybrane do zainstalowania nowych pakietów, gdy wiele źródeł ma pasujący pakiet.

Należy pamiętać, że kolejność wyników wyszukiwania zależy od kilku czynników, a priorytet źródła jest obecnie najniższym polem (jakość dopasowania i pole są ważniejsze).

"experimentalFeatures": {
    "sourcePriority": true
}
  • Last updated on