为何在PowerShell中重定义Write-Progress会导致命令挂起？

问题背景 #

想要借助PSFramework模块的Write-PSFMessage工具，在不重写现有所有脚本的前提下，把Write-Progress的所有输出捕获到日志文件中。曾尝试用类似方法处理Write-Verbose和Write-Host（事后发现并未成功），但将以下代码应用到Write-Progress时，程序直接挂起：

function Write-MyProgress {
  param (
    [Parameter(Mandatory)]
    [string]$Activity,
    [string]$Status = 'Processing'
  )

  $params = @{
    Activity = $Activity
    Status   = $Status
  }
  Write-Progress @params

  $LogMessage = "PROGRESS: $Activity - $Status"
  Write-PSFMessage -Level SomewhatVerbose -Message $LogMessage
}

Set-Alias Write-Progress -Value Write-MyProgress

问题原因 #

代码挂起的核心原因是无限递归：通过Set-Alias将Write-Progress指向了自定义的Write-MyProgress函数，而函数内部又调用了Write-Progress——此时调用的已经是别名指向的自定义函数，而非PowerShell原生的Write-Progress cmdlet，导致函数不断自我调用，最终程序挂起。

解决方案 #

要避免递归，必须在自定义函数中直接调用原生的Write-Progress命令，而非别名后的版本。可以先保存原生命令的引用，再在函数中调用该引用：

# 保存原生Write-Progress命令的引用
$originalWriteProgress = Get-Command Write-Progress -CommandType Cmdlet

function Write-MyProgress {
  param (
    [Parameter(Mandatory)]
    [string]$Activity,
    [string]$Status = 'Processing',
    # 保留原生Write-Progress的所有参数，确保兼容性
    [string]$CurrentOperation,
    [int]$PercentComplete,
    [int]$Id = 0,
    [int]$ParentId = -1,
    [switch]$Completed,
    [string]$SourceId
  )

  # 收集所有传入的参数，传递给原生命令
  $params = $PSBoundParameters
  # 调用原生的Write-Progress
  & $originalWriteProgress @params

  # 构造日志消息并写入PSFramework日志
  $LogMessage = "PROGRESS: $Activity - $Status"
  if ($CurrentOperation) { $LogMessage += " - $CurrentOperation" }
  if ($PercentComplete -ge 0) { $LogMessage += " ($PercentComplete%)" }
  Write-PSFMessage -Level SomewhatVerbose -Message $LogMessage
}

# 设置别名覆盖原生Write-Progress
Set-Alias Write-Progress -Value Write-MyProgress -Force

关键说明 #

1. 保存原生命令引用：用Get-Command获取原生Write-Progress的cmdlet对象，避免别名覆盖后无法调用原生命令。
2. 兼容所有参数：自定义函数保留了原生Write-Progress的全部参数，确保现有脚本使用任何参数时都能正常工作。
3. 避免递归：通过& $originalWriteProgress @params直接调用原生命令，不会触发别名指向的自定义函数，彻底解决递归问题。

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