設定命令（winget）

WinGet 的設定命令可讓您自定義 Windows 套件管理員客戶端體驗。 您可以變更預設值，並試用用戶端中可用的實驗性功能。

[設定] 命令會啟動您的預設 JSON 編輯器。 Windows 預設會啟動 [記事本] 作為選項。 我們建議使用 Visual Studio 程式代碼之類的工具。

備註

您可以輸入 ，輕鬆地安裝 Visual Studio Code winget install Microsoft.VisualStudioCode

別名

此命令可用的別名如下：

• 設定

子命令

下列子命令可供使用。

Sub-Command	說明
匯出	匯出設定。
設定	設定系統管理員設定的值。
重設	將系統管理員設定重設為其預設值。

選項

有下列選項可供使用：

論點	說明
--啟用	啟用指定的系統管理員設定。
--禁用	停用指定的系統管理員設定。
-？--幫助	顯示所選命令的說明。
--等	提示用戶在結束之前按下任何按鍵。
--logs,--open-logs	開啟預設記錄位置。
--verbose,--verbose-logs	啟用 winget 的詳細日誌記錄。
--nowarn（不顯示警告），--ignore-warnings（忽略警告）	隱藏警告輸出。
--禁用互動功能	停用互動式提示。
--代理	設定要用於此運行的代理。
--no-proxy	停用此次執行的代理伺服器使用。

使用 winget 設定命令

啟動您的預設 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
• 默認值：15

若要手動更新來源，請使用 winget source update。

視覺效果設定

visual 設定牽涉到 WinGet 所顯示的視覺元素

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

進度條

WinGet 未指定自變數時所顯示的進度列色彩。

• 輔色 （預設值）
• 彩虹
• 復古
• sixel
• 停用

匿名化顯示的路徑

以各自的環境變數取代一些已知的資料夾路徑。

啟用Sizels

在特定情境中啟用 Sixel 影像的輸出。

記錄設定

設定 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 設定會指定需要明確安裝路徑之套件的預設安裝位置。

maxResumes

此設定 maxResumes 指定每一個簡歷 ID 允許的重試次數上限。 如果未正確偵測到需要重新啟動的安裝，這會防止連續重新啟動。

檔案庫提取方法

設定 archiveExtractionMethod 會控制安裝程式如何擷取封存。 支援的值為 shellApi 和 tar。

• shellApi 會使用 Windows Shell API 來擷取封存。

• tar 會使用 tar 命令來擷取封存。

UninstallBehavior

此 uninstallBehavior 設定可控制預設卸載程式是否移除與這個套件相關的所有檔案和目錄。 只適用於可攜式 installerType。

清除便攜式套件

設定 purgePortablePackage 會控制卸載可攜式套件的預設行為。 如果設定為 true，卸載將會移除與套件相關的 portable 所有檔案和目錄。 此設定僅適用於具有 portable 安裝程式類型的套件。 false如果未設定值或無效，則預設為 。

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

ConfigureBehavior

此 ConfigureBehavior 設定會指定套用組態時，PowerShell 模組安裝至的預設根目錄。

下載行為

設定 downloadBehavior 會控制下載安裝程式的預設目錄。

預設下載目錄

設定 defaultDownloadDirectory 會控制下載套件的預設目錄。 %USERPROFILE%/Downloads如果未設定值或無效，則預設為 。

這個設定值必須是絕對路徑。

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

遙測設置

設定 telemetry 可控制 WinGet 是否會在 Windows 的預設安裝上寫入可能傳送至Microsoft的 ETW 事件。

請參閱 遙測的詳細數據，以及主要隱私聲明。

停用

"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 您可以在何處查看可供您使用的實驗性功能。