在 PowerShell 函數開發中,若需讓特定參數互斥(即不可同時使用),核心機制在於 ParameterSetName 屬性。透過將參數歸屬於不同的參數集合,PowerShell 執行引擎會自動依據使用者輸入的參數組合,判斷屬於哪一個參數集合,進而強制執行該集合下的參數規則(如 Mandatory)。
鮮為人知的是,PowerShell 允許為同一個參數定義多個 [Parameter()] 屬性,並指定不同的 ParameterSetName。這項特性極具實戰價值:它能讓同一參數在不同場景下呈現不同的強制性——在集合 A 中為必填,在集合 B 中則為選填。
function Test-ParameterSet {
[CmdletBinding(DefaultParameterSetName='NonCredential')]
param (
$id,
# 僅在 LocalOnly 集合中可用,非強制
[Parameter(ParameterSetName='LocalOnly', Mandatory=$false)]
$LocalAction,
# 核心技巧:ComputerName 同時隸屬 Credential (強制) 與 NonCredential (選填) 兩個集合
[Parameter(ParameterSetName='Credential', Mandatory=$true)]
[Parameter(ParameterSetName='NonCredential', Mandatory=$false)]
$ComputerName,
# 僅在 Credential 集合中可用,非強制
[Parameter(ParameterSetName='Credential', Mandatory=$false)]
$Credential
)
# 除錯輸出:顯示當前觸發的參數集合名稱與實際綁定的參數
$PSCmdlet.ParameterSetName
$PSBoundParameters
if ($PSBoundParameters.ContainsKey('ComputerName')) {
Write-Warning '偵測到遠端呼叫參數'
}
}
-ComputerName 時,參數為選填;不提供也能執行。-Credential,引擎切換至 Credential 集合,此時 -ComputerName 變為強制參數,缺一不可。-LocalAction 時,-ComputerName 與 -Credential 均不可用(互斥),僅保留 -LocalAction 選填。善用 DefaultParameterSetName 設定預設行為,搭配多重 [Parameter()] 屬性,即可構建出語意清晰、參數驗證嚴謹的專業級 Cmdlet,避免在函數內部撰寫大量 if/else 手動檢查參數組合的邏輯。