PowerShell脚本参数集导致位置参数无法识别问题求助

场景复现 #

脚本uninstall-package2.ps1的参数定义如下：

[CmdletBinding(DefaultParameterSetName="Uninstall")]
param (
   [parameter(Mandatory, ValueFromPipeline = $true)][string]
   $displayName,
   [parameter(ParameterSetName = "Uninstall")][string]
   $Command,
   [parameter(ParameterSetName = "QueryOnly")][switch]
   $QueryOnly,
   [string]
   $LogPath
)

使用位置参数调用时触发错误：

C:\temp\uninstall-package2.ps1 "7-zip"

错误信息：

C:\temp\uninstall-package2.ps1 : A positional parameter cannot be found that accepts argument '7-zip'.

需求说明：需保留$Command和-QueryOnly的互斥性（同时指定时报错），同时支持仅通过第一个位置参数调用脚本（适配Invoke-Command -FilePath的-ArgumentList位置参数传递方式）。

原因分析 #

定义参数集后，PowerShell会校验每个参数集的参数位置规则。$displayName未明确指定所属参数集，导致它无法被所有参数集共享识别，位置参数无法绑定到该参数上。

解决办法 #

给$displayName参数添加ParameterSetName属性，明确它属于所有参数集（用逗号分隔多个参数集名称），同时显式指定位置为0，确保位置参数能正确绑定。

修改后的参数定义：

[CmdletBinding(DefaultParameterSetName="Uninstall")]
param (
   [parameter(Mandatory, ValueFromPipeline = $true, ParameterSetName = @("Uninstall", "QueryOnly"), Position=0)][string]
   $displayName,
   [parameter(ParameterSetName = "Uninstall", Position=1)][string]
   $Command,
   [parameter(ParameterSetName = "QueryOnly")][switch]
   $QueryOnly,
   [string]
   $LogPath
)

验证效果 #

1. 仅使用位置参数调用（正常执行）：

C:\temp\uninstall-package2.ps1 "7-zip"

2. 同时指定$Command和-QueryOnly（触发参数集互斥错误，符合预期）：

C:\temp\uninstall-package2.ps1 "7-zip" "uninstall.cmd" -QueryOnly

3. 配合Invoke-Command使用位置参数（正常执行）：

Invoke-Command -ComputerName remotePC -FilePath C:\temp\uninstall-package2.ps1 -ArgumentList "7-zip"

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