Exchange cmdlet 上 RecipientFilter 参数的可筛选属性

使用 RecipientFilter 参数基于 Exchange Server 2016 或更高版本中收件人对象的属性创建 OPATH 筛选器，Exchange Online。 RecipientFilter 参数在以下 cmdlet 中可用：

• New-AddressList 和 Set-AddressList
• New-DynamicDistributionGroup 和 Set-DynamicDistributionGroup
• New-EmailAddressPolicy 和 Set-EmailAddressPolicy
• New-GlobalAddressList 和 Set-GlobalAddressList

可筛选的收件人属性

下表介绍了已确认在所有 cmdlet 中使用 RecipientFilter 参数的收件人属性。

注意：

• 该列表可能包括：

  • 仅在一种类型的环境中使用的属性：Microsoft 365、本地 Exchange 或混合。 属性可能存在于所有环境中的收件人对象上，但值仅在 (一种环境中的空值或 None) 值时才有意义。
  • 存在但对应于 Exchange 中不再使用的功能的属性。

• 不能将其他 Active Directory 架构扩展中的属性与 RecipientFilter 参数一起使用。

• 并非所有收件人属性都具有相应的 Active Directory 属性。 表中的 LDAP 显示名称值对于这些属性为“n/a”，这表示属性由 Exchange) 计算 (可能。

• 将整个 OPATH 筛选器括在双引号“”中。 如果筛选器包含系统值 (，例如 $true、 $false或 $null) ，请改用单引号 ' 。 虽然此参数是 (不是系统块) 的字符串，但也可以使用大括号 { }，但前提是筛选器不包含变量。 有关详细信息，请参阅 其他 OPATH 语法信息。

• 对于需要有效对象值 (（例如邮箱、通讯组或电子邮件地址策略）的属性，通常使用对象的名称，但该属性也可能接受对象的可分辨名称 (DN) 或全局唯一标识符 (GUID) 。 若要查找对象的 DN 或 GUID，请使用与对象的类型相对应的 Get- cmdlet (例如 Get-EmailAddressPolicy | Format-List Name,DistinguishedName,GUID ，) 。

• 接受通配符的文本字符串属性需要 -like 运算符 (， "Property -like 'abc*'" 例如，) 。 在 Exchange Online PowerShell 中，不能在大多数参数中使用通配符作为前缀 (例如， "Property -like '*abc'" 不允许) ) 。

  提示

  即使通配符前缀在 Exchange Online PowerShell 中的筛选器参数中有效，也不建议由于性能低的问题而使用它。

• 表中的“值”列描述了 筛选器的可接受值，而不一定用于属性本身。 例如，属性可能明显包含日期或数值，但在筛选器中使用该属性时，它可能被视为文本字符串， (没有值检查，并且通配符) 支持。

• 若要查找空白或非空白属性值，请使用值 $null (，或者 'Property -eq $null''Property -ne $null') 。

• 有关 Exchange Online PowerShell 模块中 9 个独占 Get-EXO* cmdlet 的筛选注意事项，请参阅 PowerShell 模块中的筛选器Exchange Online。

• 在 Exchange Online 中，不能使用通配符 (*) 作为搜索字符串中的第一个字符。

详细信息

Exchange Server 2007 是第一个需要 OPATH 筛选器而不是 LDAP 筛选器的 Exchange 版本。 有关将 LDAP 筛选器转换为 OPATH 筛选器的详细信息，请参阅 Microsoft Exchange Team 博客文章 将 LDAP 筛选器转换为 OPATH 时需要帮助？。