Freigeben über

about_Regular_Expressions

  • Artikel

Kurze Beschreibung

Beschreibt reguläre Ausdrücke in PowerShell.

Lange Beschreibung

Hinweis

In diesem Artikel werden die Syntax und die Methoden für die Verwendung regulärer Ausdrücke in PowerShell erläutert, nicht die gesamte Syntax wird erläutert. Eine ausführlichere Referenz finden Sie unter Regular Expression Language – Kurzreferenz.

Ein regulärer Ausdruck ist ein Muster, das zum Abgleichen von Text verwendet wird. Sie kann aus Literalzeichen, Operatoren und anderen Konstrukten bestehen.

In diesem Artikel wird die Syntax regulärer Ausdrücke in PowerShell veranschaulicht. PowerShell verfügt über mehrere Operatoren und Cmdlets, die reguläre Ausdrücke verwenden. Weitere Informationen zu deren Syntax und Verwendung finden Sie unter den folgenden Links.

Bei regulären PowerShell-Ausdrücken wird standardmäßig nicht zwischen Groß- und Kleinschreibung unterschieden. Jede oben gezeigte Methode hat eine andere Möglichkeit, die Groß-/Kleinschreibung zu erzwingen.

  • Verwenden Sie für Select-Stringden Parameter CaseSensitive .
  • Verwenden Sie für Operatoren, die reguläre Ausdrücke verwenden, die Version, in der die Groß-/Kleinschreibung beachtet wird: -cmatch, -creplaceoder -csplit
  • Verwenden Sie für die switch -Anweisung die -casesensitive -Option.

Zeichenliterale

Ein regulärer Ausdruck kann ein Literalzeichen oder eine Zeichenfolge sein. Der Ausdruck bewirkt, dass die Engine genau mit dem angegebenen Text übereinstimmt.

# This statement returns true because book contains the string "oo"
'book' -match 'oo'

Zeichenklassen

Zeichenliterale funktionieren zwar, wenn Sie das genaue Muster kennen, aber Zeichenklassen ermöglichen es Ihnen, weniger spezifisch zu sein.

Zeichengruppen

[character group] ermöglicht es Ihnen, eine beliebige Anzahl von Zeichen einmal zuzuordnen, während [^character group] nur Zeichen, die NICHT in der Gruppe enthalten sind, übereinstimmen.

# This expression returns true if the pattern matches big, bog, or bug.
'big' -match 'b[iou]g'

Wenn die Liste der abzugleichenden Zeichen den Bindestrich (-) enthält, muss es sich am Anfang oder Ende der Liste befinden, um es von einem Zeichenbereichsausdruck zu unterscheiden.

Zeichenbereiche

Ein Muster kann auch ein Zeichenbereich sein. Die Zeichen können alphabetisch [A-Z], numerisch [0-9]oder sogar ASCII-basiert [ -~] sein (alle druckbaren Zeichen).

# This expression returns true if the pattern matches any 2 digit number.
42 -match '[0-9][0-9]'

Zahlen

Die \d Zeichenklasse entspricht einer beliebigen Dezimalzahl. Entspricht \D umgekehrt jeder nicht dezimalen Ziffer.

# This expression returns true if it matches a server name.
# (Server-01 - Server-99).
'Server-01' -match 'Server-\d\d'

Word Zeichen

Die \w Zeichenklasse entspricht einem beliebigen Wortzeichen [a-zA-Z_0-9]. Verwenden Sie , um ein beliebiges Nicht-Wort-Zeichen zuzuordnen \W.

# This expression returns true.
# The pattern matches the first word character 'B'.
'Book' -match '\w'

Platzhalter

Der Punkt (.) ist ein Wildcardzeichen in regulären Ausdrücken. Es entspricht einem beliebigen Zeichen außer einem Zeilenumbruch (\n).

# This expression returns true.
# The pattern matches any 4 characters except the newline.
'a1\ ' -match '....'

Leerraum

Sie können beliebige Leerzeichen mit der \s Zeichenklasse abgleichen. Sie können jedes Zeichen ohne Leerzeichen mit \Sabgleichen. Sie können literale Leerzeichen mit abgleichen.

# This expression returns true.
# The pattern uses the whitespace character class to match the leading
# space and a literal space to matching the trailing space.
' - ' -match '\s- '

Quantifizierer

Quantifizierer steuern, wie viele Instanzen jedes Elements in der Eingabezeichenfolge vorhanden sein sollen.

Im Folgenden finden Sie einige der in PowerShell verfügbaren Quantifizierer:

Quantifizierer Beschreibung
* 0 oder mehr Mal.
+ Ein oder mehrere Male.
? 0 oder einmal.
{n,m} Zumindest n, aber nicht mehr als m mal.

Das Sternchen (*) entspricht dem vorherigen Element 0 oder mehr Mal. Das Ergebnis ist, dass selbst eine Eingabezeichenfolge ohne das -Element eine Übereinstimmung wäre.

# This returns true for all account name strings even if the name is absent.
'ACCOUNT NAME:    Administrator' -match 'ACCOUNT NAME:\s*\w*'

Das Pluszeichen (+) stimmt einmal oder mehrmals mit dem vorherigen Element überein.

# This returns true if it matches any server name.
'DC-01' -match '[A-Z]+-\d\d'

Das Fragezeichen ? entspricht dem vorherigen Element 0 oder einmal. Wie das Sternchen *stimmt es sogar mit Zeichenfolgen überein, in denen das Element nicht vorhanden ist.

# This returns true for any server name, even server names without dashes.
'SERVER01' -match '[A-Z]+-?\d\d'

Der {n, m} Quantifizierer kann auf verschiedene Arten verwendet werden, um eine präzise Kontrolle über den Quantifizierer zu ermöglichen. Das zweite Element m und das Komma , sind optional.

Quantifizierer Beschreibung
{n} Entspricht genau n der Anzahl der Male.
{n,} Übereinstimmung mit mindestens n der Anzahl der Male.
{n,m} Übereinstimmung zwischen n und m Anzahl der Male. 
# This returns true if it matches any phone number.
'111-222-3333' -match '\d{3}-\d{3}-\d{4}'

Anchors

Mithilfe von Anchors können Sie basierend auf der Übereinstimmungsposition innerhalb der Eingabezeichenfolge eine erfolgreiche Übereinstimmung oder einen Fehler verursachen.

Die beiden häufig verwendeten Anker sind ^ und $. Das Caret ^ entspricht dem Anfang einer Zeichenfolge und $, der dem Ende einer Zeichenfolge entspricht. Mit den Ankern können Sie Ihren Text an einer bestimmten Position abgleichen und gleichzeitig unerwünschte Zeichen verwerfen.

# The pattern expects the string 'fish' to be the only thing on the line.
# This returns FALSE.
'fishing' -match '^fish$'

Hinweis

Wenn Sie einen RegEx definieren, der einen $ Anker enthält, stellen Sie sicher, dass Sie den Regex in einfache Anführungszeichen (') anstelle von doppelten Anführungszeichen (") einschließen. Andernfalls erweitert PowerShell den Ausdruck als Variable.

Wenn Sie Anker in PowerShell verwenden, sollten Sie den Unterschied zwischen den Optionen für reguläre Ausdrücke mit singleline und Multiline kennen.

  • Mehrzeilige: Der Mehrzeilige Modus erzwingt ^ und $ entspricht dem Anfang jeder ZEILE anstelle des Anfangs- und Endes der Eingabezeichenfolge.
  • Singleline: Der Singleline-Modus behandelt die Eingabezeichenfolge als SingleLine. Es erzwingt, dass das . Zeichen mit jedem Zeichen (einschließlich Zeilenumbrüchen) übereinstimmt, anstatt jedes Zeichen MIT AUSNAHME des Zeilenumbruchs \nabzugleichen.

Weitere Informationen zu diesen Optionen und deren Verwendung finden Sie unter Regular Expression Language – Kurzreferenz.

Zeichen mit Escapezeichen

Der umgekehrte Schrägstrich (\) wird verwendet, um Zeichen zu escapen, sodass sie nicht von der Engine für reguläre Ausdrücke analysiert werden.

Die folgenden Zeichen sind reserviert: []().\^$|?*+{}.

Sie müssen diese Zeichen in Ihren Mustern mit Escapezeichen versehen, um sie in Ihren Eingabezeichenfolgen abzugleichen.

# This returns true and matches numbers with at least 2 digits of precision.
# The decimal point is escaped using the backslash.
'3.141' -match '3\.\d{2,}'

Es gibt eine statische Methode der regex-Klasse, die Text für Sie mit Escapezeichen versehen kann.

[regex]::escape('3.\d{2,}')

3\.\\d\{2,}

Hinweis

Dadurch werden alle reservierten Zeichen für reguläre Ausdrücke mit Escapezeichen versehen, einschließlich vorhandener umgekehrter Schrägstriche, die in Zeichenklassen verwendet werden. Stellen Sie sicher, dass Sie es nur für den Teil Ihres Musters verwenden, den Sie zum Escapen benötigen.

Escapezeichen für andere Zeichen

Es gibt auch reservierte Escapezeichen, die Sie verwenden können, um Sonderzeichentypen abzugleichen.

Im Folgenden sind einige häufig verwendete Zeichen escapezeichen aufgeführt:

Escapezeichen BESCHREIBUNG
\t Entspricht einer Registerkarte
\n Entspricht einem Zeilenumbruch
\r Entspricht einem Wagenrücklauf

Gruppen, Erfassungen und Ersetzungen

Gruppierungskonstrukte trennen eine Eingabezeichenfolge in Teilzeichenfolgen, die erfasst oder ignoriert werden können. Gruppierte Teilzeichenfolgen werden als Teilausdrücke bezeichnet. Standardmäßig werden Teilausdrücke in nummerierten Gruppen erfasst, obwohl Sie ihnen auch Namen zuweisen können.

Ein Gruppierungskonstrukt ist ein regulärer Ausdruck, der von Klammern umgeben ist. Jeder Text, der vom eingeschlossenen regulären Ausdruck abgeglichen wird, wird erfasst. Im folgenden Beispiel wird der Eingabetext in zwei Erfassungsgruppen unterteilt.

'The last logged on user was CONTOSO\jsmith' -match '(.+was )(.+)'

True

Verwenden Sie die $Matches automatische Hashtable-Variable, um erfassten Text abzurufen. Der Text, der die gesamte Übereinstimmung darstellt, wird am Schlüssel 0gespeichert. Es ist wichtig zu beachten, dass die $Matches Hashtabelle nur das erste Vorkommen eines übereinstimmenden Musters enthält.

$Matches.0

The last logged on user was CONTOSO\jsmith

Erfassungen werden in numerischen Ganzzahlschlüsseln gespeichert, die von links nach rechts erhöht werden. Capture 1 enthält den gesamten Text, bis der Benutzername, capture 2 nur den Benutzernamen enthält.

$Matches

Name           Value
----           -----
2              CONTOSO\jsmith
1              The last logged on user was
0              The last logged on user was CONTOSO\jsmith

Wichtig

Der 0 Schlüssel ist eine Ganze Zahl. Sie können eine beliebige Hashtable-Methode verwenden, um auf den gespeicherten Wert zuzugreifen.

PS> 'Good Dog' -match 'Dog'
True

PS> $Matches[0]
Dog

PS> $Matches.Item(0)
Dog

PS> $Matches.0
Dog

Named Captures

Standardmäßig werden Aufzeichnungen in aufsteigender numerischer Reihenfolge von links nach rechts gespeichert. Sie können einer Erfassungsgruppe auch einen Namen zuweisen. Dieser Name wird zu einem Schlüssel für die $Matches automatische Hashtabellenvariable.

Verwenden Sie ?<keyname> innerhalb einer Erfassungsgruppe, um erfasste Daten unter einem benannten Schlüssel zu speichern.

PS> $string = 'The last logged on user was CONTOSO\jsmith'
PS> $string -match 'was (?<domain>.+)\\(?<user>.+)'
True

PS> $Matches

Name                           Value
----                           -----
domain                         CONTOSO
user                           jsmith
0                              was CONTOSO\jsmith

PS> $Matches.domain
CONTOSO

PS> $Matches.user
jsmith

Im folgenden Beispiel wird der neueste Protokolleintrag im Windows-Sicherheit Protokoll gespeichert. Der bereitgestellte reguläre Ausdruck extrahiert den Benutzernamen und die Domäne aus der Nachricht und speichert sie unter den Schlüsseln:N für Name und D für Domäne.

$log = (Get-WinEvent -LogName Security -MaxEvents 1).message
$r = '(?s).*Account Name:\s*(?<N>.*).*Account Domain:\s*(?<D>[A-Z,0-9]*)'
$log -match $r

True

$Matches

Name                           Value
----                           -----
D                              CONTOSO
N                              jsmith
0                              A process has exited....

Weitere Informationen finden Sie unter Gruppieren von Konstrukten in regulären Ausdrücken.

Ersetzungen in regulären Ausdrücken

Wenn Sie die regulären Ausdrücke (regex) mit dem -replace Operator verwenden, können Sie Text mithilfe des erfassten Texts dynamisch ersetzen.

<input> -replace <original>, <substitute>

  • <input>: Die zu durchsuchende Zeichenfolge
  • <original>: Ein regulärer Ausdruck, der zum Durchsuchen der Eingabezeichenfolge verwendet wird
  • <substitute>: Ein Regex-Ersetzungsausdruck zum Ersetzen von Übereinstimmungen, die in der Eingabezeichenfolge gefunden wurden.

Die <original> Operanden und <substitute> unterliegen Regeln der Engine für reguläre Ausdrücke, z. B. Escapezeichen oder Ersetzungsausdrücke. Das Ersetzungsmuster kann zusammen mit Literalzeichen aus einer oder mehreren Ersetzungen bestehen.

Auf Erfassungsgruppen kann in der <substitute> Zeichenfolge mit dem $ Zeichen vor dem Gruppenbezeichner verwiesen werden.

Zwei Möglichkeiten, auf Erfassungsgruppen zu verweisen, sind nach Zahl und nach Name.

  • Nach Zahl: Erfasste Gruppen von links nach rechts nummeriert werden.

    'John D. Smith' -replace '(\w+) (\w+)\. (\w+)', '$1.$2.$3@contoso.com'

    John.D.Smith@contoso.com

  • Nach Name: Gruppen kann auch anhand des Namens referenziert werden.

    'CONTOSO\Administrator' -replace '\w+\\(?<user>\w+)', 'FABRIKAM\${user}'

    FABRIKAM\Administrator

Der $& Ausdruck stellt den gesamten zugeordneten Text dar.

'Gobble' -replace 'Gobble', '$& $&'

Gobble Gobble

Warnung

Da das Zeichen in der $ Zeichenfolgenerweiterung verwendet wird, müssen Sie Literalzeichenfolgen mit Ersetzung verwenden oder das $ Zeichen bei verwendung doppelter Anführungszeichen mit Escapezeichen versehen.

'Hello World' -replace '(\w+) \w+', '$1 Universe'
"Hello World" -replace "(\w+) \w+", "`$1 Universe"

Hello Universe
Hello Universe

Wenn Sie darüber $ hinaus als Literalzeichen verwenden möchten, verwenden Sie $$ anstelle der normalen Escapezeichen. Wenn Sie doppelte Anführungszeichen verwenden, können Sie dennoch alle Instanzen von $ mit Escapezeichen versehen, um eine falsche Ersetzung zu vermeiden.

'5.72' -replace '(.+)', '$$$1'
"5.72" -replace "(.+)", "`$`$`$1"

$5.72
$5.72

Ausführliche Informationen zu Ersetzungsausdrücken finden Sie unter Ersetzungen in regulären Ausdrücken.

Weitere Informationen