list 命令 (winget)

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

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

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

别名

以下别名可用于此命令：

• ls

使用情况

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

注意

如果想要列出具有可用更新的所有应用，请使用 winget upgrade（不带任何参数）。

参数

可使用以下参数。

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

注意

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

选项

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

选项	说明
--id	将列出限制为应用程序的 ID。
--name	将列出限制为应用程序的名称。
--moniker	将列出限制为针对应用程序列出的名字对象。
-s、--source	将列出限制为所提供的源名称。 必须后跟源名称。
--tag	按标记筛选结果。
--cmd，--command	按应用程序指定的命令筛选结果。
-n、--count	限制一个查询中显示的应用数。
-e、--exact	在 list 查询中使用确切的字符串，包括检查是否区分大小写。 它不会使用子字符串的默认行为。
--scope	选择已安装的包范围筛选器（用户或计算机）。
--header	可选 Windows-Package-Manager REST 源 HTTP 标头。
--accept-source-agreements	用于接受源许可协议，并避免出现提示。
--upgrade-available	仅列出具有可用升级的包。
-?、--help	获取有关此命令的更多帮助。
--wait	提示用户在退出前按任意键。
--logs,--open-logs	打开默认日志位置。
--verbose, --verbose-logs	用于替代日志记录设置并创建详细日志。
--disable-interactivity	禁用交互式提示。

查询示例

以下示例将列出特定版本的应用程序。

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

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

列出更新

如上所述，可使用 list 命令查看已安装的、具有可用更新的应用。

在下图中，你会发现终端的预览版本具有可用的更新。

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

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

• 使用 winget 工具列出和管理应用程序