download 命令 (winget)
winget 工具的下载命令将下载安装程序、依赖项和许可证文件（下载 Microsoft Store 的打包应用时）。 使用 search 命令和 show 命令识别要下载的包安全程序。
download 命令要求你指定要下载的具体字符串。 如果存在任何不明确性，系统会提示你进一步将 download 命令筛选到具体的应用程序。
下载命令需要 EntraID（正式的 Azure Active Directory）身份验证才能下载 Microsoft Store 的打包应用（*.msix、*.appx、*.msixbundle 或 *.appxbundle），并下载 Microsoft Store 的打包应用许可证文件。 用于生成和检索 Microsoft Store 打包应用许可证文件的身份验证的 EntraID 帐户必须是以下三个 Azure 角色之一的成员：全局管理员、用户管理员或许可证管理员。
注意
默认情况下，download 命令会将相应的安装程序下载到用户的 Downloads 文件夹。 使用 --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 | 将下载限制为应用程序的 ID。 |
| --name | 将搜索限制为应用程序的名称。 |
| --moniker | 将搜索限制为针对应用程序列出的名字对象。 |
| -v、--version | 允许你指定要安装的确切版本。 如果未指定，则使用 latest 将下载最新版本的应用程序。 |
| -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 | 指定身份验证窗口首选项（无提示、无提示首选或交互）。 |
| --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 | 设置要用于此执行的代理。 |
| --no-proxy | 禁用此执行使用代理。 |
示例查询
以下示例会根据应用程序的 ID 下载特定版本的应用程序。
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>
