list WinGet 的命令显示list计算机上当前安装的应用程序。 list 命令将显示通过Windows 程序包管理器安装的应用,以及通过其他方式安装的应用。
该 list 命令还会显示是否有应用可用的更新,并且你可以使用 升级 命令来更新应用。
该 list 命令还支持可用于限制查询的 list 筛选器。
别名
以下别名可用于此命令:
ls
使用情况
winget list [[-q] <query>] [<options>]
要 list 所有有可用更新的应用,请使用以下命令:winget list --upgrade-available(不带任何参数)。
参数
可使用以下参数。
| 参数 | 说明 |
|---|---|
| -q,--query | 用于搜索应用的查询。 |
注意
查询参数是位置参数。 不支持通配符样式语法。 这通常是你期望帮助查找所搜索的已安装程序包的字符串。
选项
通过这些选项,你可以自定义 list 体验以满足你的需求。
| 选项 | 说明 |
|---|---|
| --id | 将 list 限制为应用程序的 ID。 |
| --名字 | 将 list 限制为应用程序的名称。 |
| --moniker | 将 list 限制为为该应用程序列出的别名对象。 |
| -s、--source | 将 list 限定为指定的源名称。 必须后跟源名称。 |
| --tag | 按标记筛选结果。 |
| --cmd、--command | 按应用程序指定的命令筛选结果。 |
| -n、--count | 限制一个查询中显示的应用数。 |
| -e、--exact | 使用 list 查询中的精确字符串,包括检查是否区分大小写。 它不会使用子字符串的默认行为。 |
| --范围 | 选择已安装的包范围筛选器(用户或计算机)。 |
| --header | 可选 Windows-Package-Manager REST 源 HTTP 标头。 |
| --authentication-mode | 指定身份验证窗口首选项(无提示、无提示首选或交互)。 |
| --认证账户 | 指定用于身份验证的帐户。 |
| --accept-source-agreements | 用于接受源许可协议,并避免出现提示。 |
| --upgrade-available | 仅列出具有可用升级的包。 |
| -u、--unknown、--include-unknown | 即使无法确定包的当前版本,也列出包。 |
| --pinned、--include-pinned | 即使包有阻止 WinGet 升级的 PIN 码,也列出包。 |
| --细节 | 显示每个匹配包的详细输出,形式类似show,而不是表视图。 |
| -?--帮助 | 获取有关此命令的更多帮助。 |
| --等 | 提示用户在退出前按任意键。 |
| --logs,--open-logs | 打开默认日志位置。 |
| --verbose、--verbose-logs | 用于替代日志记录设置并创建详细日志。 |
| --nowarn, --ignore-warnings | 禁止警告输出。 |
| --disable-interactivity | 禁用交互式提示。 |
| --proxy | 设置要用于此执行的代理。 |
| --no-proxy | 禁用此执行使用代理。 |
查询示例
以下示例列出名称中具有给定子字符串的已安装应用程序。
以下示例按 ID 列出来自特定源的所有应用程序。
以下示例将输出 list 限制为 9 个应用。
列出更新
如前所述, list 该命令允许你查看已安装哪些应用具有可用升级。
在下图中,你会注意到具有可用升级的应用程序。
该 list 命令不仅显示可用的更新版本,还会显示更新从中提供的源。
如果没有可用的更新, list 将仅显示当前已安装的版本,并且不会显示更新列。
包含详细信息的列表
以下示例按其标识符列出已安装应用程序的详细信息。