PowerShell带强制参数脚本命令行传值后仍重复提示输入问题

触发Supply values for the following parameters强制提示，本质是脚本参数的作用域、位置不符合PowerShell语法规则，传入的参数没有被正确绑定到对应位置，常见的错误场景有两个：

• 脚本顶层的param()块没有放在文件顶端：PowerShell语法要求，脚本级别的参数块必须是文件中除注释、#requires指令之外的第一个可执行代码。如果你的脚本开头先写了函数定义、变量赋值、控制台输出语句，之后才放置param()块，这个块会被识别为脚本内部某段代码的附属语法，无法作为脚本自身的参数接收入口，你在命令行传入的参数自然无法匹配，最终触发Mandatory参数的交互输入提示。
• 参数定义仅写在脚本内部的自定义函数中，却试图通过脚本文件传参实现赋值：dot-source执行脚本的本质，是把脚本内所有代码直接加载到当前控制台会话的作用域，相当于把脚本内容粘贴到当前位置运行。如果你的脚本只在内部定义的WithParam、Testm函数里声明了Mandatory参数，没有在脚本顶层写对应的参数接收逻辑，直接给脚本文件传入的参数会被当成控制台的冗余输入，根本不会传递到内部函数的参数入口，就会弹出参数补全提示。

根据你的使用场景，两种需求对应的正确脚本结构如下：

1. 独立运行脚本（不需要把内部函数暴露到全局）
   不要把所有业务逻辑封在自定义函数里，直接把参数块放在脚本最顶端，后续工作流逻辑直接写在脚本主体中，示例：

   # param块必须放在文件最靠前的可执行位置
   param(
       [Parameter(Mandatory=$true)] 
       [Alias('host')]
       $Name,
       [Parameter(Mandatory=$true)]
       [Alias('location')]
       $IPAddress       
   )
   # 脚本实际业务逻辑
   Write-Host "收到参数：主机名 $Name，IP地址 $IPAddress"
   # 此处添加工作流启动逻辑
   

   这种结构下，不管是直接执行.\WithParam.ps1 -Name Test -IPAddress 10.10.0.1，还是dot-source方式执行. .\WithParam.ps1 -Name Test -IPAddress 10.10.0.1，都能正确识别传入的参数，不会触发强制输入提示。
2. 需要把脚本内的自定义函数暴露到全局调用
   脚本内仅做函数定义，不要在脚本层级传参，dot-source完成加载后直接调用函数传参即可，示例结构：

   # 先定义带参数的自定义函数
   function WithParam {
       [CmdletBinding()]
       param(
           [Parameter(Mandatory=$true)] 
           [Alias('host')]
           $Name,
           [Parameter(Mandatory=$true)]
           [Alias('location')]
           $IPAddress       
       )
       # 函数内的工作流启动逻辑
       Write-Host "从函数收到参数：主机名 $Name，IP地址 $IPAddress"
   }
   

   这种结构下，先执行. .\WithParam.ps1完成函数加载，再运行WithParam -Name Test -IPAddress 10.10.0.1即可正常执行。

• 检查param()块之前的内容：只要块之前存在非注释、非#requires的代码，哪怕是一行空Write-Host输出，都会导致顶层param失效。
• 理清dot-source的执行逻辑：如果选择dot-source加载脚本，就不要试图通过给脚本文件传参的方式给内部函数赋值，dot-source会把脚本的执行上下文拉到当前会话，传入的参数没有对应的顶层接收对象。

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