設定 winget 工具 命令會使用 WinGet 組態檔,開始將 Windows 計算機設定為所需的開發環境狀態。
警告
不先檢閱檔案的內容並驗證相關資源的信譽,請勿執行 WinGet 組態檔。 請參閱 如何檢查 WinGet 設定檔的可信度。
先決條件
- Windows 10 版本 1809(組建 17763)或更新版本,或 Windows 11。
- WinGet 1.6.2631 版或更新版本。
別名
此命令可用的別名如下:
- 設定
- dsc
用法
winget configure -f <C:/Users/<username>/winget-configs/config-file-name.dsc.yaml>
一旦您識別出您有興趣使用的 winget 組態檔、確認該檔案的安全性和可靠性,並將檔案下載到本機計算機之後,您就可以使用 winget configure
命令來起始設定的設定。
參數和選項
下列參數可供使用:
論點 | 說明 |
---|---|
-f,--file (檔案) | winget 組態檔的路徑。 |
--module-path | 指定要儲存模組之本機計算機上的位置。 默認 %LOCALAPPDATA%\Microsoft\WinGet\Configuration\Modules。 |
--processor-path | 指定組態處理器的路徑。 |
-h,--歷史紀錄 | 從歷史記錄中選取項目。 |
--accept-configuration-agreements(接受配置協議) | 接受設定警告,防止互動式提示。 |
--suppress-initial-details | 盡可能隱藏顯示初始設定詳細數據。 |
--使 | 啟用配置元件。 需要商店存取權。 |
--禁用 | 停用配置元件。 需要商店存取權。 |
-?--幫助 | 顯示所選命令的說明。 |
--等 | 提示用戶在結束之前按下任何按鍵。 |
--logs,--open-logs | 開啟預設記錄位置。 |
--verbose,--verbose-logs | 啟用 winget 的詳細日誌記錄。 |
--nowarn,--ignore-warnings(忽略警告訊息的選項) | 隱藏警告輸出。 |
--disable-interactivity(停用互動性) | 停用互動式提示。 |
--代理 | 設定此執行所要使用的 Proxy。 |
--no-proxy (無代理) | 停用此執行的 Proxy。 |
設定子命令
這個指令 winget configure
包含許多子命令,包括:
-
winget configure show
:顯示組態檔的詳細數據。 使用方式:winget configure show -f <file>
。 執行命令:winget configuration show configuration.dsc.yaml
會顯示目前工作目錄中組態的詳細數據。 -
winget configure list
:顯示已套用至系統的組態的高階詳細數據。 然後,此數據可以與其他命令搭配configure
使用,以取得更多詳細數據。 使用方式:winget configure list [<options>]
-
winget configure test
:根據所需的狀態檢查系統,顯示目前的系統狀態是否符合相關聯組態檔中定義的預期狀態。 使用方式:winget configure test -f <file>
。 -
winget configure validate
:驗證組態檔。 使用方式:winget configure validate [-f] <file> [<options>]
。 -
winget configure export
:將組態資源匯出至組態檔。 搭配--all
使用 時,會匯出所有封裝組態。 搭配--packageId
使用 時,會匯出指定套件標識符的 WinGetPackage 資源。 搭配--module
和--resource
使用時,會匯出指定資源的設定。 如果輸出組態檔已經存在,請附加導出的組態資源。 使用方式:winget configure export -o <output file> [<options>]