PowerShell函数多ParameterSet脚本正常，导入模块后仅显默认集

我之前也碰到过一模一样的情况，在PowerShell 5.1里写带多参数集的函数，脚本里能正常看到所有参数集，一导入模块就只剩默认集，大概率是这几个地方没处理到位：

1. 确保参数集定义无歧义 #

先仔细检查你的SendMessage函数参数配置，这是最容易出问题的地方：

• 每个参数集必须有唯一的标识：要么有一个只属于该参数集的必选参数，要么确保参数的ParameterSetName明确指定所属集合；
• 共享参数要同时声明所属的所有参数集，比如[Parameter(ParameterSetName='Path', ParameterSetName='Msg')]；
• 一定要通过CmdletBinding明确指定默认参数集，不然模块导入时PowerShell可能只会识别到第一个解析的参数集。

举个标准的多参数集定义示例：

function SendMessage {
    [CmdletBinding(DefaultParameterSetName='Path')]
    param(
        # 仅属于Path参数集的必选参数
        [Parameter(Mandatory=$true, ParameterSetName='Path')]
        [string]$Path,

        # 仅属于Msg参数集的必选参数
        [Parameter(Mandatory=$true, ParameterSetName='Msg')]
        [string]$Msg,

        # 两个参数集共享的可选参数
        [Parameter(ParameterSetName='Path', ParameterSetName='Msg')]
        [string]$SmtpServer = 'your-hardcoded-server'
    )
    # 函数逻辑
}

2. 手动指定模块导出内容 #

PowerShell 5.1的自动导出有时候会丢失函数的元数据（比如参数集），建议在.psm1文件末尾手动添加导出语句：

# 在模块文件最后添加，明确导出SendMessage函数
Export-ModuleMember -Function SendMessage

这能强制PowerShell完整导出函数的所有定义信息。

3. 清除模块缓存再重新导入 #

PowerShell 5.1的模块缓存经常会导致旧的函数定义残留，即使你修改了模块文件。执行以下步骤刷新：

# 卸载已加载的目标模块
Remove-Module -Name YourModuleName -Force -ErrorAction SilentlyContinue
# 清除模块缓存（如果存在）
$env:PSModuleCachePath | Remove-Item -Force -Recurse -ErrorAction SilentlyContinue
# 强制重新导入模块
Import-Module .\YourModuleName.psm1 -Force

之后再运行gcm SendMessage -Syntax就能看到完整的参数集了。

4. 重置ISE会话 #

ISE有时候会保留之前的模块会话状态，即使你重新导入模块也没用。可以直接关闭当前ISE窗口，重新打开后再导入模块，避免会话残留的影响。

如果以上步骤都试过还是不行，可以把你的函数完整定义贴出来，这样能更精准地排查问题，但大部分情况下，前面几个操作就能解决参数集不显示的问题。

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