如何在PowerShell中提取报错CorrelationId并导出到Excel

问题背景 #

执行Azure资源移动验证的PowerShell脚本时，Invoke-AzResourceAction命令抛出资源类型不支持移动的报错，尝试在catch块中通过$_.CorrelationID直接取值失败。由于CorrelationId值不固定、在报错中单独占一行，无法通过静态子字符串截取的方式提取。

根因说明 #

Azure PowerShell抛出的ErrorResponseMessageException类型异常，不会将CorrelationId作为异常对象的顶层属性暴露，CorrelationId是拼接在异常文本消息中的内容，因此直接访问对象属性无法取值。

实现代码 #

利用CorrelationId行的固定前缀特征，通过正则多行匹配提取值即可，不需要依赖固定值长度，修正后的完整代码框架如下：

try
{
    Invoke-AzResourceAction -Action validateMoveResources -ResourceId $ResourceGroupID -Parameters @{ 
        resources = @($ResourceID)
        targetResourceGroup = $resource.TargetResourceGroup 
    }
    Write-Host "$ResourceID Has been moved successfully"
}
catch
{
    # 正则匹配单独成行的CorrelationId
    $matchResult = [regex]::Match($_.Exception.Message, '(?m)^CorrelationId:\s*(\S+)\s*$')
    if ($matchResult.Success) {
        $extractedCorrelationId = $matchResult.Groups[1].Value
        # 此处可直接调用$extractedCorrelationId写入Excel
        Write-Host "操作失败，CorrelationId: $extractedCorrelationId"
    }
    else {
        Write-Host "未匹配到CorrelationId，完整异常消息：$($_.Exception.Message)"
    }
}

正则逻辑说明 #

• (?m)：开启多行匹配模式，让^、$符号可以匹配每一行的首尾，而非仅匹配整个字符串的首尾
• ^CorrelationId:：精准匹配以固定文本CorrelationId:开头的行
• \s*：兼容前缀后可能存在的空格、制表符等空白字符
• (\S+)：捕获连续非空白字符，也就是CorrelationId的实际值，存入第一个捕获分组
• \s*$：匹配值末尾到行尾的空白字符，避免提取结果带多余空格、换行符

注意事项 #

• 匹配范围优先选择$_.Exception.Message，不要直接对整个$_错误对象转字符串匹配，避免把脚本行号、错误类别等无关内容纳入匹配范围，降低误匹配概率
• 提取得到的$extractedCorrelationId为标准字符串类型，可直接传入Excel操作命令（如ImportExcel模块、COM对象操作等）写入单元格。

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