下載命令 (winget)

winget 工具的 download 命令會從選取的套件下載安裝程式。 使用 search 命令和 show 命令來識別您要下載的套件安裝程式。

download 命令需要您指定要下載的確切字串。 如果有任何不明確的情況,系統會提示您進一步將 download 命令篩選到確切的應用程式。

注意

根據預設,download 命令會將適當的安裝程式下載到使用者的 [下載] 資料夾。 使用 --download-directory 選項來指定自訂下載路徑。

使用方式

winget download [[-q] <query>] [<options>]

下載命令

引數

下列是可用的引數。

引數 描述
-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>