Freigeben über


Attributdeklaration: ValidateScript

Das ValidateScript -Attribut gibt ein Skript an, das zum Überprüfen eines Parameters oder Variablenwerts verwendet wird. PowerShell übergibt den Wert an das Skript und generiert einen Fehler, $false wenn das Skript zurückgibt oder das Skript eine Ausnahme auslöst.

Wenn Sie das -Attribut ValidateScript verwenden, wird der Wert, der überprüft wird, der Variablen $_ zugeordnet. Sie können die Variable verwenden $_ , um auf den Wert im Skript zu verweisen.

Syntax

[ValidateScriptAttribute(ScriptBlock scriptBlock)]

Parameter

  • scriptBlock - (System.Management.Automation.ScriptBlock) Erforderlich. Der Skriptblock, der zum Überprüfen der Eingabe verwendet wird.
  • ErrorMessage – Optional: Das element, das überprüft wird, und der überprüfende Skriptblock werden als erstes und zweites Formatierungsargument übergeben.

Hinweise

  • Dieses Attribut kann nur einmal pro Parameter verwendet werden.
  • Wenn dieses Attribut auf eine Auflistung angewendet wird, muss jedes Element in der Auflistung dem Muster entsprechen.
  • Das ValidateScript-Attribut wird von der System.Management.Automation.ValidateScriptAttribute-Klasse definiert.

Weitere Informationen

System.Management.Automation.ValidateScriptAttribute

Schreiben eines Windows PowerShell-Cmdlets