PowerShell函数返回值处理：注册表合规检测统计需求

云原生阿岚

2026-5-22

我懂你现在的困扰啦——要批量检查注册表的加固项，把不符合要求的（也就是返回Bad的）收集起来，统计数量还得生成带表格的报告，但不知道怎么处理函数返回值来实现对吧？我给你梳理个清晰的方案，直接上手就能用！

核心思路

首先得让每个注册表检查函数返回结构化的结果（而不是单纯的"Good"/"Bad"字符串），这样我们能把注册表项名称、当前值、判定结果绑定在一起。然后批量调用这些函数，收集所有结果后筛选出Bad项，最后统计数量并生成表格报告。

具体实现代码

第一步：定义检查函数（返回结构化对象）

每个检查函数负责读取对应注册表项，根据加固要求判定结果，然后返回包含关键信息的自定义对象：

# 检查PreventStorage注册表项的函数
function Test-PreventStorage {
    $regPath = "HKLM:\SOFTWARE\Policies\Microsoft\Windows\Storage"
    # 读取注册表值，不存在时不报错
    $regValue = Get-ItemProperty -Path $regPath -Name "PreventStorage" -ErrorAction SilentlyContinue

    # 根据你的加固要求判断（这里假设要求值为1）
    if ($regValue.PreventStorage -eq 1) {
        $result = "Good"
    } else {
        $result = "Bad"
    }

    # 返回包含所有必要信息的自定义对象
    return [PSCustomObject]@{
        RegistryItem = "PreventStorage"
        CurrentValue = $regValue.PreventStorage ?? "未设置"
        Result       = $result
    }
}

# 检查RemoteAssistance注册表项的函数
function Test-RemoteAssistance {
    $regPath = "HKLM:\SOFTWARE\Policies\Microsoft\Windows\Remote Assistance"
    $regValue = Get-ItemProperty -Path $regPath -Name "fAllowToGetHelp" -ErrorAction SilentlyContinue

    # 假设加固要求是值为0
    if ($regValue.fAllowToGetHelp -eq 0) {
        $result = "Good"
    } else {
        $result = "Bad"
    }

    return [PSCustomObject]@{
        RegistryItem = "RemoteAssistance"
        CurrentValue = $regValue.fAllowToGetHelp ?? "未设置"
        Result       = $result
    }
}

第二步：批量执行检查并收集结果

遍历你预设的检查项数组，动态调用对应的函数，把所有结果收集到一个集合里：

# 预设要检查的注册表项名称（和上面的函数名前缀对应）
$checkItems = @("PreventStorage", "RemoteAssistance")

# 初始化空集合存储所有检查结果
$allCheckResults = @()

# 遍历每个检查项，调用对应的测试函数
foreach ($item in $checkItems) {
    $functionName = "Test-$item"
    # 动态调用函数并将结果加入集合
    $allCheckResults += & $functionName
}

第三步：生成统计和表格报告

筛选出Bad项，统计数量，然后输出格式化的报告：

# 筛选所有不符合要求的项
$badItems = $allCheckResults | Where-Object { $_.Result -eq "Bad" }
$badCount = $badItems.Count

# 输出报告头部
Write-Host "=== 注册表加固合规性检查报告 ===" -ForegroundColor Cyan
Write-Host "总检查项数: $($allCheckResults.Count)"
Write-Host "不符合加固要求的项数: $badCount`n"

# 输出问题项表格
if ($badCount -gt 0) {
    Write-Host "=== 存在问题的注册表项详情 ===" -ForegroundColor Yellow
    # PowerShell自动将对象格式化为表格，-AutoSize适配宽度
    $badItems | Format-Table -AutoSize RegistryItem, CurrentValue, Result
} else {
    Write-Host "✅ 所有注册表项均符合加固要求！" -ForegroundColor Green
}

关键细节说明

结构化返回值：用[PSCustomObject]返回包含多个字段的对象，让我们能同时保留注册表项名称、当前值和判定结果，后续筛选、统计、展示都更方便。
动态函数调用：用& $functionName的方式根据数组项动态调用对应函数，避免写一堆重复的if-else判断。
异常处理：读取注册表时加上-ErrorAction SilentlyContinue，防止因为注册表项不存在导致脚本中断；用?? "未设置"处理值为空的情况，让报告更清晰。
自动表格格式化：PowerShell的Format-Table可以直接把对象转换成美观的表格，不用手动拼接字符串。

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