为何脚本调用PowerShell模块函数时无法隐式继承-WhatIf参数？

这个问题的核心原因是PowerShell的模块隔离机制：模块拥有独立的会话状态（Session State），而-WhatIf/-Confirm这类ShouldProcess上下文不会跨模块边界自动传递。

为什么本地函数能继承，模块函数不行？ #

当你在脚本里定义本地函数时，这些函数和主脚本共享同一个会话状态，所以ShouldProcess的状态（比如是否开启了-WhatIf）会自动在它们之间传递。但模块是独立的执行单元，PowerShell为了避免模块意外继承调用者的状态（防止不可预期的行为），默认不会将调用者的ShouldProcess上下文传递给模块内的函数。

解决方法 #

针对你的场景，有几种可靠的处理方式：

1. 显式传递ShouldProcess状态

这是最直观且推荐的方式，在调用模块函数时，手动将当前的WhatIf/Confirm状态传递过去。修改你的Call-ShowWhatIf函数如下：

function Call-ShowWhatIf {
    [CmdletBinding(SupportsShouldProcess)]
    param(
    )
    Write-Host "$($MyInvocation.Line.Trim()) > " -NoNewline
    # 传递当前的WhatIf状态
    Show-WhatIfOutput -WhatIf:$PSCmdlet.ShouldProcessPreference
    Write-Host "$($MyInvocation.Line.Trim()) > " -NoNewline
    Show-WhatIfOutput -WhatIf
}

这样当你运行Call-ShowWhatIf -WhatIf时，模块函数Show-WhatIfOutput会继承当前的WhatIf状态，输出预期的"What if..."提示，而不是实际执行操作。

2. （进阶）通过会话状态调用模块函数

如果你需要更深度的上下文共享，可以通过$PSCmdlet.SessionState来调用模块函数，它会共享当前的ShouldProcess上下文。不过这种方法相对复杂，一般推荐第一种显式传递的方式，更直观且易维护：

function Call-ShowWhatIf {
    [CmdletBinding(SupportsShouldProcess)]
    param(
    )
    Write-Host "$($MyInvocation.Line.Trim()) > " -NoNewline
    # 通过SessionState调用模块函数，继承ShouldProcess上下文
    $PSCmdlet.SessionState.InvokeCommand.InvokeScript({ Show-WhatIfOutput })
}

为什么PowerShell要这么设计？ #

这种隔离是有意为之的安全机制：模块可能被多个不同的脚本、用户或场景调用，如果自动继承调用者的WhatIf状态，可能导致模块内的关键操作意外被跳过，或者反之，执行了本应被WhatIf拦截的操作。显式传递让调用者拥有明确的控制权，确保模块行为符合预期。

当你修改后重新运行测试脚本，会看到Call-ShowWhatIf -WhatIf调用模块函数时，也会正确触发WhatIf行为，不再输出警告信息。

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