команда настроек (winget)

2025-07-09

Команда параметровWinGet позволяет настроить клиентский интерфейс диспетчера пакетов Windows. Вы можете изменить значения по умолчанию и попробовать экспериментальные функции, доступные в клиенте.

Команда settings запустит ваш редактор JSON по умолчанию. Windows по умолчанию предложит Блокнот в качестве опции. Мы рекомендуем использовать такие средства, как Visual Studio Code.

Замечание

Вы можете легко установить Visual Studio Code, введя текст winget install Microsoft.VisualStudioCode

Псевдонимы

Для этой команды доступны следующие псевдонимы:

конфиг

Вложенные команды

Доступны следующие подкоманды.

Sub-Command	Описание
экспорт	Экспорт параметров.
установить	Задает значение параметра администратора.
reset;	Сбрасывает административную настройку на значение по умолчанию.

Опции

Имеются следующие варианты:

Аргумент	Описание
--включить	Включает указанный параметр администратора.
--отключить	Отключает указанный параметр администратора.
-?--Справка	Отображает справку по выбранной команде.
--подождите	Предложит пользователю нажать любой ключ перед выходом.
--logs,--open-logs	Открывает расположение журналов по умолчанию.
--verbose,--verbose-logs	Включает подробное ведение журнала программой winget.
--nowarn (без предупреждений),--ignore-warnings (игнорировать предупреждения)	Подавляет выходные данные предупреждений.
--отключить-интерактивность	Отключает интерактивные запросы.
--доверенность	Задает прокси-сервер, используемый для этого выполнения.
--no-proxy	Отключает использование прокси-сервера для этого выполнения.

Используйте команду winget settings

Запустите средство редактирования JSON по умолчанию: winget settings

При первом открытии настроек параметры не будут указаны. В верхней части JSON-файла мы предоставляем ссылку "Параметры интерфейса командной строки WinGet ", где можно найти последние экспериментальные функции и параметры.

В приведенном ниже фрагменте кода показан пример того, как может выглядеть файл параметров с изменениями визуального вывода и экспериментальными функциями.

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

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

Мы также определили схему для файла параметров. Это позволяет использовать TAB для обнаружения параметров и синтаксиса, если редактор JSON поддерживает схемы JSON.

Обновление параметров

Следующие параметры доступны для выпуска 1.11 диспетчера пакетов Windows.

параметры источника

Параметры source включают конфигурацию для источника WinGet.

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

autoUpdateIntervalInMinutes (интервал автообновления в минутах)

Положительное целое число представляет интервал обновления в минутах. Проверка обновлений происходит только в том случае, если используется источник. Ноль отключит проверку наличия обновлений в источнике. Любые другие значения недопустимы.

Отключение: 0
По умолчанию: 15

Чтобы вручную обновить источник, используйте winget source update.

визуальные параметры

Параметры visual включают визуальные элементы, отображаемые WinGet

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

индикатор прогресса

Цвет индикатора выполнения, отображаемого WinGet, если аргументы не заданы.

акцент (по умолчанию)
радуга
ретро
sixel
отключено

анонимизироватьОтображаемыеПути

Заменяет некоторые известные пути к папкам соответствующим переменным среды.

enableSizels

Позволяет вывод изображений в формате сиксель в определённых контекстах.

Параметры ведения журнала

Параметры logging управляют уровнем детализации в файлах журналов. --verbose-logs переопределит этот параметр и всегда создает подробный журнал.

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

уровень

Доступны следующие уровни ведения журнала. По умолчанию устанавливается info, если значение не задано или недопустимо.

многословный
инфо
предупреждение
ошибка
критический

Настройки предпочтений и требований

Некоторые параметры дублируются в preferences и requirements.

Параметр preferences определяет порядок сортировки различных доступных параметров при выборе одного из них. Например, область установки пакетов по умолчанию предназначена для текущего пользователя, но если это не вариант, будет выбран установщик уровня компьютера.
Параметр requirements фильтрует параметры, что может привести к пустому списку и сбою установки. В предыдущем примере требование области пользователя приведет к отсутствии применимых установщиков и ошибки.

Все аргументы, переданные в командной строке, эффективно переопределяют соответствующий параметр requirement на время выполнения команды.

охват

Поведение scope управляет выбором между установкой пакета для текущего пользователя или всего компьютера. Соответствующий параметр имеет значение --scopeи использует те же значения (user или machine). См. известные проблемы, связанные с областью установки пакетов.

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

местность

Функция locale управляет выбором установщика в зависимости от языкового стандарта установщика. Соответствующий параметр --localeи использует тег языка bcp47.

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

Архитектуры

Поведение architectures определяет, какие архитектуры будут выбраны при установке пакета. Соответствующий параметр является --architecture. Можно выбрать только архитектуры, совместимые с системой.

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

типы установщиков

Поведение installerTypes определяет, какие типы установщиков будут выбраны при установке пакета. Соответствующий параметр является --installer-type.

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

Параметры installBehavior

Параметры installBehavior управляют поведением по умолчанию при установке и обновлении пакетов (где применимо).

disableInstallNotes

Параметр disableInstallNotes определяет, отображаются ли заметки о установке после успешной установки. Значение по умолчанию устанавливается на false, если значение не задано или является недопустимым.

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

Параметр portablePackageUserRoot

Параметр portablePackageUserRoot определяет корневой каталог по умолчанию для установки пакетов в User области. Это относится только к пакетам с типом установщика portable . Значение по умолчанию устанавливается на %LOCALAPPDATA%/Microsoft/WinGet/Packages/, если значение не задано или является недопустимым.

Это значение параметра должно быть абсолютным путем.

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

Параметр portablePackageMachineRoot

Параметр portablePackageMachineRoot определяет корневой каталог по умолчанию для установки пакетов в Machine области. Это относится только к пакетам с типом установщика portable . По умолчанию устанавливается %PROGRAMFILES%/WinGet/Packages/, если значение не задано или недопустимо.

Это значение параметра должно быть абсолютным путем.

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

defaultInstallRoot (стандартный корневой каталог установки)

Параметр defaultInstallRoot указывает расположение установки по умолчанию для пакетов, для которых требуется явный путь установки, если расположение установки не указано.

maxResumes

Параметр maxResumes задает максимальное количество попыток возобновления, разрешенных для одного идентификатора резюме. Это предотвращает непрерывную перезагрузку, если установка, требующая перезагрузки, не обнаружена должным образом.

archiveExtractionMethod

Параметр archiveExtractionMethod определяет, как установщик извлекает архивы. Поддерживаемые значения: shellApi и tar.

shellApi использует API оболочки Windows для извлечения архивов.
tar использует команду tar для извлечения архивов.

UninstallBehavior

Параметр uninstallBehavior определяет, удаляет ли процесс удаления по умолчанию все файлы и каталоги, относящиеся к этому пакету. Применяется только к переносимому устройству installerType.

ОчиститьПортативныйПакет

Параметр purgePortablePackage управляет поведением по умолчанию для удаления переносимого пакета. Если установлено значение true, удаление удалит все файлы и каталоги, относящиеся к пакету portable. Этот параметр применяется только к пакетам с типом установщика portable . Значение по умолчанию устанавливается на false, если значение не задано или является недопустимым.

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

НастройкаПоведений

Этот ConfigureBehavior параметр указывает корневой каталог по умолчанию, в котором модули PowerShell устанавливаются при применении конфигурации.

поведение при загрузке

Параметры downloadBehavior управляют каталогом по умолчанию, в который загружаются установщики.

Каталог загрузок по умолчанию

Параметр defaultDownloadDirectory управляет каталогом по умолчанию, в который загружаются пакеты. Значение по умолчанию устанавливается на %USERPROFILE%/Downloads, если значение не задано или является недопустимым.

Это значение параметра должно быть абсолютным путем.

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

Настройки телеметрии

Параметры telemetry определяют, записывает ли WinGet события ETW, которые могут быть отправлены в Корпорацию Майкрософт при установке Windows по умолчанию.

См. для получения сведений о телеметриии в нашем основном заявлении о конфиденциальности .

отключить

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

Если задано значение true, telemetry.disable параметр не позволит записывать любое событие программой.

Параметры сети

Параметры network влияют на использование WinGet сети для получения пакетов и метаданных.

загрузчик

Параметр downloader определяет, какой код используется при скачивании пакетов. По умолчанию используется do, который может управляться с помощью групповой политики.

wininet использует API WinINet , в то время как do использует службу оптимизации доставки .

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

doProgressTimeoutInSeconds

Указывает doProgressTimeoutInSeconds количество секунд ожидания без прогресса до перехода на резервный вариант.

Интерактивность

Параметр Interactivity определяет, отображаются ли интерактивные запросы клиентом диспетчера пакетов Windows.

Включение экспериментальных функций

Чтобы узнать, какие экспериментальные функции доступны, перейдите к тому https://aka.ms/winget-settings , где можно просмотреть экспериментальные функции, доступные для вас.

Поделиться через

команда настроек (winget)

Псевдонимы

Вложенные команды

Опции

Используйте команду winget settings

Обновление параметров

параметры источника

autoUpdateIntervalInMinutes (интервал автообновления в минутах)

визуальные параметры

индикатор прогресса

анонимизироватьОтображаемыеПути

enableSizels

Параметры ведения журнала

уровень

Настройки предпочтений и требований

охват

местность

Архитектуры

типы установщиков

Параметры installBehavior

disableInstallNotes

Параметр portablePackageUserRoot

Параметр portablePackageMachineRoot

defaultInstallRoot (стандартный корневой каталог установки)

maxResumes

archiveExtractionMethod

UninstallBehavior

ОчиститьПортативныйПакет

НастройкаПоведений

поведение при загрузке

Каталог загрузок по умолчанию

Настройки телеметрии

отключить

Параметры сети

загрузчик

doProgressTimeoutInSeconds

Интерактивность

Включение экспериментальных функций

Обратная связь

Дополнительные ресурсы