如何查找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
相关产品推荐
相关产品推荐

