如何为PowerShell XML处理脚本添加错误处理与日志记录功能？

• 无前置文件校验：读取XML前未判断目标文件是否存在，文件缺失时Get-Content直接抛出终止错误，后续日志代码完全不会执行
• 日志逻辑错误：现有Write-Log调用没有和异常场景绑定，无论执行是否成功都会输出错误提示，完全不符合错误日志的触发逻辑
• 缺少异常捕获机制：没有用try/catch块包裹可能出错的IO、解析操作，异常发生时脚本直接终止，不会触发日志写入
• 无写入操作校验：生成Markdown文件的写入操作没有错误处理逻辑，遇到权限不足、保存路径不存在等问题时也无法捕获报错

下面是完整的修复后代码，已经内置了基础的Write-Log实现，同时覆盖了所有可能的异常场景：

# 日志写入函数（环境已有可删除该部分）
function Write-Log {
    param(
        [Parameter(Mandatory=$true)]
        [string]$Message,
        [ValidateSet('Info','Error','Warning')]
        [string]$Level = 'Info',
        [Parameter(Mandatory=$true)]
        [string]$Path
    )
    $logEntry = "[$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss')] [$Level] $Message"
    Add-Content -Path $Path -Value $logEntry -Encoding UTF8
}

function main {
    param(
        [Parameter(Mandatory=$true)]
        [string]$XMLfile,
        [Parameter(Mandatory=$true)]
        [string]$saveMdFile,
        [Parameter(Mandatory=$true)]
        [string]$logpath
    )
    try {
        # 校验XML文件存在性
        if (-not (Test-Path -Path $XMLfile -PathType Leaf)) {
            throw "指定的XML文件不存在，路径：$XMLfile"
        }

        # 读取XML文件
        [XML]$xml = Get-Content -Path $XMLfile -Raw -ErrorAction Stop
        Write-Log -Message "XML文件读取成功：$XMLfile" -Level Info -Path $logpath

        # 解析组件信息
        $finalObject = $xml.bom.components.component | ForEach-Object {
            $lic = $_.licenses.license.id
            $url = $_.licenses.license.url
            $web = ($_.externalReferences.reference | Where-Object { $_.type -eq 'website' }).url
            [PSCustomObject]@{
                'Name'    = if ($web) { '[{0}]({1})' -f $_.Name, $web } elseif ($url) { '[{0}]({1})' -f $_.Name, $url } else { $_.Name }
                'Version' = $_.version
                'License' = if ([string]::IsNullOrWhiteSpace($lic)) { 'Unknown' } else { $lic }
            }
        }

        # 输出Markdown文件
        $finalObject | ConvertTo-MarkDownTable | Out-File -FilePath $saveMdFile -Encoding UTF8 -ErrorAction Stop
        Write-Log -Message "Markdown清单生成成功，保存路径：$saveMdFile" -Level Info -Path $logpath
    }
    catch {
        # 捕获所有异常写入错误日志
        $errorMsg = "执行失败：$($_.Exception.Message)"
        Write-Log -Message $errorMsg -Level Error -Path $logpath
        # 如需脚本遇到错误直接退出可打开下行注释
        # exit 1
    }
}

• 所有IO操作都添加了-ErrorAction Stop参数，确保非终止错误也能被捕获
• 异常场景统一进入catch块写入错误日志，正常执行时只写入运行状态日志
• 增加了函数参数的必填校验，避免变量作用域问题导致的路径读取异常
• 优化了Name字段的判断逻辑，删除了冗余的判断分支

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