如何搭配存储在变量中的对象使用Get-AzureADUser的Filter参数

1. Filter参数的正确语法 #

你原先的变量插值写法本身没有语法错误，无返回值的核心诱因通常是Import-Csv读取的EmailAddress字段值携带多余空白字符，或者邮箱值包含特殊字符未转义。
正确的编写步骤：

• 先对读取的邮箱值做清洗，去除首尾空白、转义特殊字符
• 再代入Filter参数
  示例代码片段：

$users = Import-Csv .\users.csv 
foreach($user in $users){
    # 清洗邮箱值：去除首尾空白 + 转义单引号（避免Filter语法报错）
    $cleanEmail = $user.EmailAddress.Trim().Replace("'", "''")
    Get-AzureADUser -Filter "PrimarySMTPAddress eq '$cleanEmail'" | Select-Object UserPrincipalName, ObjectID
}

如果清洗后还是无返回，可临时加调试行验证实际生成的Filter语句是否正确：Write-Host "生成的Filter语句：PrimarySMTPAddress eq '$cleanEmail'"，和手动写死的可运行语句做对比即可定位问题。

2. 结果回写数组并导出的实现 #

你可以直接为遍历到的$user对象的UserPrincipalName、ObjectID属性赋值，循环执行完成后直接导出整个数组即可，完整代码如下：

# 导入CSV
$users = Import-Csv .\users.csv 

foreach($user in $users){
    # 清洗邮箱值
    $cleanEmail = $user.EmailAddress.Trim().Replace("'", "''")
    # 查询AAD用户，加-First 1避免多匹配结果导致赋值报错
    $aadUser = Get-AzureADUser -Filter "PrimarySMTPAddress eq '$cleanEmail'" | Select-Object UserPrincipalName, ObjectID -First 1
    
    # 回写查询结果到数组元素，未查询到则留空
    if($aadUser){
        $user.UserPrincipalName = $aadUser.UserPrincipalName
        $user.ObjectID = $aadUser.ObjectID
    }
    else{
        $user.UserPrincipalName = ""
        $user.ObjectID = ""
    }
}

# 导出补全后的结果到新CSV
$users | Export-Csv -Path .\users_completed.csv -NoTypeInformation -Encoding UTF8

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