Parameter-Validierung in PowerShell und ScriptRunner

Verwendung von Regex mit PowerShell und ScriptRunner: erstes Beispiel

Wir beginnen mit unserem Ausdruck aus der Regex-Einführung oben. Wir möchten eine Zeichenfolge validieren, die nur alphabetische Zeichen enthält.

In unserem PowerShell-Script definieren wir ValidatePattern wie folgt:

Param ( 
	[ValidatePattern(
			'^[a-z]+$'
			)
	] 
	[string] $OnlyLetters  
	)

Wenn dieses Script als Aktion innerhalb von ScriptRunner ausgeführt wird, kann der Parameter $OnlyLetters leicht validiert werden. Wenn die Validierung fehlschlägt, wird ein Ausrufezeichen neben dem Eingabefeld angezeigt und die Ausführen-Schaltfläche ist ausgegraut. Nachstehend finden Sie einige Validierungstests (Abbildungen 3a-c):

Abbildung 3a: Nachdem die Eingabe für $OnlyLetters validiert wurde, zeigt ScriptRunner eine Fehlerwarnung an, da die Eingabe Zahlen enthält, die durch den regulären Ausdruck verboten sind.

Abbildung 3b: Nach der Validierung der Eingabe für $OnlyLetters validiert wurde, zeigt ScriptRunner eine Fehlerwarnung an, da die Eingabe Leerzeichen enthält, die durch den regulären Ausdruck verboten sind.

Abbildung 3b: Nach der Validierung der Eingabe für $OnlyLetters validiert wurde, zeigt ScriptRunner eine Fehlerwarnung an, da die Eingabe Leerzeichen enthält, die durch den regulären Ausdruck verboten sind.

Verwendung von Regex mit PowerShell und ScriptRunner: fortgeschrittenes zweites Beispiel

Ein weiteres Beispiel aus der Praxis ist die Validierung eines Benutzer-Anmeldenamens in Active Directory.
Die maximale Länge beträgt 20 Zeichen und viele Zeichen sind verboten ( /[:;|=,+*?<>]'“.), daneben verwendet jede Firma ihre eigenen Namenskonventionen.

Hier ist ein Beispiel von einem Kunden, der Benutzeranmeldename sollte den folgenden Regeln entsprechen:

• Länge ist 10-15 Zeichen
• Keine numerischen Zeichen
• Keine Unterstriche
• Das einzige erlaubte Sonderzeichen ist „-„
• Muss mit „u-“ beginnen

Nun, lassen Sie uns diese Anforderungen in einen regulären Ausdruck übersetzen:

Param (
		[Validate Pattern (
				'^[u][-][a-z]{8,13}$'
				)
				]
		[string] $UserLoginName
	)

Und noch einmal eine kleine Erklärung zur Syntax:

Und wie Sie in den Abbildungen 4 a-e sehen können, funktioniert die Validierung!

Abbildung 4a: Nachdem die Eingabe für $UserLoginName validiert wurde, zeigt ScriptRunner eine Fehlerwarnung an, da die Eingabe zu wenige Zeichen enthält.

Abbildung 4b: Nachdem die Eingabe für $UserLoginName validiert wurde, zeigt ScriptRunner eine Fehlerwarnung an, da die Eingabezeichenfolge nicht mit „u-“ beginnt.

Abbildung 4c: Nachdem die Eingabe für $UserLoginName validiert wurde, zeigt ScriptRunner eine Fehlerwarnung an, da die Eingabe Zahlen enthält.

Abbildung 4d: Nachdem die Eingabe für $UserLoginName validiert wurde, zeigt ScriptRunner eine Fehlerwarnung an, da die Eingabe das Sonderzeichen „$“ enthält.

Abbildung 4e: Nach der Validierung der Eingabe für $UserLoginName akzeptiert ScriptRunner die Eingabe, da sie mit den im regulären Ausdruck definierten Regeln übereinstimmt.