settings コマンド (winget)

[アーティクル]
2025-05-06

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

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

注

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

別名

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

設定

winget settings コマンドを使用する

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

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

次のコードスニペットは、これらの試験的な機能と設定の一部を有効または変更する場合の設定ファイルの例です。

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

    // For documentation on these settings, see: https://aka.ms/winget-settings
    "experimentalFeatures": {
	  "dependencies": true,
	  "directMSI": false,
	  "zipInstall": false,
    },
    "visual": {
        "progressBar": "rainbow"
    },
    "source": {
        "autoUpdateIntervalInMinutes": 5
    },
}

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

注

試験的な機能は、プレビュービルドでのみ使用できます。プレビュービルドを取得する手順については、GitHub リポジトリを参照してください。

設定の更新

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

ソース設定

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

"source": {
    "autoUpdateIntervalInMinutes": 3
},

自動更新間隔（分）

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

無効: 0
既定値: 5

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

ビジュアル設定

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

"visual": {
    "progressBar": "accent"
},

進捗バー

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

アクセント (既定)
レトロ
虹

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"
    },

基本設定と要件の設定

一部の設定は、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"]
        }
    },

アンインストールの動作

uninstallBehavior 設定は、パッケージのアンインストール (該当する場合) の既定の動作に影響します。

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

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

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

downloadBehavior

downloadBehavior設定は、パッケージのダウンロードの既定の動作に影響します。

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

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

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

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

テレメトリの設定

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

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

無効にする

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

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

ネットワーク設定

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

ダウンローダー

downloader 設定では、パッケージのダウンロード時に使用するコードを制御します。既定値は defaultです。これは、決定に基づくオプションのいずれかである可能性があります。

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

"network": {
    "downloader": "do"
}

ログ記録の設定

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

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

レベル

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

冗長
インフォ
警告
エラー
critical

試験的な機能の有効化

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

次の方法で共有

settings コマンド (winget)

別名

winget settings コマンドを使用する

設定の更新

ソース設定

自動更新間隔（分）

ビジュアル設定

進捗バー

installBehavior の設定

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

portablePackageUserRoot の設定

portablePackageMachineRoot の設定

基本設定と要件の設定

範囲

ロケール

アーキテクチャ

インストーラータイプ

アンインストールの動作

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

downloadBehavior

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

テレメトリの設定

無効にする

ネットワーク設定

ダウンローダー

ログ記録の設定

レベル

試験的な機能の有効化

その他のリソース