Überprüfen von Parametereingaben

PowerShell kann die an Cmdlet-Parameter übergebenen Argumente auf verschiedene Weise überprüfen. PowerShell kann die Länge, den Bereich und das Muster der Zeichen des Arguments überprüfen. Sie kann die Anzahl der verfügbaren Argumente (anzahl) überprüfen. Diese Validierungsregeln werden durch Validierungsattribute definiert, die mit dem Parameter-Attribut für öffentliche Eigenschaften der Cmdlet-Klasse deklariert werden.

Zum Überprüfen eines Parameterarguments verwendet die PowerShell-Runtime die von den Validierungsattributen bereitgestellten Informationen, um den Wert des Parameters zu bestätigen, bevor das Cmdlet ausgeführt wird. Wenn die Parametereingabe ungültig ist, erhält der Benutzer eine Fehlermeldung. Jeder Validierungsparameter definiert eine Validierungsregel, die von PowerShell erzwungen wird.

PowerShell erzwingt die Validierungsregeln basierend auf den folgenden Attributen.

ValidateCount

Gibt die minimale und maximale Anzahl von Argumenten an, die ein Parameter akzeptieren kann. Weitere Informationen finden Sie unter ValidateCount-Attributdeklaration.

ValidateLength

Gibt die minimale und maximale Anzahl von Zeichen im Parameterargument an. Weitere Informationen finden Sie unter ValidateLength-Attributdeklaration.

ValidatePattern

Gibt einen regulären Ausdruck an, der das Parameterargument überprüft. Weitere Informationen finden Sie unter ValidatePattern-Attributdeklaration.

ValidateRange

Gibt die minimalen und maximalen Werte des Parameterarguments an. Weitere Informationen finden Sie unter ValidateRange-Attributdeklaration.

ValidateScript

Gibt die gültigen Werte für das Parameterargument an. Weitere Informationen finden Sie unter ValidateScript-Attributdeklaration.

ValidateSet

Gibt die gültigen Werte für das Parameterargument an. Weitere Informationen finden Sie unter ValidateSet-Attributdeklaration.

Weitere Informationen

Überprüfen einer Parametereingabe

Schreiben eines Windows PowerShell-Cmdlets