PowerShell 7.4.4与MicrosoftTeams模块错误中Correlation ID的屏蔽方法问询

方法1：捕获错误并过滤消息 #

通过捕获错误变量，手动清理包含Correlation ID的内容：

# 执行命令并捕获错误
$result = Get-CsTenant -ErrorAction SilentlyContinue -ErrorVariable csTenantErrors

# 过滤并输出清理后的错误信息
if ($csTenantErrors) {
    $filteredErrors = $csTenantErrors | ForEach-Object {
        $_.Exception.Message -replace 'Correlation ID: .+', '' | Trim()
    }
    Write-Error $filteredErrors -ErrorAction Continue
}

方法2：重定向错误流后文本过滤 #

直接将错误流导向变量，再通过正则替换清理：

# 重定向错误流到变量
$errorOutput = Get-CsTenant 2>&1

# 处理错误对象，移除Correlation ID
if ($errorOutput -is [System.Management.Automation.ErrorRecord]) {
    $cleanError = $errorOutput.Exception.Message -replace 'Correlation ID: [0-9a-f-]+', ''
    Write-Warning $cleanError.Trim()
}

方法3：封装通用错误处理函数 #

如果脚本频繁调用Teams命令，可封装复用的过滤逻辑：

function Invoke-TeamsCommand {
    param(
        [ScriptBlock]$Command
    )
    $output = & $Command 2>&1
    foreach ($item in $output) {
        if ($item -is [System.Management.Automation.ErrorRecord]) {
            $cleanMsg = $item.Exception.Message -replace 'Correlation ID: .+', '' | Trim()
            Write-Error $cleanMsg -ErrorAction Continue
        }
        else {
            Write-Output $item
        }
    }
}

# 调用示例
Invoke-TeamsCommand { Get-CsTenant }

关键说明 #

新版本MicrosoftTeams模块将Correlation ID嵌入到错误的Exception.Message中，常规-ErrorAction仅能控制错误是否显示，无法修改内容，因此需手动解析替换。正则表达式Correlation ID: .+或Correlation ID: [0-9a-f-]+可精准匹配Correlation ID格式，确保只清理目标内容。

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