编写PowerShell脚本删除含逗号的打印机注册表键及远程执行疑问

问题描述 #

需清理旧GPO部署的打印机残留注册表：相关GPO及打印机服务器已不存在，但客户端通过控制面板删除打印机后重启会再次出现。测试确认需删除以下路径的对应子键：

• HKEY_CURRENT_USER\Printers\Connections
• HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Print\Providers\Client Side Rendering PrintProvider\{GUID}\Printers\Connections（含随机GUID，无法用reg文件直接删除）

编写PowerShell脚本时遇到两个问题：

1. 目标子键名称含逗号（如打印机\\server\printer对应键名,,server,printer），参数传递时逗号被识别为分隔符，单引号包裹无效
2. 疑问：远程以System权限运行脚本时能否访问HKCU hive？

第一版脚本：

function Remove-RegistryKey {
    param(
        [string]$KeyName = "',,server-01,printer-01',',,server-01,printer-01'"
        [string]$RegistryRoot = "HKLM:, HKCU:"
    )

    $registryPaths = $RegistryRoot.Split(",")

    foreach ($root in $registryPaths) {
        Get-ChildItem -Path $root -Recurse -ErrorAction SilentlyContinue |
        Where-Object { $_.Name -like "*$KeyName*" } |
        ForEach-Object {
            try {
                Remove-Item -Path $_.FullName -Recurse -Force
                Write-Host "Successfully deleted registry key: $($_.FullName)"
            } catch {
                Write-Warning "Error deleting registry key $($_.FullName): $($_.Exception.Message)"
            }
        }
    }
}

# Example usage:
$keyNameToDelete = "ExampleKey"
Remove-RegistryKey -KeyName $keyNameToDelete

思路判断与优化方案 #

1. 核心思路正确性 #

通过PowerShell遍历注册表匹配目标子键并删除的思路是正确的，解决了HKLM路径中GUID无法固定的问题，但原脚本在参数处理、路径遍历逻辑上存在缺陷，需要调整。

2. 逗号参数问题解决 #

原脚本参数定义错误导致逗号被拆分，正确处理方式：

• 将KeyName参数改为数组类型，支持直接传入带逗号的完整键名字符串（无需额外转义，单引号或双引号包裹即可）
• 避免在默认参数中写入多键值，改用示例调用传入目标键名

3. HKCU访问权限说明 #

远程以System权限运行脚本时，无法直接访问当前登录用户的HKCU hive：

• System账户有独立的HKCU（对应C:\Windows\System32\config\systemprofile\NTUSER.DAT），而非登录用户的HKCU
• 若需清理登录用户的HKCU，需在用户上下文运行脚本（如用PsExec的-i参数指定用户会话），或挂载目标用户的NTUSER.DAT到临时注册表路径清理后卸载

优化后的脚本 #

function Remove-StalePrinterRegistryKeys {
    [CmdletBinding(SupportsShouldProcess)]
    param(
        [Parameter(Mandatory=$true)]
        [string[]]$TargetKeyNames, # 支持传入多个带逗号的键名，例如",,server-01,printer-01"
        
        [Parameter(Mandatory=$false)]
        [string[]]$RegistryRoots = @(
            "HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Print\Providers\Client Side Rendering PrintProvider",
            "HKCU:\Printers\Connections"
        )
    )

    foreach ($root in $RegistryRoots) {
        # 先验证根路径存在，避免无效遍历
        if (-not (Test-Path -Path $root)) {
            Write-Verbose "Root path not found: $root"
            continue
        }

        # 遍历所有子键，自动处理HKLM路径中的GUID层级
        $childKeys = Get-ChildItem -Path $root -Recurse -ErrorAction SilentlyContinue | Where-Object { $_.PSIsContainer }
        
        foreach ($key in $childKeys) {
            foreach ($targetName in $TargetKeyNames) {
                # 精确匹配键名（PSChildName是键的最后一段名称，避免模糊匹配误删）
                if ($key.PSChildName -eq $targetName) {
                    if ($PSCmdlet.ShouldProcess($key.FullName, "Delete registry key")) {
                        try {
                            Remove-Item -Path $key.FullName -Recurse -Force -ErrorAction Stop
                            Write-Host "Deleted: $($key.FullName)"
                        }
                        catch {
                            Write-Warning "Failed to delete $($key.FullName): $($_.Exception.Message)"
                        }
                    }
                }
            }
        }
    }
}

# 示例用法：传入需要清理的打印机键名
$printerKeys = @(",,server-01,printer-01", ",,server-02,printer-02")
Remove-StalePrinterRegistryKeys -TargetKeyNames $printerKeys -Verbose

优化点说明 #

• 加入[CmdletBinding(SupportsShouldProcess)]，支持-WhatIf参数安全预演删除操作
• 参数改为数组类型，支持批量清理多个打印机残留键
• 提前验证根路径存在性，减少无效操作
• 精确匹配键的最后一段名称（PSChildName），避免模糊匹配导致的误删
• 拆分HKLM和HKCU的根路径，自动适配HKLM路径中的GUID层级
• 增强错误处理与日志输出，便于排查问题

内容的提问来源于stack exchange，提问作者Dave G.