You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何查找Azure CLI --filter参数支持的筛选选项与函数列表?

关于Azure CLI --filter 参数的权威查询渠道与语法说明

你在az ad user list这类命令中使用的--filter参数,本质是Azure CLI直接透传给底层Microsoft Graph API的OData查询参数,所有支持的筛选函数、语法规则都遵循对应公开标准,你可以通过以下几个官方权威渠道获取完整说明:

  • OData v4.0 核心协议官方文档的筛选表达式章节:这里定义了所有标准OData筛选支持的运算符、函数的通用语法,你提到的startsWith()就属于OData标准筛选函数,同类型通用函数还包括endsWith()、contains()、length()、toLower()等,以及常用的比较、逻辑运算规则。
  • Microsoft Graph 对应实体接口的官方参考文档:不同的Graph接口、不同的实体属性对OData筛选函数的支持范围有差异,比如az ad user list对应Graph的列出用户接口,文档中会明确标注该接口下哪些属性支持筛选、支持哪些筛选函数、是否需要附加一致性级别参数才能生效。
  • Azure CLI 内置帮助文档:执行az <对应命令> --help即可查看参数的基础说明,所有支持--filter的命令都会在帮助文本中明确标注该参数接收OData格式的筛选表达式。

给你几个在az ad user list场景下实测可用的筛选示例,方便你快速对照语法:

# 匹配姓氏以siewert开头的用户
az ad user list -o table --filter "startsWith(surname, 'siewert')"

# 匹配已启用的企业域用户
az ad user list -o table --filter "accountEnabled eq true and endsWith(mail, '@yourdomain.com')"

# 匹配显示名包含test关键词的用户(该类查询需要附加一致性参数)
az ad user list -o table --filter "contains(displayName, 'test')" --consistency-level eventual --count

提示:使用部分非等值类筛选函数时,如果遇到报错提示请求不支持,按照报错提示补充--consistency-level eventual和--count参数即可正常执行。

内容的提问来源于stack exchange,提问作者eswues

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.28 19:51:17