download 命令 (winget)

  • 项目

winget 工具的 download 命令会从所选包中下载安装程序。 使用 search 命令和 show 命令识别要下载的包安全程序。

download 命令要求你指定要下载的具体字符串。 如果存在任何不明确性，系统会提示你进一步将 download 命令筛选到具体的应用程序。

注意

默认情况下，download 命令会将相应的安装程序下载到用户的 Downloads 文件夹。 使用 --download-directory 选项指定自定义下载路径。

注意

截至 2024 年 3 月，下载选项不支持 msstore 源。

使用情况

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

下载命令

参数

可使用以下参数。

参数 说明
-q、--query 用于搜索应用的查询。

注意

查询参数是位置参数。 不支持通配符样式语法。 这通常是你期望唯一标识要下载的包的字符串。

选项

这些选项让你可以根据自己的需求自定义下载体验。

选项 说明
-d, --download-directory 将安装程序下载到的目录。
-m、--manifest 必须后跟清单 (YAML) 文件的路径。
--id 将下载限制为应用程序的 ID。
--name 将搜索限制为应用程序的名称。
--moniker 将搜索限制为针对应用程序列出的名字对象。
-v、--version 允许你指定要安装的确切版本。 如果未指定，则使用 latest 将下载最新版本的应用程序。
-s、--source 将搜索限制为所提供的源名称。 必须后跟源名称。
--scope 用于指定安装程序是应该以用户还是计算机范围为目标。 查看与包安装范围相关的已知问题。
-a, --architecture 选择要下载的体系结构。
--installer-type 选择要下载的安装程序类型。
-e、--exact 在查询中使用确切的字符串，包括检查是否区分大小写。 它不会使用子字符串的默认行为。
--locale 指定要使用的区域设置（BCP47 格式）。
-o、--log 将日志记录定向到日志文件。 必须提供你具有写入权限的文件的路径。
--ignore-security-hash 替代安装程序哈希检查。 建议不要使用。
--accept-package-agreements 用于接受许可协议，并避免出现提示。
--accept-source-agreements 用于接受源许可协议，并避免出现提示。
-?、--help 获取有关此命令的更多帮助。
--wait 提示用户在退出前按任意键。
--logs,--open-logs 打开默认日志位置。
--verbose, --verbose-logs 用于替代日志记录设置并创建详细日志。
--disable-interactivity 禁用交互式提示。

示例查询

以下示例会根据应用程序的 ID 下载特定版本的应用程序。

winget download --id Microsoft.PowerToys --version 0.15.2

以下示例会下载具有特定安装程序类型的应用程序。

winget download --id Microsoft.WingetCreate --installer-type msix

以下示例按体系结构和范围将应用程序下载到特定的下载目录。

winget install --id Microsoft.PowerToys --scope machine --architecture x64 --download-directory <Path>