Freigeben über


Attributdeklaration: ValidateSet

Das ValidateSetAttribute-Attribut gibt einen Satz möglicher Werte für ein Cmdlet-Parameterargument an. Dieses Attribut kann auch von Windows PowerShell-Funktionen verwendet werden.

Wenn dieses Attribut angegeben wird, bestimmt die Windows PowerShell-Laufzeit, ob das angegebene Argument für den Cmdlet-Parameter mit einem Element im angegebenen Elementsatz übereinstimmt. Das Cmdlet wird nur ausgeführt, wenn das Parameterargument mit einem Element im Satz übereinstimmt. Wenn keine Übereinstimmung gefunden wird, wird ein Fehler von der Windows PowerShell-Laufzeit ausgelöst.

Syntax

[ValidateSetAttribute(params string[] validValues)]
[ValidateSetAttribute(params string[] validValues, Named Parameters)]

Die Parameter

ValidValues (System.String) Erforderlich. Gibt die gültigen Parameterelementwerte an. Im folgenden Beispiel wird gezeigt, wie Sie ein Element oder mehrere Elemente angeben.

[ValidateSetAttribute("Steve")]
[ValidateSetAttribute("Steve","Mary")]

IgnoreCase (System.Boolean) Optionaler benannter Parameter. Der Standardwert von true gibt an, dass der Fall ignoriert wird. Bei einem Wert von false wird die Groß-/Kleinschreibung des Cmdlets beachtet.

Bemerkungen

  • Dieses Attribut kann nur einmal pro Parameter verwendet werden.

  • Wenn der Parameterwert ein Array ist, muss jedes Element des Arrays mit einem Element des Attributsatzes übereinstimmen.

  • Das ValidateSetAttribute-Attribut wird durch die System.Management.Automation.ValidateSetAttribute Klasse definiert.

Siehe auch

System.Management.Automation.ValidateSetAttribute

Schreiben eines Windows PowerShell-Cmdlets