PowerShell New-GPLink参数类型转换错误及脚本修复咨询

错误原因分析 #

第一次错误核心问题

1. $link是对象数组：Select -Property Order返回的是包含Order属性的对象集合，哪怕只有一个结果，也是数组类型，而New-GPLink的Order参数需要单个整数。
2. 目标GPO链接查询错误：你重复查询了所有OU的GPO信息，而非当前循环的$ou，导致拿到的是全量OU里的目标GPO链接，不是当前OU的对应值。

第二次错误核心问题

1. 变量作用域失效：第二个foreach循环在第一个遍历OU的循环外部，此时$ou已经超出作用域，无法获取到OU的DistinguishedName。
2. 参数类型错误：传递给Order的是带属性的对象（如@{Order=23}），不是直接的整数值，无法转换为System.Int32类型。

修正后的脚本 #

$gpoName = Read-Host -Prompt 'Enter the Group Policy Name you want to Link'
$targetGpoName = Read-Host -Prompt 'Enter the name of the target Group Policy you want to base the Link order off of'
$EnableLinkInput = Read-Host -Prompt 'Enter Yes or No to enable link or not'

# 转换链接启用状态为布尔值（New-GPLink需要布尔类型，而非字符串）
$linkEnabled = ($EnableLinkInput -eq 'Yes')

# 获取所有目标OU
$ous = Get-ADOrganizationalUnit -SearchBase 'OU=OU,DC=DC,DC=DC,DC=DC,DC=DC,DC=DC' -Filter 'Name -like "Computers"'

# 遍历每个OU完成GPO链接与顺序设置
foreach ($ou in $ous) {
    # 仅针对当前OU查询GPO继承信息，提取目标GPO的链接顺序
    $targetOrder = (Get-GPInheritance -Target $ou.DistinguishedName).GpoLinks | 
        Where-Object { $_.DisplayName -eq $targetGpoName } | 
        Select-Object -ExpandProperty Order

    # 检查是否找到目标GPO，避免空值报错
    if ($targetOrder) {
        # 链接GPO，使用目标GPO的Order值，原位置及后续GPO会自动下移
        New-GPLink -Name $gpoName -Target $ou.DistinguishedName -LinkEnabled $linkEnabled -Order $targetOrder
        Write-Host "已将GPO [$gpoName] 链接到OU [$($ou.Name)]，顺序设置为 $targetOrder"
    }
    else {
        Write-Warning "OU [$($ou.Name)] 中未找到目标GPO [$targetGpoName]，跳过此OU"
    }
}

关键修改说明 #

1. 精准查询当前OU的GPO信息：用Get-GPInheritance -Target $ou.DistinguishedName直接获取当前OU的GPO链接数据，确保拿到的是对应OU的目标GPO顺序。
2. 提取纯整数值：Select-Object -ExpandProperty Order直接取出Order属性的整数值，而非带属性的对象，解决类型转换问题。
3. 修复参数类型：将用户输入的"Yes/No"转换为布尔值，匹配New-GPLink的LinkEnabled参数要求。
4. 空值容错：增加目标GPO不存在的判断，输出警告并跳过对应OU，避免脚本中断。
5. 作用域修正：所有逻辑放在同一个遍历OU的循环内，确保$ou变量始终有效。

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