list 命令 (winget)

WinGetlist 命令显示计算机上当前安装的应用程序。 list 命令将显示通过 Windows 程序包管理器安装的应用以及通过其他方式安装的应用。

如果某个应用有可用更新,list 命令也会显示,你可使用 upgrade 命令更新相应的应用

list 命令还支持可用于限制列出查询的筛选器。

别名

以下别名可用于此命令:

  • ls

使用情况

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

显示 winget list 命令选项的屏幕截图。

若要列出具有可用更新的所有应用,请使用命令: winget list --upgrade-available (没有任何参数)。

参数

可使用以下参数。

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

注意

查询参数是位置参数。 不支持通配符样式语法。 这通常是你期望帮助查找所搜索的已安装程序包的字符串。

选项

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

选项 说明
--id 将列出限制为应用程序的 ID。
--名字 将列出限制为应用程序的名称。
--moniker 将列出限制为针对应用程序列出的名字对象。
-s, --source 将列出限制为所提供的源名称。 必须后跟源名称。
--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 码,也列出包。
-?, --help 获取有关此命令的更多帮助。
--等 提示用户在退出前按任意键。
--logs,--open-logs 打开默认日志位置。
--verbose、--verbose-logs 用于替代日志记录设置并创建详细日志。
--nowarn, --ignore-warnings 禁止警告输出。
--disable-interactivity 禁用交互式提示。
--proxy 设置要用于此执行的代理。
--no-proxy 禁用此执行使用代理。

查询示例

以下示例列出名称中具有给定子字符串的已安装应用程序。

将 winget --list git 命令用于名称为 git 的所有已安装应用程序的屏幕截图。

以下示例按 ID 列出来自特定源的所有应用程序。

列出 winget list --id Git.Git 的屏幕截图,其中显示来自该源的所有已安装应用程序。

以下示例将 list 的输出限制为 9 个应用

列出 winget list --count 9 的屏幕截图,其中将列出的已安装应用数仅限制为 9。

列出更新

如上所述, 列表 命令允许查看已安装哪些应用具有可用升级。

在下图中,你会注意到具有可用升级的应用程序。

列出 wwinget list --upgrade-available 的屏幕截图,其中显示具有可用升级的已安装应用。

list 命令不仅会显示可用的更新版本,而且会显示该可用更新的来源

如果没有可用更新,list 将只显示当前已安装的版本,而不会显示更新列