settings コマンド (winget)

2025-07-16

WinGet の settings コマンドを使用すると、Windows パッケージマネージャーのクライアントエクスペリエンスをカスタマイズできます。既定値を変更し、クライアントで使用できる試験的な機能を試すことができます。

settings コマンドを実行すると、既定の JSON エディターが起動します。既定では、Windows はオプションとしてメモ帳を起動します。 Visual Studio Codeなどのツールを使用することをお勧めします。

注

「winget install Microsoft.VisualStudioCode」と入力すると、Visual Studio Code を簡単にインストールできます。

エイリアス

このコマンドでは、次のエイリアスを使用できます。

config

サブコマンド

次のサブコマンドを使用できます。

サブコマンド	説明
export	設定をエクスポートします。
set	管理者設定の値を設定します。
reset	管理者設定を既定値にリセットします。

オプション

次のオプションを使用できます。

引数	説明
--enable	指定した管理者設定を有効にします。
--無効にする	指定した管理者設定を無効にします。
-?、--help	選択したコマンドに関するヘルプを表示します。
--待機	終了する前に任意のキーを押すようユーザーに求めます。
--logs、--open-logs	既定のログの場所を開きます。
--verbose、--verbose-logs	WinGet の詳細ログ記録を有効にします。
--nowarn、--ignore-warnings	警告の出力を抑制します。
--インタラクティブモードを無効にする	対話型プロンプトを無効にします。
--プロキシ	この実行に使用するプロキシを設定します。
--no-proxy	この実行に対するプロキシの使用を無効にします。

winget settings コマンドを使用する

既定の JSON 編集ツールを起動する: winget settings

設定を初めて起動すると、設定は指定されません。 JSON ファイルの上部には、最新の試験的な機能と設定を確認できる WinGet CLI 設定リンクが用意されています。

次のコードスニペットは、視覚的な出力の変更と試験的な機能を有効にした場合の設定ファイルの例を示しています。

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

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

設定ファイルのスキーマも定義しました。これにより、JSON エディターで JSON スキーマがサポートされている場合は、TAB を使用して設定と構文を検出できます。

設定の更新

Windows パッケージマネージャーの 1.11 リリースでは、次の設定を使用できます。

ソース設定

source 設定には、WinGet ソースへの構成が含まれます。

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

自動更新間隔（分）

正の整数は、更新間隔を分単位で表します。更新プログラムのチェックは、ソースが使用されている場合にのみ行われます。 0 を指定すると、ソースに対する更新のチェックが無効になります。その他の値は無効です。

無効: 0
既定値: 15

ソースを手動で更新するには、winget source updateを使用します。

ビジュアル設定

visual 設定には、WinGet によって表示されるビジュアル要素が含まれます

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

進捗バー

引数で指定されていない場合に WinGet に表示される進行状況バーの色。

アクセント (既定)
rainbow
レトロ
シクセル
無効

表示パスを匿名化

既知のフォルダーパスをそれぞれの環境変数に置き換えます。

enableSizels

特定のコンテキストでsixel画像の出力を有効化します。

ログ記録の設定

logging 設定は、ログファイルの詳細レベルを制御します。 --verbose-logs は、この設定をオーバーライドし、詳細ログを常に作成します。

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

レベル

次のログレベルを使用できます。未設定または無効な場合、既定値は info です。

詳細
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設定は、インストールが正常に完了した後にインストールノートを表示するかどうかを決定します。値が設定されていないか無効な場合、既定値は 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設定では、インストール場所が指定されていない場合に、明示的なインストールパスを必要とするパッケージの既定のインストール場所を指定します。

maxResumes

maxResumes設定では、1 つの再開 ID に対して許可される再開試行の最大数を指定します。これにより、再起動を必要とするインストールが正しく検出されない場合に、継続的な再起動が防止されます。

アーカイブ抽出方法

archiveExtractionMethod設定は、インストーラーによるアーカイブの抽出方法を制御します。サポートされている値は、shellApi と tarです。

shellApi では、Windows シェル API を使用してアーカイブを抽出します。
tar では tar コマンドを使用してアーカイブを抽出します。

UninstallBehavior

uninstallBehavior設定は、既定のアンインストールプロセスで、このパッケージに関連するすべてのファイルとディレクトリを削除するかどうかを制御します。ポータブル installerTypeにのみ適用されます。

ポータブルパッケージを削除

purgePortablePackage設定は、ポータブルパッケージをアンインストールするための既定の動作を制御します。 trueに設定すると、アンインストールによって、portable パッケージに関連するすべてのファイルとディレクトリが削除されます。この設定は、portable インストーラーの種類のパッケージにのみ適用されます。値が設定されていないか無効な場合、既定値は false になります。

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

ConfigureBehavior

ConfigureBehavior設定では、構成の適用時に PowerShell モジュールがインストールされる既定のルートディレクトリを指定します。

ダウンロード動作

downloadBehavior設定は、インストーラーのダウンロード先となる既定のディレクトリを制御します。

デフォルトダウンロードディレクトリ (defaultDownloadDirectory)

defaultDownloadDirectory設定では、パッケージのダウンロード先となる既定のディレクトリを制御します。値が設定されていないか無効な場合、既定値は %USERPROFILE%/Downloads になります。

この設定値は絶対パスである必要があります。

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

利用統計情報の設定

telemetry設定は、Windows の既定のインストールで Microsoft に送信される可能性がある ETW イベントを WinGet が書き込むかどうかを制御します。

テレメトリに関するの詳細と、の主なプライバシーに関する声明を参照してください。

無効にする

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

true に設定すると、telemetry.disable 設定によって、プログラムによってイベントが書き込まれなくなります。

ネットワーク設定

network設定は、WinGet がネットワークを使用してパッケージとメタデータを取得する方法に影響します。

ダウンローダー

downloader 設定では、パッケージのダウンロード時に使用するコードを制御します。既定値は do であり、グループポリシーによって管理される場合があります。

wininet では、WinINet API を使用しますが、do では配信の最適化サービスを使用します。

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

doProgressTimeoutInSeconds

doProgressTimeoutInSecondsは、フォールバックの前に進行せずに待機する秒数を指定します。

対話機能

Interactivity設定では、Windows パッケージマネージャークライアントで対話型プロンプトを表示するかどうかを制御します。

試験的な機能の有効化

使用できる試験的な機能を確認するには、https://aka.ms/winget-settings に移動して、使用可能な試験的な機能を確認してください。

次の方法で共有

settings コマンド (winget)

エイリアス

サブ コマンド

オプション

winget settings コマンドを使用する

設定の更新

ソース設定

自動更新間隔（分）

ビジュアル設定

進捗バー

表示パスを匿名化

enableSizels

ログ記録の設定

レベル

基本設定と要件の設定

スコープ

ロケール

アーキテクチャ

インストーラータイプ

installBehavior の設定

インストールノートを無効にする

portablePackageUserRoot の設定

portablePackageMachineRoot の設定

既定のインストールルート

maxResumes

アーカイブ抽出方法

UninstallBehavior

ポータブルパッケージを削除

ConfigureBehavior

ダウンロード動作

デフォルトダウンロードディレクトリ (defaultDownloadDirectory)

利用統計情報の設定

無効にする

ネットワーク設定

ダウンローダー

doProgressTimeoutInSeconds

対話機能

試験的な機能の有効化

フィードバック

その他のリソース

サブコマンド