about_Regular_Expressions

  • Artikel

Korte beschrijving

Beschrijft reguliere expressies in PowerShell.

Lange beschrijving

Notitie

In dit artikel ziet u de syntaxis en methoden voor het gebruik van reguliere expressies in PowerShell. Niet alle syntaxis wordt besproken. Zie de reguliere expressietaal - Snelzoekgids voor een volledigere verwijzing.

Een reguliere expressie is een patroon dat wordt gebruikt om tekst te vinden. Het kan bestaan uit letterlijke tekens, operatoren en andere constructies.

In dit artikel wordt de syntaxis van de reguliere expressie in PowerShell gedemonstreert. PowerShell heeft verschillende operators en cmdlets die gebruikmaken van reguliere expressies. Meer informatie over de syntaxis en het gebruik vindt u in de onderstaande koppelingen.

Reguliere PowerShell-expressies zijn standaard niet hoofdlettergevoelig. Elke bovenstaande methode heeft een andere manier om hoofdlettergevoeligheid af te dwingen.

  • Gebruik Select-Stringvoor de parameter CaseSensitive .
  • Gebruik voor operators die gebruikmaken van reguliere expressies de hoofdlettergevoelige versie: -cmatch, -creplaceof -csplit
  • Gebruik de optie voor de switch-casesensitive instructie

Letterlijke tekens

Een reguliere expressie kan een letterlijk teken of een tekenreeks zijn. De expressie zorgt ervoor dat de engine exact overeenkomt met de tekst die is opgegeven.

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

Tekenklassen

Hoewel letterlijke tekens werken als u het exacte patroon kent, kunt u met tekenklassen minder specifiek zijn.

Tekengroepen

[character group] hiermee kunt u een willekeurig aantal tekens één keer vergelijken, terwijl [^character group] alleen tekens overeenkomen die NIET in de groep voorkomen.

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

Als de lijst met overeenkomende tekens het afbreekstreepje (-) bevat, moet het aan het begin of einde van de lijst staan om deze te onderscheiden van een tekenbereikexpressie.

Tekenbereiken

Een patroon kan ook een reeks tekens zijn. De tekens kunnen alfabetisch [A-Z], numeriek [0-9]of zelfs op ASCII gebaseerde [ -~] tekens zijn (alle afdrukbare tekens).

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

Nummers

De \d tekenklasse komt overeen met een decimaal cijfer. \D Omgekeerd komt dit overeen met een niet-decimaal getal.

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

Word-tekens

De \w tekenklasse komt overeen met elk woordteken [a-zA-Z_0-9]. Als u een niet-woordteken wilt vergelijken, gebruikt u \W.

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

Jokertekens

De punt (.) is een jokerteken in reguliere expressies. Het komt overeen met elk teken, met uitzondering van een nieuwe regel (\n).

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

Whitespace

U kunt een witruimteteken vergelijken met de \s tekenklasse. U kunt elk niet-witruimteteken \Smet elkaar vergelijken. U kunt letterlijke spatietekens vergelijken met .

# 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- '

Kwantoren

Kwantificatoren bepalen hoeveel exemplaren van elk element aanwezig moeten zijn in de invoertekenreeks.

Hier volgen enkele van de kwantificatoren die beschikbaar zijn in PowerShell:

Kwantor Beschrijving
* Nul of meer keren.
+ Een of meer keren.
? Nul of één keer.
{n,m} Tenminste n, maar niet meer dan m tijden.

Het sterretje (*) komt overeen met het vorige element nul of meer keren. Het resultaat is dat zelfs een invoertekenreeks zonder het element een overeenkomst zou zijn.

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

Het plusteken (+) komt een of meer keren overeen met het vorige element.

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

Het vraagteken ? komt overeen met het vorige element nul of eenmalig. Net als sterretje *komt het zelfs overeen met tekenreeksen waarbij het element afwezig is.

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

De {n, m} kwantificator kan op verschillende manieren worden gebruikt om gedetailleerde controle over de kwantificator mogelijk te maken. Het tweede element m en de komma , zijn optioneel.

Kwantor Beschrijving
{n} Exact overeenkomen n met het aantal keren.
{n,} Komt ten minste n overeen met het aantal keren.
{n,m} Overeenkomst tussen n en m aantal keren. 
# This returns true if it matches any phone number.
'111-222-3333' -match '\d{3}-\d{3}-\d{4}'

Ankers

Met ankers kunt u ervoor zorgen dat een overeenkomst slaagt of mislukt op basis van de positie van de overeenkomsten in de invoertekenreeks.

De twee veelgebruikte ankers zijn ^ en $. De caret ^ komt overeen met het begin van een tekenreeks en $komt overeen met het einde van een tekenreeks. Met de ankers kunt u uw tekst op een specifieke positie vergelijken terwijl u ook ongewenste tekens negeert.

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

Notitie

Wanneer u een regex met een $ anker definieert, moet u de regex tussen enkele aanhalingstekens (') plaatsen in plaats van dubbele aanhalingstekens (") of de expressie uitbreiden als een variabele.

Wanneer u ankers gebruikt in PowerShell, moet u inzicht krijgen in het verschil tussen de opties voor reguliere expressies met één regel enmeerdere regels .

  • Multiline: De multilinemodus dwingt af ^ en $ komt overeen met het begin van elke REGEL in plaats van het begin en einde van de invoertekenreeks.
  • Singleline: De modus Singleline behandelt de invoertekenreeks als een SingleLine. Hiermee dwingt u af dat het . teken overeenkomt met elk teken (inclusief nieuwe lijnen), in plaats van elk teken, behalve de nieuwe regel \n.

Als u meer wilt lezen over deze opties en hoe u deze kunt gebruiken, gaat u naar de reguliere expressietaal - Snelzoekgids.

Escape-tekens

De backslash (\) wordt gebruikt om tekens te ontsnappen, zodat ze niet worden geparseerd door de reguliere expressie-engine.

De volgende tekens zijn gereserveerd: []().\^$|?*+{}.

U moet deze tekens in uw patronen escapen om deze in uw invoertekenreeksen te vinden.

# 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,}'

Er is een statische methode van de regex-klasse die tekst voor u kan ontsnappen.

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

3\.\\d\{2,}

Notitie

Hiermee worden alle gereserveerde reguliere expressietekens ontsnapt, inclusief bestaande backslashes die worden gebruikt in tekenklassen. Zorg ervoor dat u deze alleen gebruikt voor het gedeelte van uw patroon dat u moet ontsnappen.

Andere escape-tekens

Er zijn ook gereserveerde escape-tekens die u kunt gebruiken om speciale tekentypen te vinden.

Hier volgen enkele veelgebruikte escape-tekens:

Escapeteken Beschrijving
\t Komt overeen met een tabblad
\n Komt overeen met een nieuwe regel
\r Komt overeen met een regelterugloop

Groepen, opnamen en vervangingen

Door constructies te groeperen wordt een invoertekenreeks gescheiden in subtekenreeksen die kunnen worden vastgelegd of genegeerd. Gegroepeerde subtekenreeksen worden subexpressies genoemd. Subexpressies worden standaard vastgelegd in genummerde groepen, maar u kunt er ook namen aan toewijzen.

Een groeperingsconstructie is een reguliere expressie tussen haakjes. Alle tekst die overeenkomt met de ingesloten reguliere expressie, wordt vastgelegd. In het volgende voorbeeld wordt de invoertekst opgesplitst in twee groepen die worden vastgelegd.

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

True

Gebruik de $Matchesautomatische hashtabelvariabel om vastgelegde tekst op te halen. De tekst die de hele overeenkomst vertegenwoordigt, wordt opgeslagen in de sleutel 0. Het is belangrijk te weten dat de $Matches hashtabel alleen het eerste exemplaar van een overeenkomend patroon bevat.

$Matches.0

The last logged on user was CONTOSO\jsmith

Captures worden opgeslagen in numerieke integersleutels die van links naar rechts toenemen. Capture 1 bevat alle tekst totdat de gebruikersnaam, capture 2 alleen de gebruikersnaam bevat.

$Matches

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

Belangrijk

De 0 sleutel is een geheel getal. U kunt elke Hashtable-methode gebruiken om toegang te krijgen tot de waarde die is opgeslagen.

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

PS> $Matches[0]
Dog

PS> $Matches.Item(0)
Dog

PS> $Matches.0
Dog

Benoemde opnamen

Standaard worden opnamen opgeslagen in oplopende numerieke volgorde, van links naar rechts. U kunt ook een naam toewijzen aan een vastleggende groep. Deze naam wordt een sleutel in de $Matchesautomatische hashtabelvariabele .

Gebruik binnen een vastleggende groep ?<keyname> om vastgelegde gegevens onder een benoemde sleutel op te slaan.

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

In het volgende voorbeeld wordt de nieuwste logboekvermelding opgeslagen in het Windows-beveiliging-logboek. De opgegeven reguliere expressie extraheert de gebruikersnaam en het domein uit het bericht en slaat deze op onder de sleutels:N voor naam en D voor domein.

$log = (Get-EventLog -LogName Security -Newest 1 -InstanceId 4689).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....

Zie Groeperingsconstructies in reguliere expressies voor meer informatie.

Vervangingen in reguliere expressies

Met behulp van de reguliere expressies (regex) met de -replace operator kunt u tekst dynamisch vervangen met behulp van vastgelegde tekst.

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

  • <input>: De tekenreeks die moet worden doorzocht
  • <original>: Een reguliere expressie die wordt gebruikt om de invoertekenreeks te doorzoeken
  • <substitute>: Een regex-vervangingsexpressie om overeenkomsten in de invoertekenreeks te vervangen.

De <original> en <substitute> operanden zijn onderworpen aan regels van de reguliere expressie-engine, zoals escape-tekens of vervangingsexpressies. Het vervangingspatroon kan bestaan uit een of meer vervangingen, samen met letterlijke tekens.

Er kan worden verwezen naar groepen in de <substitute> tekenreeks met behulp van het $ teken vóór de groeps-id.

Twee manieren om te verwijzen naar het vastleggen van groepen zijn op getal en op naam.

  • Op getal - Het vastleggen van groepen wordt van links naar rechts genummerd.

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

    John.D.Smith@contoso.com

  • Op naam - Capture-groepen kunnen ook worden verwezen op naam.

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

    FABRIKAM\Administrator

De $& expressie vertegenwoordigt alle overeenkomende tekst.

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

Gobble Gobble

Waarschuwing

Omdat het $ teken wordt gebruikt in tekenreeksuitbreiding, moet u letterlijke tekenreeksen met vervanging gebruiken of het $ teken escapen wanneer u dubbele aanhalingstekens gebruikt.

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

Hello Universe
Hello Universe

Als u het als letterlijke teken wilt gebruiken $ , gebruikt $$ u bovendien in plaats van de normale escapetekens. Wanneer u dubbele aanhalingstekens gebruikt, moet u nog steeds alle exemplaren ontsnappen om $ onjuiste vervanging te voorkomen.

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

$5.72
$5.72

Zie Vervangingen in reguliere expressies voor gedetailleerde informatie over vervangingsexpressies.

Zie ook