ValidateSet Attribute Declaration
The ValidateSetAttribute attribute specifies a set of possible values for a cmdlet parameter argument. This attribute can also be used by Windows PowerShell functions.
When this attribute is specified, the Windows PowerShell runtime determines whether the supplied argument for the cmdlet parameter matches an element in the supplied element set. The cmdlet is run only if the parameter argument matches an element in the set. If no match is found, an error is thrown by the Windows PowerShell runtime.
Syntax
[ValidateSetAttribute(params string[] validValues)]
[ValidateSetAttribute(params string[] validValues, Named Parameters)]
Parameters
ValidValues (System.String)
Required. Specifies the valid parameter element values. The following sample shows how to specify one element or multiple elements.
[ValidateSetAttribute("Steve")]
[ValidateSetAttribute("Steve","Mary")]
IgnoreCase (System.Boolean)
Optional named parameter. The default value of true indicates that case is ignored. A value of false makes the cmdlet case-sensitive.
Remarks
This attribute can be used only once per parameter.
If the parameter value is an array, every element of the array must match an element of the attribute set.
The ValidateSetAttribute attribute is defined by the System.Management.Automation.Validatesetattribute class.
See Also
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for