PowerShell 5.1 BeginInvoke异步调用递归函数报深度超限/参数无效

两个报错和异步等待逻辑没有直接关系，全是作用域和PowerShell运行空间隔离的坑，同步执行能跑只是刚好没碰到边界条件：

1. 递归计数器$_NestLevel_没有做作用域隔离，也没有作为参数在递归调用时传递。直接在函数里写[Int16] $_NestLevel_ += 1属于隐式声明局部变量，在独立运行空间里递归调用时，要么变量每次都被重置为0导致永远触发不了退出条件、无限递归爆深度，要么变量被父作用域篡改值。
2. 函数注入和传参逻辑完全错误。[powershell]::Create()创建的是完全独立的运行空间，和当前控制台会话不共享任何函数、变量定义。用AddScript(${function:Get-Info})只是把Get-Info的脚本块内容塞到了管道里，后面连续调用的AddParameter根本不是绑定给Get-Info的参数，是绑定给整个顶层脚本的通用参数；传过去的${function:Test-Recursion}是当前会话里的脚本块，拿到独立运行空间执行时闭包上下文完全丢失，$MaxDepth的ValidateRange校验拿不到传入值，会用类型默认值0直接触发参数校验失败。
3. 递归调用时用& $MyInvocation.MyCommand.ScriptBlock，在独立运行空间里$MyInvocation的调用上下文会丢失，不会正确继承参数默认值，进一步放大递归和参数异常的问题。

1. 改造递归函数，显式传递递归层级 #

不要靠函数内变量自增计数，把递归层级作为显式参数传递，从根源上避免作用域污染：

function Test-Recursion {
    Param (
        $InputObject,
        [ValidateRange(1,100)]
        [Int16] $MaxDepth = 2,
        [Int16] $_NestLevel_ = 0
    )

    $_NestLevel_++
    if ($_NestLevel_ -gt $MaxDepth) { return }

    "<item><nest_level>$($_NestLevel_)</nest_level><max_depth>$($MaxDepth)</max_depth></item>"
    # 递归时显式传入当前层级，不依赖作用域变量
    & $MyInvocation.MyCommand.ScriptBlock -InputObject $InputObject -MaxDepth $MaxDepth -_NestLevel_ $_NestLevel_
}

2. 修正独立PowerShell实例的脚本加载逻辑 #

不要拆分AddScript和AddParameter，直接把所有依赖的函数定义、调用逻辑拼成完整的脚本块一次性加载到独立运行空间，避免跨运行空间传脚本块的上下文丢失问题：

try {
    $_ps = [powershell]::Create()
    # 用here-string把所有依赖、调用逻辑全塞进去，注意转义$避免被当前会话提前替换
    $null = $_ps.AddScript(@"
    function Test-Recursion {
        Param (
            `$InputObject,
            [ValidateRange(1,100)]
            [Int16] `$MaxDepth = 2,
            [Int16] `$_NestLevel_ = 0
        )

        `$_NestLevel_++
        if (`$_NestLevel_ -gt `$MaxDepth) { return }

        "<item><nest_level>`$(`$_NestLevel_)</nest_level><max_depth>`$(`$MaxDepth)</max_depth></item>"
        & `$MyInvocation.MyCommand.ScriptBlock -InputObject `$InputObject -MaxDepth `$MaxDepth -_NestLevel_ `$_NestLevel_
    }

    function Get-Info {
        Param (
            [Parameter(Mandatory=`$true)]
            [String] `$HostName,
            [Parameter(Mandatory=`$true)]
            [ScriptBlock] `$ConvertTo
        )
        
        # 这里替换成你实际的$some_collection、$_as业务逻辑
        `$some_collection | ForEach-Object {
            @(
                `$_as | ForEach-Object {
                    & `$ConvertTo -InputObject `$_ -MaxDepth 3
                }
            ) | Sort-Object
        }
    }

    # 直接在脚本内部完成函数调用，不需要额外AddParameter
    Get-Info -HostName 'some_server_name' -ConvertTo `$function:Test-Recursion
"@)

    $_handle = $_ps.BeginInvoke()
    # 轮询间隔不用设5秒，200毫秒足够降低资源消耗
    while (-not $_handle.IsCompleted) {
        Start-Sleep -Milliseconds 200
    }

    $_result = $_ps.EndInvoke($_handle)
    $_result
}
catch {
    # 打印全量错误信息方便后续排查
    $_ | Format-List * -Force
}
finally {
    $_ps.Dispose()
}

• 所有通过[powershell]::Create()创建的实例都是独立运行空间，和当前会话不共享任何自定义函数、变量、模块，不要尝试直接把当前会话的脚本块、变量当参数传进去，只要依赖原会话上下文的内容执行必报错。
• PowerShell里写递归逻辑，计数器、状态值一定要作为显式参数在递归调用时传递，不要依赖函数内的局部变量自增，嵌套调用、跨上下文调用时的作用域提升逻辑很容易把变量值篡改。
• 给PowerShell实例管道加命令时，AddScript后面跟的AddParameter只会给当前管道最后一个命令绑定参数，不要靠链式调用AddParameter给自定义函数传参，参数绑定逻辑和直接在控制台写命令完全不一样。

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