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 に移動して、使用可能な試験的な機能を確認してください。
Windows developer