使用PowerShell重命名AD用户cn属性结果异常排查

问题背景 #

目标为移除AD用户Name（cn）属性的clean1_前缀，测试用户原始Name属性值为clean1_Reena_K (W00-198)，执行代码后命名结果不符合预期。
原始编写代码：

$path = "OU=Accounts,OU=IT,OU=$dcs1,DC=z,DC=if,DC=ag,DC=net" 

$ExportPath=@()
$Result=@()

$ExportPath = Get-ADUser -Filter "Name -like 'clean1_*'" -SearchBase $path | select -First 1

foreach($Usr in $ExportPath)
{
    Rename-ADObject -Identity $Usr -NewName {$Usr.Name -replace '^clean1_'} 
}

故障根因 #

核心问题出在参数传递和代码逻辑层面：

• 直接错误原因：-NewName参数要求传入字符串类型的新名称，你传入的{$Usr.Name -replace '^clean1_'}是PowerShell脚本块对象，参数绑定时不会自动执行脚本块计算结果，而是直接将脚本块的字符串表示形式作为新名称写入AD，直接导致命名结果和预期不符。
• 冗余逻辑问题：开头定义的$ExportPath=@()、$Result=@()为无效代码，后续$ExportPath被Get-ADUser返回值直接覆盖，$Result全程未调用，不会影响执行结果但属于多余写法。
• 范围限制问题：Get-ADUser后追加的| select -First 1会限制仅修改查询到的第一个匹配用户，若要批量修改所有带clean1_前缀的用户，需要移除这段筛选。

修正后可执行代码 #

$path = "OU=Accounts,OU=IT,OU=$dcs1,DC=z,DC=if,DC=ag,DC=net"
$matchedUsers = Get-ADUser -Filter "Name -like 'clean1_*'" -SearchBase $path

foreach($usr in $matchedUsers){
    # 预先计算新名称，传入字符串类型值
    $targetName = $usr.Name -replace '^clean1_'
    # 建议正式执行前先加-WhatIf参数验证结果，确认无误再移除
    Rename-ADObject -Identity $usr.DistinguishedName -NewName $targetName -WhatIf
}

执行提示：测试阶段保留-WhatIf参数，PowerShell会输出模拟执行的修改结果但不会实际写入AD，确认所有新名称符合预期后，删除-WhatIf参数即可正式执行修改。

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