Udostępnij przez

polecenie ustawień (winget)

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

Polecenie ustawień 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:

  • konfig

Polecenia podrzędne

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

Sub-Command Opis
eksport Ustawienia eksportu.
zestaw Ustawia wartość ustawienia administratora.
resetowanie 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 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.

Użyj polecenia ustawień zestawu winget

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

Po uruchomieniu ustawień po raz pierwszy nie zostaną określone żadne ustawienia. W górnej części pliku JSON udostępniamy link Ustawienia interfejsu wiersza polecenia WinGet , w którym można znaleźć najnowsze funkcje i ustawienia eksperymentalne.

Poniższy fragment kodu przedstawia przykład tego, jak może wyglądać plik ustawień z włączonymi modyfikacjami wizualnego wyjścia 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 pliku ustawień. Dzięki temu można użyć TAB do odnajdywania ustawień i składni, jeśli edytor JSON obsługuje schematy JSON.

Aktualizowanie ustawień

Następujące ustawienia są dostępne dla wersji 1.11 Menedżera pakietów systemu Windows.

ustawienia źródła

Ustawienia source obejmują konfigurację źródła 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.

ustawienia wizualizacji

Ustawienia visual 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.

enableSizels

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

Ustawienia rejestrowania

Ustawienia logging kontrolują poziom 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

ustawienia preferencji i wymagań

Niektóre ustawienia są zduplikowane w obszarze 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 steruje typami instalatora wybranymi podczas instalowania pakietu. Pasujący parametr to --installer-type.

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

installBehavior settings (ustawienia installBehavior)

Ustawienia installBehavior kontrolują domyślne zachowanie instalowania i uaktualniania (w stosownych przypadkach) pakietów.

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

Ustawienia downloadBehavior kontrolują domyślny katalog, w którym są pobierane 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"
    },

Ustawienia telemetrii

Ustawienia telemetry 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.

Ustawienia sieciowe

Ustawienia network wpływają 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/winget-settings miejsca, w którym można zobaczyć dostępne funkcje eksperymentalne.

  • Last updated on