PowerShell连接Exchange搜索邮件用通配符*报错如何解决？

报错有两个核心原因：

1. Exchange Search-Mailbox 的 -SearchQuery 参数遵循**关键词查询语言（KQL）**规范，通配符 * 不允许放在搜索词开头，仅支持放在末尾做后缀匹配，手动给搜索词前后都加*会直接触发语法错误。如果需要匹配包含指定内容的所有主题，无需手动加*，KQL默认就支持子字符串匹配逻辑。
2. 你使用[scriptblock]::create("Subject:'$text'")的方式拼接查询字符串时，用户输入的特殊字符会被错误解析，既不需要套scriptblock构造，也没有对用户输入的单引号做转义处理，进一步放大了语法报错概率。

不需要让用户手动输入*，直接引导用户输入要搜索的关键词即可，脚本自动对输入做转义和格式校验，构造合法的KQL查询语句。核心修改点为搜索前对用户输入做预处理，直接拼接查询字符串即可。

cls
# 检查旧文件存在就删除
$FileName = "C:\users\UserName\desktop\abc.csv"
If (Test-path $FileName) {
  Remove-Item $FileName -Force
}
$FileName = "C:\users\UserName\desktop\abc2.csv"
If (Test-path $FileName) {
  Remove-Item $FileName -Force
}

# 弹窗获取用户输入的主题关键词
Add-Type -AssemblyName Microsoft.VisualBasic
$title = 'Subject Line'
$msg   = '请输入要搜索的主题关键词（无需加通配符，默认匹配包含该内容的所有邮件）:'
$text = [Microsoft.VisualBasic.Interaction]::InputBox($msg, $title)
# 校验用户输入不为空
if([string]::IsNullOrWhiteSpace($text)){
    Write-Warning "未输入搜索关键词，脚本退出"
    exit
}

# 构造凭据
$pw = ConvertTo-SecureString -AsPlainText -Force -String "Password"
$cred = New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList "domain\UserName",$pw

# 连接Exchange服务器
Set-ExecutionPolicy RemoteSigned -Force
$ExSession =  New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri 'http://EmailServer/PowerShell/' -Authentication Kerberos -Credential $cred
Import-PSSession $ExSession -AllowClobber | Out-Null

# 处理搜索关键词 构造合法KQL查询
$processedText = $text.Replace("'", "''").TrimStart('*').Trim()

# 执行搜索删除（如果要先测试结果，先删掉-DeleteContent -Force参数，确认匹配正确再加回）
Get-Mailbox -ResultSize unlimited | 
Search-Mailbox -SearchQuery "Subject:'$processedText'" -DeleteContent -Force | 
Export-Csv c:\users\UserName\desktop\abc.csv -NoTypeInformation -Encoding UTF8

Start-Sleep -Seconds 2

# 整理导出结果
Import-Csv -Path "C:\Users\UserName\Desktop\abc.csv" |
Select-Object Identity, ResultItemsCount, ResultItemsSize |
Sort-Object ResultItemsCount -Descending |
Export-Csv -Path "C:\Users\UserName\Desktop\abc2.csv" -Force -NoTypeInformation -Encoding UTF8

Start-Sleep -Seconds 2
Invoke-Item "C:\Users\UserName\Desktop\abc2.csv"

Remove-PSSession $ExSession

• 执行删除操作前建议先去掉-DeleteContent -Force参数，先跑一遍搜索确认匹配结果符合预期，再加上删除参数执行，避免误删邮件。
• 脚本中硬编码明文密码存在安全风险，生产环境建议替换为加密存储凭据的方案。
• Search-Mailbox为已废弃的 cmdlet，Exchange 2016及以上版本、Exchange Online环境建议使用New-ComplianceSearch相关命令组，功能兼容性和稳定性更高。

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