共用方式為


下載命令 (winget)

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>]

在 Windows 終端機命令行中輸入 winget 下載命令的螢幕快照。

在沒有授權檔案時下載

使用 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>