下載命令 (winget)
winget 工具的 download 命令會下載安裝程式、相依性和授權檔案 (當下載 Microsoft Store 已封裝應用程式時)。 使用 search 命令和 show 命令來識別您要下載的套件安裝程式。
download 命令需要您指定要下載的確切字串。 如果有任何不明確的情況，系統會提示您進一步將 download 命令篩選到確切的應用程式。
download 命令需要 EntraID (先前稱為 Azure Active Directory) 驗證 來下載 Microsoft Store 已封裝應用程式 (*.msix、*.appx、*.msixbundle 或 *.appxbundle) 以及下載 Microsoft Store 已封裝應用程式授權檔案。 用於供驗證產生及擷取 Microsoft Store 已封裝應用程式授權檔案的 EntraID 帳戶必須是下列其中一個 Azure 角色的成員：全域管理員、使用者管理員或授權管理員。
注意
根據預設，download 命令會將適當的安裝程式下載到使用者的 [下載] 資料夾。 使用 --download-directory 選項來指定自訂下載路徑。
使用方式
winget download [[-q] <query>] [<options>]
在沒有授權檔案時下載
使用 WinGet 下載套件時，可以透過在命令中附加 --skip-license 參數來省略套件授權檔案。 排除套件授權檔案將會刪除產生離線授權檔案的授權需求。
winget download [[--id] <package id>] [[--skip-license]] [<options>]
特定平台的下載
使用 WinGet 下載套件時，依預設將會針對每個適用的使用案例 (架構、裝置平台等) 下載套件的最新可用版本。 篩選特定裝置平台的下載內容是透過在命令中附加 --platform 參數完成的。
winget download [[--id] <package id>] [[--platform] <platform type> ] [<options>]
| 平台 | 描述 |
|---|---|
| Windows.Desktop | 在 Windows 桌面體驗上安裝支援 |
| Windows.Universal | 在所有 Microsoft 作業系統上安裝支援 |
| Windows.Holographic | 在 Microsoft HoloLens 裝置上安裝支援 |
特定架構的下載
使用 WinGet 下載套件時，依預設將會針對每個適用的使用案例 (架構、裝置平台等) 下載套件的最新可用版本。 使用特定架構篩選下載的內容是透過在命令中附加 --architecture 參數完成的。
winget download [[--id] <package id>] [[--architecture] <Architecture>] [<options>]
| 架構 | 描述 |
|---|---|
| x86 | 32 位元處理器 |
| x64 | 64 位元處理器 |
| arm | 32 位元 ARM 處理器 |
| arm64 | 64 位元 ARM 處理器 |
引數
下列是可用的引數。
| 引數 | 描述 |
|---|---|
| -q,--query | 用來搜尋應用程式的查詢。 |
注意
查詢引數是位置性。 不支援萬用字元樣式語法。 這通常是您希望唯一標識要下載之套件的字元字串。
選項。
這些選項可讓您自訂下載體驗，以符合您的需求。
| 選項 | 描述 |
|---|---|
| -d, --download-directory | 下載安裝程式的目錄。 |
| -m, --manifest | 後面必須接著資訊清單 (YAML) 檔案的路徑。 |
| --id | 請將下載作業限制在該應用程式的識別碼。 |
| --name | 將搜尋限制為應用程式的名稱。 |
| --moniker | 將搜尋限制為針對應用程式列出的別名。 |
| -v, --version | 讓您指定要安裝的確切版本。 若未指定，則會下載目前最新版本的應用程式。 |
| -s, --source | 將搜尋限制為提供的來源名稱。 後面必須加上來源名稱。 |
| --scope | 可讓您指定安裝程式是否應以使用者或電腦搜尋範圍為目標。 請參閱關於封裝安裝範圍的已知問題。 |
| -a, --architecture | 選取要下載的架構。 |
| --installer-type | 選取要下載的安裝程式類型。 |
| -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 | 設定此執行所要使用的 Proxy。 |
| --no-proxy | 停用此執行的 Proxy。 |
查詢範例
下列範例從應用程式的識別碼下載應用程式的特定版本。
winget download --id Microsoft.PowerToys --version 0.15.2
下列範例下載具有特定安裝程式類型的應用程式。
winget download --id Microsoft.WingetCreate --installer-type msix
下列範例會依架構和範圍下載應用程式至特定的下載目錄。
winget download --id Microsoft.PowerToys --scope machine --architecture x64 --download-directory <Path>
