winget 的 download 命令會下載安裝程式、相依項目和授權檔案（下載 Microsoft Store 封裝應用程式時）。 請使用 指令 search 和 指令 show 來識別你想要的 download套件安裝程式。
此 download 指令要求你指定精確的字串到 download。 若有任何歧義，系統會提示您進一步篩選 download 該指令至特定應用程式。
此download指令要求對 Microsoft Store 包裝的應用程式（、、download*.msix或*.appx*.msixbundle）及 Microsoft Store 包裝的應用程式授權檔案進行 *.appxbundledownload。 用於產生及檢索 Microsoft Store 套件應用程式授權檔案的 Microsoft Entra ID 帳號，必須屬於以下三個 Azure 角色之一：全域管理員、使用者管理員或授權管理員。
附註
預設情況下，該 download 指令會將 download 適當的安裝程式傳送到使用者的 Downloads 資料夾。 使用 --download-directory 選項來指定自訂 download 路徑。
使用方式
winget download [[-q] <query>] [<options>]
在沒有授權檔案時下載
使用 WinGet 下載套件時，可以透過在命令中附加 --skip-license 參數來省略套件授權檔案。 排除套件授權檔案將會刪除產生離線授權檔案的授權需求。
winget download [[--id] <package id>] [[--skip-license]] [<options>]
下載特定平台版本
使用 WinGet 下載套件時，預設會針對 download 每個適用的使用情境（架構、裝置平台等）提供最新版本的套件。 篩選特定裝置平台的下載內容是透過在命令中附加 --platform 參數完成的。
winget download [[--id] <package id>] [[--platform] <platform type> ] [<options>]
| 平台 | 描述 |
|---|---|
| Windows.Desktop | 在 Windows 桌面體驗上安裝支援 |
| Windows.Universal | 在所有 Microsoft 作業系統上安裝支援 |
| Windows.Holographic | 在 Microsoft HoloLens 裝置上安裝支援 |
下載特定架構版本
使用 WinGet 下載套件時，預設會針對 download 每個適用的使用情境（架構、裝置平台等）提供最新版本的套件。 使用特定架構篩選下載的內容是透過在命令中附加 --architecture 參數完成的。
winget download [[--id] <package id>] [[--architecture] <Architecture>] [<options>]
| 架構 | 描述 |
|---|---|
x86 |
32 位元處理器 |
x64 |
64 位元處理器 |
arm |
32 位元 ARM 處理器 |
arm64 |
64 位元 ARM 處理器 |
引數
下列是可用的引數。
| 引數 | 描述 |
|---|---|
-q、--query |
用來搜尋應用程式的查詢。 |
附註
查詢引數是位置性。 不支援萬用字元樣式語法。 這通常是你預期用來唯一識別想要 download 的套件的字元字串。
選項
這些選項讓你能依需求客製化 download 體驗。
| 選項 | 描述 |
|---|---|
-d、--download-directory |
下載安裝程式的目錄。 |
-m、--manifest |
後面必須接著資訊清單 (YAML) 檔案的路徑。 |
--id |
將 download 限制為該應用程式的 ID。 |
--name |
將搜尋限制為應用程式的名稱。 |
--moniker |
將搜尋限制為針對應用程式列出的別名。 |
-v、--version |
讓您指定要安裝的確切版本。 若未指定，最新版本將為 download 最高版本的應用程式。 |
-s、--source |
將搜尋限制為提供的來源名稱。 後面必須加上來源名稱。 |
--scope |
可讓您指定安裝程式應以使用者範圍或電腦範圍為目標。 請參閱關於封裝安裝範圍的已知問題。 |
-a、--architecture |
選擇架構為 download。 |
--installer-type |
選擇安裝器類型為 download。 |
-e、--exact |
在查詢中使用確切字串，包括檢查是否區分大小寫。 其不會使用子字串的預設行為。 |
--locale |
指定要使用哪個地區設定（BCP47 格式）。 |
--ignore-security-hash |
忽略安裝程式雜湊檢查失敗。 不建議使用。 |
--skip-dependencies |
略過處理套件相依性與 Windows 功能。 |
--header |
選用的 Windows-Package-Manager REST 來源 HTTP 標頭。 |
--authentication-mode |
指定驗證視窗喜好設定 (silent、silentPreferred 或 interactive)。 |
--authentication-account |
指定要用於驗證的帳戶。 |
--accept-package-agreements |
用於接受授權協議，並避免顯示提示。 |
--accept-source-agreements |
用於接受原始授權合約，並避免顯示提示。 |
--skip-license、--skip-microsoft-store-package-license |
略過取得 Microsoft Store 套件的離線授權。 |
--platform |
選擇目標平台。 |
-?、--help |
取得此命令的更多說明。 |
--wait |
提示使用者在結束之前按任何鍵。 |
--logs、--open-logs |
開啟預設記錄位置。 |
--verbose、--verbose-logs |
用於覆寫記錄設定，並建立詳細記錄。 |
--nowarn、--ignore-warnings |
隱藏警告輸出。 |
--disable-interactivity |
停用互動式提示。 |
--proxy |
設定此次執行要使用的代理伺服器。 |
--no-proxy |
停用此次執行使用代理伺服器。 |
查詢範例
下列範例從應用程式的識別碼下載應用程式的特定版本。
winget download --id Microsoft.PowerToys --version 0.15.2
下列範例下載具有特定安裝程式類型的應用程式。
winget download --id Microsoft.WingetCreate --installer-type msix
以下範例依架構與範圍將應用程式下載到特定 download 目錄。
winget download --id Microsoft.PowerToys --scope machine --architecture x64 --download-directory <Path>
