PowerShell调用Graph API时$search参数失效返回全部邮件问题

你的$search调用代码存在三处致命问题，直接导致搜索条件不生效、返回全量邮件：

• 接口路径缺失段：正确的指定用户邮件查询接口路径为/v1.0/users/{用户UPN}/messages，你的代码漏写了/users路径，请求被路由到异常端点后，Graph服务会自动忽略无效查询参数，直接返回默认数据集
• 缺少必填请求头：调用Microsoft Graph的$search参数时，必须在请求头中携带ConsistencyLevel: eventual，否则服务不会执行搜索逻辑，直接跳过筛选步骤
• PowerShell变量插值坑：你用双引号包裹API URL字符串，PowerShell会自动将字符串中$开头的$search识别为本地PowerShell变量做替换，如果你本地未定义$search变量，实际发出的请求里会丢失查询参数名，等于没传搜索条件

$upn = 'john.doe@a.com.au'
# 用字符串拼接方式定义URL，避免$search被PowerShell解析为本地变量，同时补全正确接口路径
$api = 'https://graph.microsoft.com/v1.0/users/' + $upn + '/messages?$search="subject:INC0432318"'
$requestHeaders = @{
    Authorization = "Bearer $($ConnectGraph.access_token)"
    # 新增$search必填的一致性级别头
    ConsistencyLevel = "eventual"
}
$messages = Invoke-RestMethod -Headers $requestHeaders -ContentType application/json -Uri $api -Method Get

补充说明：$search参数使用KQL查询语法，查询值直接用双引号包裹即可，不需要额外套单引号。该查询走Exchange全文索引，搜索性能比$filter+contains的逐行匹配高很多，匹配效果和你之前的contains逻辑一致，都是匹配主题中包含指定关键词的邮件。

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