命令行传参运行PowerShell NSG复制函数报错排查

核心原因：脚本与函数的调用方式混淆 #

你遇到的问题本质是把包含函数的脚本文件当成了可直接传参调用的cmdlet/函数来使用：

• 不传参直接运行脚本时，脚本执行了内部的函数定义，而函数本身设置了强制参数属性（比如[Parameter(Mandatory=$true)]），所以PowerShell会弹出参数输入提示，此时实际是函数在接收输入。
• 直接给脚本文件传参时，PowerShell会把参数传递给脚本本身，但你的脚本并没有定义对应的顶层参数块（param()），不具备处理传入参数的能力，真正能处理参数的是脚本内部的Copy-AzNSGRules函数，因此会提示“该脚本不是cmdlet”。

常见遗漏点及解决办法 #

1. 未先加载函数到当前会话 #

如果脚本仅定义了Copy-AzNSGRules函数但未在末尾调用它，直接运行脚本只是将函数加载到当前会话，此时需要单独调用函数并传参：

# 先运行脚本加载函数
.\你的脚本文件名.ps1
# 再调用函数并传递参数
Copy-AzNSGRules -SourceNSG "源NSG名称" -TargetNSG "目标NSG名称" -ResourceGroupName "资源组名称"

2. 脚本未定义顶层参数块并转发给函数 #

若想直接通过脚本文件传参，需在脚本顶层添加param()块接收参数，再传递给内部函数：

# 脚本顶层参数块，与函数参数保持一致
param(
    [Parameter(Mandatory=$true)]
    [string]$SourceNSG,
    [Parameter(Mandatory=$true)]
    [string]$TargetNSG,
    [Parameter(Mandatory=$true)]
    [string]$ResourceGroupName
    # 按需添加其他参数
)

# 定义函数
function Copy-AzNSGRules {
    param(
        [Parameter(Mandatory=$true)]
        [string]$SourceNSG,
        [Parameter(Mandatory=$true)]
        [string]$TargetNSG,
        [Parameter(Mandatory=$true)]
        [string]$ResourceGroupName
        # 按需添加其他参数
    )
    # 函数逻辑代码...
}

# 调用函数，传递顶层参数
Copy-AzNSGRules -SourceNSG $SourceNSG -TargetNSG $TargetNSG -ResourceGroupName $ResourceGroupName

之后即可直接通过脚本传参：

.\你的脚本文件名.ps1 -SourceNSG "源NSG名称" -TargetNSG "目标NSG名称" -ResourceGroupName "资源组名称"

3. 未使用点 sourcing 持久加载函数（可选） #

如果需要在当前会话中反复使用该函数，可通过点 sourcing 方式加载脚本，之后就能像内置cmdlet一样直接调用函数传参：

. .\你的脚本文件名.ps1
Copy-AzNSGRules -SourceNSG "源NSG名称" -TargetNSG "目标NSG名称"

内容的提问来源于stack exchange，提问作者Richmond Eric-okolai