使用PowerShell批量检查并添加缺失的注册表键值

需求说明 #

我有多个注册表项，每个项包含多个键值，需要检查这些键值是否存在，若不存在则添加。已掌握单个键值的处理脚本，但不清楚如何进行批量操作，希望通过PowerShell实现该需求。

需要添加的注册表键值示例 #

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\ActiveDesktop]
"NoComponents"=dword:00000001
"NoAddingComponents"=dword:00000001
"NoHTMLWallPaper"=dword:00000001

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\Explorer]
"ForceActiveDesktopOn"=dword:00000000
"NoActiveDesktopChanges"=dword:00000001
"NoActiveDesktop"=dword:00000001
"ShowSuperHidden"=dword:00000001

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\NonEnum]
"{BDEADF00-C265-11D0-BCED-00A0C90AB50F}"=dword:00000001
"{6DFD7C5C-2451-11d3-A299-00C04F8EF6AF}"=dword:40000021
"{0DF44EAA-FF21-4412-828E-260A8728E7F1}"=dword:00000020

原有单条键值处理脚本 #

$KeyPath = "HKCU:\Registry\Key\Path"  
$ValueName = "name"  
$ValueData = "data"  
try{  
    Get-ItemProperty -Path $KeyPath -Name $valueName -ErrorAction Stop  
}  
catch [System.Management.Automation.ItemNotFoundException] {  
    New-Item -Path $KeyPath -Force  
    New-ItemProperty -Path $KeyPath -Name $ValueName -Value $ValueData -Force  
}  
catch {  
    New-ItemProperty -Path $KeyPath -Name $ValueName -Value $ValueData -Type String -Force  
}  

批量处理解决方案 #

以下脚本通过结构化定义所有需要处理的注册表项和键值，实现批量检查并添加的功能：

# 定义需要处理的注册表项及对应键值（可根据实际需求扩展）
$registrySettings = @(
    @{
        KeyPath = "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\ActiveDesktop"
        Properties = @(
            @{ Name = "NoComponents"; Value = 1; Type = "DWord" },
            @{ Name = "NoAddingComponents"; Value = 1; Type = "DWord" },
            @{ Name = "NoHTMLWallPaper"; Value = 1; Type = "DWord" }
        )
    },
    @{
        KeyPath = "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\Explorer"
        Properties = @(
            @{ Name = "ForceActiveDesktopOn"; Value = 0; Type = "DWord" },
            @{ Name = "NoActiveDesktopChanges"; Value = 1; Type = "DWord" },
            @{ Name = "NoActiveDesktop"; Value = 1; Type = "DWord" },
            @{ Name = "ShowSuperHidden"; Value = 1; Type = "DWord" }
        )
    },
    @{
        KeyPath = "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\NonEnum"
        Properties = @(
            @{ Name = "{BDEADF00-C265-11D0-BCED-00A0C90AB50F}"; Value = 1; Type = "DWord" },
            @{ Name = "{6DFD7C5C-2451-11d3-A299-00C04F8EF6AF}"; Value = 0x40000021; Type = "DWord" },
            @{ Name = "{0DF44EAA-FF21-4412-828E-260A8728E7F1}"; Value = 0x20; Type = "DWord" }
        )
    }
)

# 批量处理逻辑
foreach ($setting in $registrySettings) {
    $keyPath = $setting.KeyPath
    $properties = $setting.Properties

    # 确保注册表路径存在，不存在则创建
    if (-not (Test-Path -Path $keyPath)) {
        New-Item -Path $keyPath -Force | Out-Null
        Write-Host "已创建注册表项: $keyPath"
    }

    # 遍历处理每个键值
    foreach ($prop in $properties) {
        $valueName = $prop.Name
        $valueData = $prop.Value
        $valueType = $prop.Type

        try {
            # 检查键值是否存在
            Get-ItemProperty -Path $keyPath -Name $valueName -ErrorAction Stop | Out-Null
            Write-Host "键值 '$valueName' 已存在于 $keyPath，无需操作"
        }
        catch [System.Management.Automation.ItemNotFoundException] {
            # 键值不存在，执行添加操作
            New-ItemProperty -Path $keyPath -Name $valueName -Value $valueData -Type $valueType -Force | Out-Null
            Write-Host "已添加键值 '$valueName' 到 $keyPath"
        }
        catch {
            # 兜底处理其他异常，强制更新键值
            New-ItemProperty -Path $keyPath -Name $valueName -Value $valueData -Type $valueType -Force | Out-Null
            Write-Host "已更新键值 '$valueName' 在 $keyPath"
        }
    }
}

注意事项 #

1. 权限要求：操作HKLM（本地机器）注册表项需要以管理员身份运行PowerShell，否则会出现权限不足的错误。
2. 扩展性：如果需要添加更多注册表项或键值，只需在$registrySettings数组中按现有格式补充即可。
3. 日志输出：脚本通过Write-Host输出每个操作的结果，方便验证执行情况。

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