PowerShell AD中Get-ADUser过滤器无法使用数组元素属性值查询

算力阿峰

2026-9-3

问题原因

PowerShell双引号字符串的变量解析存在边界规则：只会将$后连续的合法变量名字符识别为变量进行替换，遇到数组索引符[、属性访问符.这类特殊字符时会停止解析。
你写的"UserPrincipalName -eq '$accounts[0].upn'"中，PowerShell只会识别$accounts为变量，将其直接转换为字符串（数组类型默认转字符串结果为类型名System.Object[]），后面的[0].upn会被当做普通文本拼接，最终传入Filter的实际值类似UserPrincipalName -eq 'System.Object[][0].upn'，自然查不到匹配结果。
而$test是单个标量字符串变量，双引号内可以被完整解析替换，因此第一条命令可以正常返回结果。
你可以直接执行以下命令验证实际解析结果：

# 输出双引号字符串的实际拼接内容
"UserPrincipalName -eq '$accounts[0].upn'"

可用修复方案

任选以下一种写法即可正常查询：

子表达式包裹法：用$()强制计算完整的取值表达式，再将结果插入字符串，是双引号内取对象属性/数组索引的标准写法
```
Get-ADUser -Filter "UserPrincipalName -eq '$($accounts[0].upn)'"
```
脚本块Filter写法：AD模块官方推荐的Filter格式，不需要处理字符串插值，变量会被直接读取取值，规避字符串解析问题
```
Get-ADUser -Filter {UserPrincipalName -eq $accounts[0].upn}
```
临时变量赋值法：就是你当前调试用的写法，提前把目标UPN值存到单独的标量变量中，逻辑清晰便于调试，不会出现解析异常
```
$targetUpn = $accounts[0].upn
Get-ADUser -Filter "UserPrincipalName -eq '$targetUpn'"
```