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 标头。 |
--authentication-mode | 指定身份验证窗口首选项(无提示、无提示首选或交互)。 |
--authentication-account | 指定用于身份验证的帐户。 |
--accept-source-agreements | 用于接受源许可协议,并避免出现提示。 |
--upgrade-available | 仅列出具有可用升级的包。 |
-?、--help | 获取有关此命令的更多帮助。 |
--wait | 提示用户在退出前按任意键。 |
--logs,--open-logs | 打开默认日志位置。 |
--verbose, --verbose-logs | 用于替代日志记录设置并创建详细日志。 |
--nowarn,--ignore-warnings | 禁止警告输出。 |
--disable-interactivity | 禁用交互式提示。 |
--proxy | 设置要用于此执行的代理。 |
--no-proxy | 禁用此执行使用代理。 |
查询示例
以下示例将列出特定版本的应用程序。
以下示例按 ID 列出来自特定源的所有应用程序。
以下示例将 list 的输出限制为 9 个应用。
列出更新
如上所述,可使用 list 命令查看已安装的、具有可用更新的应用。
在下图中,你会发现终端的预览版本具有可用的更新。
list 命令不仅会显示可用的更新版本,而且会显示该可用更新的来源。
如果没有可用更新,list 将只显示当前已安装的版本,而不会显示更新列。