WinGet 的下載命令會下載安裝程式、相依性和授權檔案(下載Microsoft市集已封裝應用程式時)。 使用 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 位元處理器 |
手臂 | 32 位元 ARM 處理器 |
arm64 | 64 位元 ARM 處理器 |
引數
下列是可用的引數。
引數 | 描述 |
---|---|
-q,--query | 用來搜尋應用程式的查詢。 |
注意
查詢引數是位置性。 不支援萬用字元樣式語法。 這通常是您希望唯一標識要下載之套件的字元字串。
選項
這些選項可讓您自訂下載體驗,以符合您的需求。
選項 | 描述 |
---|---|
-d, --download-directory | 下載安裝程式的目錄。 |
-m, --manifest | 後面必須接著資訊清單 (YAML) 檔案的路徑。 |
--id | 請將下載作業限制在該應用程式的識別碼。 |
--名稱 | 將搜尋限制為應用程式的名稱。 |
--綽號 | 將搜尋限制為針對應用程式列出的別名。 |
-v,--version | 讓您指定要安裝的確切版本。 若未指定,則會下載目前最新版本的應用程式。 |
-s、 --source | 將搜尋限制為提供的來源名稱。 後面必須加上來源名稱。 |
--範圍 | 可讓您指定安裝程式是否應以使用者或電腦搜尋範圍為目標。 請參閱關於封裝安裝範圍的已知問題。 |
-a,--architecture | 選取要下載的架構。 |
--installer-type (安裝程式類型) | 選取要下載的安裝程式類型。 |
-e, --exact | 在查詢中使用確切字串,包括檢查是否區分大小寫。 其不會使用子字串的預設行為。 |
--語區 | 指定要使用 BCP47 格式的地區設定。 |
--忽略安全哈希 | 忽略安裝程式雜湊檢查失敗。 不建議使用。 |
--skip-dependencies(跳過相依性) | 略過處理套件相依性與 Windows 功能。 |
--頁眉 | 選用性的 Windows-Package-Manager REST 來源 HTTP 標頭。 |
--authentication-mode | 指定驗證視窗喜好設定 (silent、silentPreferred 或 interactive)。 |
--authentication-account(驗證帳戶) | 指定要用於驗證的帳戶。 |
--accept-package-agreements(接受軟體合約) | 用於接受授權合約且避免提示。 |
--接受來源協議 | 用於接受來源授權合約且避免提示。 |
--skip-license,--skip-microsoft-store-package-license | 略過擷取 Microsoft Store 套件離線授權。 |
--平臺 | 選擇目標平台。 |
-?, --幫助 | 取得此命令的其他說明。 |
--等 | 提示使用者在結束之前按任何鍵。 |
--logs,--open-logs | 開啟預設記錄位置。 |
--verbose、--verbose-logs | 用於覆寫記錄設定,並建立詳細資訊記錄。 |
--nowarn(不顯示警告),--ignore-warnings(忽略警告) | 隱藏警告輸出。 |
--禁用互動功能 | 停用互動式提示。 |
--代理 | 設定此執行所要使用的 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>