ValidateSet 屬性宣告
ValidateSetAttribute 屬性會指定一組 Cmdlet 參數自變數的可能值。 Windows PowerShell 函式也可以使用此屬性。
指定這個屬性時,Windows PowerShell 運行時間會決定 Cmdlet 參數提供的自變數是否符合所提供元素集中的專案。 只有在參數自變數符合集合中的專案時,才會執行 Cmdlet。 如果找不到相符專案,Windows PowerShell 運行時間就會擲回錯誤。
語法
[ValidateSetAttribute(params string[] validValues)]
[ValidateSetAttribute(params string[] validValues, Named Parameters)]
參數
ValidValues
(System.String) 必要。 指定有效的參數專案值。 下列範例示範如何指定一個元素或多個元素。
[ValidateSetAttribute("Steve")]
[ValidateSetAttribute("Steve","Mary")]
IgnoreCase
(System.Boolean) 選擇性具名參數。
true
的預設值表示忽略大小寫。
false
的值會使 Cmdlet 區分大小寫。
備註
每個參數只能使用這個屬性一次。
如果參數值是陣列,陣列的每個元素都必須符合屬性集的專案。
ValidateSetAttribute 屬性是由 System.Management.Automation.ValidateSetAttribute 類別所定義。