settings команда (winget)

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

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

Замечание

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

Псевдонимы

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

config

Подкоманды

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

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

Опции

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

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

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

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

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

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

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

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

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

Обновление settings

Ниже перечислены settings, доступные в выпуске Windows диспетчер пакетов 1.28.

Источник settings

source settings включают настройку источника WinGet.

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

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

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

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

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

визуальный settings

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

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

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

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

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

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

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

enableSixels

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

журналирование settings

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

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

уровень

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

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

channels

Параметр channels ограничивает выходные данные ведения журнала определенными каналами журнала. Также принимаются специальные значения default (набор каналов по умолчанию) и all (все каналы). Недопустимые значения игнорируются.

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

файл

file settings управляют автоматической очисткой файлов журналов в каталоге журналов по умолчанию. Процесс очистки начинается в начале каждого процесса WinGet и применяется только к расположению журнала по умолчанию.

Setting	Описание	По умолчанию
`ageLimitInDays`	Максимальный возраст в днях файлов в каталоге журнала; старые файлы удаляются. Установите `0`, чтобы отключить.	7
`totalSizeLimitInMB`	Максимальный общий размер в мегабайтах всех файлов в каталоге журнала; Старые файлы сначала удаляются. Установите `0`, чтобы отключить.	128
`countLimit`	Максимальное количество файлов в каталоге журнала; Старые файлы сначала удаляются. Установите `0`, чтобы отключить.	0 (отключено)
`individualSizeLimitInMB`	Максимальный размер в мегабайтах одного файла журнала. Если размер файла превысит это ограничение, журналы будут перезаписаны. Установите `0`, чтобы отключить.	16

"logging": {
    "level": "verbose",
    "file": {
        "ageLimitInDays": 7,
        "totalSizeLimitInMB": 128,
        "countLimit": 0,
        "individualSizeLimitInMB": 16
    }
}

предпочтения и требования settings

Некоторые элементы settings дублируются в 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 влияет на выбор типов установщиков при установке пакета. Он также может определить, какой тип устанавливается по умолчанию, если манифест имеет несколько типов: список находится в порядке приоритета, при этом первый указанный тип предпочтителен для других и т. д. Это удобно для пользователей, которые, например, предпочитают переносимые пакеты или установки MSIX/AppX. Совпадающий параметр — --installer-type, который переопределит settings.

Допустимые значения по состоянию на версию 1.12.470 включают: appxburnexefontinnomsimsixmsstorenullsoftportablewix,zip

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

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

installBehavior settings

Управление installBehaviorsettings поведением по умолчанию при установке и обновлении пакетов (где применимо).

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 settings задают каталог по умолчанию, в который загружаются установщики.

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

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

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

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

Телеметрия settings

Параметры telemetrysettings определяют, записывает ли WinGet события ETW, которые могут отправляться в Microsoft в стандартной установке Windows.

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

отключить

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

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

Сеть settings

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

загрузчик

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

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

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

doProgressTimeoutInSeconds

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

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

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

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

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

experimentalFeatures settings включают настройку этих «экспериментальных» функций. Отдельные функции можно включить в этом узле:

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

directMSI

Эта функция позволяет диспетчеру пакетов Windows напрямую устанавливать пакеты MSI с API MSI, а не через msiexec. Обратите внимание, что при тихой установке это уже действует, так как пакеты MSI, требующие повышения привилегий, будут завершены с ошибкой в этом сценарии, если это не сделать.

"experimentalFeatures": {
    "directMSI": true
}

резюме / возобновить

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

"experimentalFeatures": {
    "resume": true
}

Шрифты

Эта функция обеспечивает поддержку шрифтов с помощью winget settings. Команда winget font list выводит список установленных семейств шрифтов и количество установленных начертаний шрифта.

"experimentalFeatures": {
    "fonts": true
}

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

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

Обратите внимание, что порядок результатов поиска зависит от нескольких факторов, и приоритет источника в настоящее время является наименьшим полем (качество соответствия и поле более важны).

"experimentalFeatures": {
    "sourcePriority": true
}

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

Были ли сведения на этой странице полезными?

Last updated on 2026-05-20

settings команда (winget)

Псевдонимы

Подкоманды

Опции

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

Обновление settings

Источник settings

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

визуальный settings

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

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

enableSixels

журналирование settings

уровень

channels

файл

предпочтения и требования settings

охват

местность

Архитектуры

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

installBehavior settings

disableInstallNotes

Параметр portablePackageUserRoot

Параметр portablePackageMachineRoot

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

maxResumes

archiveExtractionMethod

UninstallBehavior

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

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

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

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

Телеметрия settings

отключить

Сеть settings

загрузчик

doProgressTimeoutInSeconds

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

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

directMSI

резюме / возобновить

Шрифты

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

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

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