Exchange中PowerShell脚本搜索MailContact的变量筛选失效问题

这个问题其实是因为Exchange cmdlet的-Filter参数和你以为的PowerShell脚本块筛选逻辑不一样——它本质上是基于Exchange查询语言（EQL）的字符串表达式，而不是真正的PowerShell脚本块。当你直接在脚本块里用$s变量时，PowerShell并不会帮你把变量值替换进去，而是把$s作为字面量传给Exchange服务器，服务器自然找不到匹配的联系人。

下面给你几个高效的解决方案，都是利用服务器端筛选（和直接执行Get-MailContact -Filter {name -like "*test*"}一样高效）：

方案1：直接拼接字符串筛选器 #

最直接的方式是先把变量展开成字符串，再传给-Filter参数：

# 假设你的搜索词参数是$SearchTerm
$filter = "Name -like '*$SearchTerm*'"
Get-MailContact -Filter $filter

这里用双引号包裹整个筛选字符串，PowerShell会先把$SearchTerm替换成实际的值，然后把完整的查询字符串传给Exchange服务器，服务器就能正确执行筛选了。

如果你的脚本是模块里的函数，写法大概是这样：

function Get-TargetMailContact {
    [CmdletBinding()]
    param(
        [Parameter(Mandatory = $true)]
        [string]$SearchTerm
    )

    # 构建筛选字符串
    $filter = "Name -like '*$SearchTerm*'"
    # 执行服务器端筛选
    Get-MailContact -Filter $filter
}

方案2：处理含特殊字符的搜索词 #

如果你的搜索词里可能包含单引号（比如O'Neil），直接拼接会导致筛选语法错误，这时候需要把单引号转义成两个单引号（EQL里的转义规则）：

function Get-TargetMailContact {
    [CmdletBinding()]
    param(
        [Parameter(Mandatory = $true)]
        [string]$SearchTerm
    )

    # 转义搜索词里的单引号
    $escapedSearchTerm = $SearchTerm -replace "'", "''"
    $filter = "Name -like '*$escapedSearchTerm*'"
    Get-MailContact -Filter $filter
}

为什么原来的脚本块写法不行？ #

当你写Get-MailContact -Filter {name -like "*$s*"}时，Exchange的cmdlet会把这个脚本块转换成字符串，但这个转换过程不会触发PowerShell的变量展开——服务器收到的查询是Name -like '*$s*'，它在找名称里包含$s的联系人，而不是你变量$s的值，所以自然没有结果。

而你用Get-MailContact -ResultSize unlimited | ? {$_.name -like "*$s*"}的方式，是先把所有联系人拉到本地，再用PowerShell的Where-Object筛选，所以速度慢，尤其是联系人数量多的时候，服务器端筛选（-Filter）能减少网络传输，效率高很多。

内容的提问来源于stack exchange，提问作者Smorkster