Feedback

Select-String

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee vindt u tekst in tekenreeksen en bestanden.

Syntax

Select-String
      [-Culture <String>]
      [-Pattern] <String[]>
      [-Path] <String[]>
      [-SimpleMatch]
      [-CaseSensitive]
      [-Quiet]
      [-List]
      [-NoEmphasis]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-NotMatch]
      [-AllMatches]
      [-Encoding <Encoding>]
      [-Context <Int32[]>]
      [<CommonParameters>]
Select-String
      [-Culture <String>]
      -InputObject <PSObject>
      [-Pattern] <String[]>
      -Raw
      [-SimpleMatch]
      [-CaseSensitive]
      [-List]
      [-NoEmphasis]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-NotMatch]
      [-AllMatches]
      [-Encoding <Encoding>]
      [-Context <Int32[]>]
      [<CommonParameters>]
Select-String
      [-Culture <String>]
      -InputObject <PSObject>
      [-Pattern] <String[]>
      [-SimpleMatch]
      [-CaseSensitive]
      [-Quiet]
      [-List]
      [-NoEmphasis]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-NotMatch]
      [-AllMatches]
      [-Encoding <Encoding>]
      [-Context <Int32[]>]
      [<CommonParameters>]
Select-String
      [-Culture <String>]
      [-Pattern] <String[]>
      [-Path] <String[]>
      -Raw
      [-SimpleMatch]
      [-CaseSensitive]
      [-List]
      [-NoEmphasis]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-NotMatch]
      [-AllMatches]
      [-Encoding <Encoding>]
      [-Context <Int32[]>]
      [<CommonParameters>]
Select-String
      [-Culture <String>]
      [-Pattern] <String[]>
      -LiteralPath <String[]>
      -Raw
      [-SimpleMatch]
      [-CaseSensitive]
      [-List]
      [-NoEmphasis]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-NotMatch]
      [-AllMatches]
      [-Encoding <Encoding>]
      [-Context <Int32[]>]
      [<CommonParameters>]
Select-String
      [-Culture <String>]
      [-Pattern] <String[]>
      -LiteralPath <String[]>
      [-SimpleMatch]
      [-CaseSensitive]
      [-Quiet]
      [-List]
      [-NoEmphasis]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-NotMatch]
      [-AllMatches]
      [-Encoding <Encoding>]
      [-Context <Int32[]>]
      [<CommonParameters>]

Description

De Select-String cmdlet maakt gebruik van reguliere expressies die overeenkomen met tekstpatronen in invoertekenreeksen en bestanden. U kunt vergelijkbaar zijn Select-String met grep in UNIX of findstr.exe in Windows.

Select-String is gebaseerd op tekstregels. Select-String Standaard wordt de eerste overeenkomst in elke regel gevonden en wordt voor elke overeenkomst de bestandsnaam, het regelnummer en alle tekst in de regel met de overeenkomst weergegeven. U kunt direct meerdere Select-String overeenkomsten per regel vinden, tekst weergeven vóór en na de overeenkomst of een Booleaanse waarde (waar of onwaar) weergeven die aangeeft of er een overeenkomst is gevonden.

Select-String kan alle tekstovereenkomsten weergeven of stoppen na de eerste overeenkomst in elk invoerbestand. Select-String kan worden gebruikt om alle tekst weer te geven die niet overeenkomt met het opgegeven patroon.

U kunt ook opgeven dat Select-String een bepaalde tekencodering moet verwachten, bijvoorbeeld wanneer u bestanden met Unicode-tekst zoekt. Select-String maakt gebruik van de byte-order-mark (BOM) om de coderingsindeling van het bestand te detecteren. Als het bestand geen stuklijst bevat, wordt ervan uitgegaan dat de codering UTF8 is.

Voorbeelden

Voorbeeld 1: Een hoofdlettergevoelige overeenkomst zoeken

In dit voorbeeld wordt een hoofdlettergevoelige overeenkomst uitgevoerd met de tekst die is verzonden naar de pijplijn naar de Select-String cmdlet.

'Hello', 'HELLO' | Select-String -Pattern 'HELLO' -CaseSensitive -SimpleMatch

De tekenreeksen Hello en HELLO worden naar de Select-String cmdlet verzonden. Select-String gebruikt de parameter Pattern om HELLO op te geven. De parameter CaseSensitive geeft aan dat de case alleen moet overeenkomen met het hoofdletterpatroon. SimpleMatch is een optionele parameter en geeft aan dat de tekenreeks in het patroon niet wordt geïnterpreteerd als een reguliere expressie. Select-String geeft HELLO weer in de PowerShell-console.

Voorbeeld 2: Overeenkomsten zoeken in tekstbestanden

Met deze opdracht worden alle bestanden met de .txt bestandsnaamextensie in de huidige map doorzocht. In de uitvoer worden de regels in die bestanden weergegeven die de opgegeven tekenreeks bevatten.

Get-Alias | Out-File -FilePath .\Alias.txt
Get-Command | Out-File -FilePath .\Command.txt
Select-String -Path .\*.txt -Pattern 'Get-'

Alias.txt:8:Alias            cat -> Get-Content
Alias.txt:28:Alias           dir -> Get-ChildItem
Alias.txt:43:Alias           gal -> Get-Alias
Command.txt:966:Cmdlet       Get-Acl
Command.txt:967:Cmdlet       Get-Alias

In dit voorbeeld Get-Alias worden ze Get-Command gebruikt met de Out-File cmdlet om twee tekstbestanden te maken in de huidige map, Alias.txt en Command.txt.

Select-String gebruikt de parameter Path met het sterretje (*) om alle bestanden in de huidige map te doorzoeken met de bestandsnaamextensie .txt. Met de parameter Patroon geeft u de tekst op die overeenkomt met Get-. Select-String geeft de uitvoer weer in de PowerShell-console. De bestandsnaam en het regelnummer voorafgaan aan elke inhoudsregel die een overeenkomst bevat voor de parameter Pattern .

Voorbeeld 3: Een patroonovereenkomst zoeken

In dit voorbeeld worden meerdere bestanden gezocht om overeenkomsten voor het opgegeven patroon te vinden. Het patroon maakt gebruik van een reguliere expressie-kwantificator. Zie about_Regular_Expressions voor meer informatie.

Select-String -Path "$PSHOME\en-US\*.txt" -Pattern '\?'

C:\Program Files\PowerShell\6\en-US\default.help.txt:27:    beginning at https://go.microsoft.com/fwlink/?LinkID=108518.
C:\Program Files\PowerShell\6\en-US\default.help.txt:50:    or go to: https://go.microsoft.com/fwlink/?LinkID=210614

De Select-String cmdlet maakt gebruik van twee parameters, Path en Pattern. De parameter Path gebruikt de variabele $PSHOME waarmee de PowerShell-map wordt opgegeven. De rest van het pad bevat de submap en-US en geeft elk *.txt bestand in de map op. De parameter Pattern geeft aan dat deze overeenkomt met een vraagteken (?) in elk bestand. Een backslash (\) wordt gebruikt als escapeteken en is nodig omdat het vraagteken (?) een reguliere expressie-kwantificator is. Select-String geeft de uitvoer weer in de PowerShell-console. De bestandsnaam en het regelnummer voorafgaan aan elke inhoudsregel die een overeenkomst bevat voor de parameter Pattern .

Voorbeeld 4: Select-String gebruiken in een functie

In dit voorbeeld wordt een functie gemaakt om te zoeken naar een patroon in de Help-bestanden van PowerShell. In dit voorbeeld bestaat de functie alleen in de PowerShell-sessie. Wanneer de PowerShell-sessie is gesloten, wordt de functie verwijderd. Zie about_Functions voor meer informatie.

function Search-Help
{
    $PSHelp = "$PSHOME\en-US\*.txt"
    Select-String -Path $PSHelp -Pattern 'About_'
}

Search-Help

C:\Program Files\PowerShell\7\en-US\default.help.txt:67:    The titles of conceptual topics begin with "About_".
C:\Program Files\PowerShell\7\en-US\default.help.txt:70:    Get-Help About_<topic-name>
C:\Program Files\PowerShell\7\en-US\default.help.txt:93:    Get-Help About_Modules : Displays help about PowerShell modules.
C:\Program Files\PowerShell\7\en-US\default.help.txt:97:    about_Updatable_Help

De functie wordt gemaakt op de PowerShell-opdrachtregel. De Function opdracht gebruikt de naam Search-Help. Druk op Enter om instructies toe te voegen aan de functie. Voeg vanuit de >> prompt elke instructie toe en druk op Enter , zoals wordt weergegeven in het voorbeeld. Nadat de haak sluiten is toegevoegd, keert u terug naar een PowerShell-prompt.

De functie bevat twee opdrachten. Met $PSHelp de variabele wordt het pad naar de Help-bestanden van PowerShell opgeslagen. $PSHOME is de PowerShell-installatiemap met de submap en-US die elk *.txt bestand in de map aangeeft.

De Select-String opdracht in de functie maakt gebruik van de parameters Pad en Patroon . De parameter Path gebruikt de $PSHelp variabele om het pad op te halen. De parameter Pattern gebruikt de tekenreeks About_ als zoekcriteria.

Als u de functie wilt uitvoeren, typt u Search-Help. Met de opdracht van Select-String de functie wordt de uitvoer weergegeven in de PowerShell-console.

Voorbeeld 5: Zoeken naar een tekenreeks in een Windows-gebeurtenislogboek

In dit voorbeeld wordt gezocht naar een tekenreeks in een Windows-gebeurtenislogboek. De variabele $_ vertegenwoordigt het huidige object in de pijplijn. Zie about_Automatic_Variables voor meer informatie.

$Events = Get-WinEvent -LogName Application -MaxEvents 50
$Events | Select-String -InputObject {$_.message} -Pattern 'Failed'

De Get-WinEvent cmdlet gebruikt de parameter LogName om het toepassingslogboek op te geven. Met de parameter MaxEvents worden de 50 meest recente gebeurtenissen uit het logboek opgehaald. De logboekinhoud wordt opgeslagen in de variabele met de naam $Events.

De $Events variabele wordt naar de pijplijn verzonden naar de Select-String cmdlet. Select-String gebruikt de parameter InputObject . De $_ variabele vertegenwoordigt het huidige object en message is een eigenschap van de gebeurtenis. De patroonparameter soort de tekenreeks Is mislukt en zoekt naar overeenkomsten in $_.message. Select-String geeft de uitvoer weer in de PowerShell-console.

Voorbeeld 6: Een tekenreeks zoeken in submappen

In dit voorbeeld wordt in een map en alle submappen gezocht naar een specifieke tekenreeks.

Get-ChildItem -Path C:\Windows\System32\*.txt -Recurse | Select-String -Pattern 'Microsoft' -CaseSensitive

Get-ChildItem gebruikt de parameter Path om C:\Windows\System32*.txtop te geven. De parameter Recurse bevat de submappen. De objecten worden naar de pijplijn Select-Stringverzonden.

Select-String maakt gebruik van de parameter Pattern en geeft de tekenreeks Microsoft op. De parameter CaseSensitive wordt gebruikt om het exacte hoofdlettergebruik van de tekenreeks te vinden. Select-String geeft de uitvoer weer in de PowerShell-console.

Notitie

Afhankelijk van uw machtigingen ziet u mogelijk geweigerde berichten in de uitvoer.

Voorbeeld 7: Tekenreeksen zoeken die niet overeenkomen met een patroon

In dit voorbeeld ziet u hoe u regels met gegevens uitsluit die niet overeenkomen met een patroon.

Get-Command | Out-File -FilePath .\Command.txt
Select-String -Path .\Command.txt -Pattern 'Get', 'Set'  -NotMatch

Met Get-Command de cmdlet worden objecten in de pijplijn naar de Out-File pijplijn verzonden om het Command.txt-bestand in de huidige map te maken. Select-String gebruikt de parameter Path om het Command.txt-bestand op te geven. Met de parameter Pattern geeft u Get and Set op als zoekpatroon. De parameter NotMatch sluit Get and Set uit van de resultaten. Select-String geeft de uitvoer weer in de PowerShell-console waarin Get of Set niet is opgenomen.

Voorbeeld 8: Lijnen zoeken voor en na een overeenkomst

In dit voorbeeld ziet u hoe u de regels voor en na het overeenkomende patroon kunt ophalen.

Get-Command | Out-File -FilePath .\Command.txt
Select-String -Path .\Command.txt -Pattern 'Get-Computer' -Context 2, 3

Command.txt:986:Cmdlet          Get-CmsMessage           6.1.0.0    Microsoft.PowerShell.Security
  Command.txt:987:Cmdlet          Get-Command              6.1.2.0    Microsoft.PowerShell.Core
> Command.txt:988:Cmdlet          Get-ComputerInfo         6.1.0.0    Microsoft.PowerShell.Management
  Command.txt:990:Cmdlet          Get-Content              6.1.0.0    Microsoft.PowerShell.Management
  Command.txt:991:Cmdlet          Get-ControlPanelItem     3.1.0.0    Microsoft.PowerShell.Management
  Command.txt:992:Cmdlet          Get-Credential           6.1.0.0    Microsoft.PowerShell.Security

Met Get-Command de cmdlet worden objecten in de pijplijn naar de Out-File pijplijn verzonden om het Command.txt-bestand in de huidige map te maken. Select-String gebruikt de parameter Path om het Command.txt-bestand op te geven. De parameter Pattern geeft op Get-Computer als het zoekpatroon. De contextparameter maakt gebruik van twee waarden, voor en na en markeert patroonovereenkomsten in de uitvoer met een hoekhaak (>). De contextparameter voert de twee regels uit voordat het eerste patroon overeenkomt en drie regels na de laatste patroonovereenkomst.

Voorbeeld 9: Alle patroonovereenkomsten zoeken

In dit voorbeeld ziet u hoe met de parameter AllMatches elke patroonovereenkomst in een tekstregel wordt gevonden. Select-String Standaard wordt alleen het eerste exemplaar van een patroon in een tekstregel gevonden. In dit voorbeeld worden objecteigenschappen gebruikt die worden gevonden met de Get-Member cmdlet.

$A = Get-ChildItem -Path "$PSHOME\en-US\*.txt" | Select-String -Pattern 'PowerShell'
$A

C:\Program Files\PowerShell\7\en-US\default.help.txt:3:    PowerShell Help System
C:\Program Files\PowerShell\7\en-US\default.help.txt:6:    Displays help about PowerShell cmdlets and concepts.
C:\Program Files\PowerShell\7\en-US\default.help.txt:9:    PowerShell Help describes PowerShell cmdlets

$A.Matches

Groups   : {0}
Success  : True
Name     : 0
Captures : {0}
Index    : 4
Length   : 10
Value    : PowerShell

$A.Matches.Length

8

$B = Get-ChildItem -Path "$PSHOME\en-US\*.txt" | Select-String -Pattern 'PowerShell' -AllMatches
$B.Matches.Length

9

De Get-ChildItem cmdlet maakt gebruik van de parameter Path . De parameter Path gebruikt de variabele $PSHOME waarmee de PowerShell-map wordt opgegeven. De rest van het pad bevat de submap en-US en geeft elk *.txt bestand in de map op. De Get-ChildItem objecten worden opgeslagen in de $A variabele. De $A variabele wordt naar de pijplijn verzonden naar de Select-String cmdlet. Select-String gebruikt de parameter Pattern om elk bestand voor de tekenreeks PowerShell te doorzoeken.

Vanaf de PowerShell-opdrachtregel wordt de inhoud van de $A variabele weergegeven. Er is een regel die twee exemplaren van de tekenreeks PowerShell bevat.

De $A.Matches eigenschap bevat het eerste exemplaar van het patroon PowerShell op elke regel.

De $A.Matches.Length eigenschap telt het eerste exemplaar van het patroon PowerShell op elke regel.

De $B variabele maakt gebruik van dezelfde Get-ChildItem en Select-String cmdlets, maar voegt de parameter AllMatches toe. AllMatches vindt elk exemplaar van het patroon PowerShell op elke regel. De objecten die zijn opgeslagen in de $A en $B variabelen zijn identiek.

De $B.Matches.Length eigenschap neemt toe omdat voor elke regel elk exemplaar van het patroon PowerShell wordt geteld.

Voorbeeld 10: Pijplijnobjecten converteren naar tekenreeksen met behulp van 'Out-String'

Het ToString() resultaat van het doorgesluisde object is niet dezelfde rijke tekenreeksweergave die wordt geproduceerd door het opmaaksysteem van PowerShell. Misschien moet u de objecten Out-String eerst doorsnijden.

Piping om Out-String de opgemaakte uitvoer te converteren naar één tekenreeksobject met meerdere regels. Dit betekent dat wanneer een Select-String overeenkomst wordt gevonden, de hele tekenreeks met meerdere regels wordt uitgevoerd.

PS> $hash = @{
    Name = 'foo'
    Category = 'bar'
}

# !! NO output, due to .ToString() conversion
$hash | Select-String -Pattern 'foo'

# Out-String converts the output to a single multi-line string object
PS> $hash | Out-String | Select-String -Pattern 'foo'

Name                           Value
----                           -----
Name                           foo
Category                       bar

# Out-String -Stream converts the output to a multiple single-line string objects
PS> $hash | Out-String -Stream | Select-String -Pattern 'foo'

Name                           foo

Piping om Out-String -Stream de opgemaakte uitvoer te converteren naar meerdere tekenreeksobjecten met één regel. Dit betekent dat wanneer een Select-String overeenkomst wordt gevonden, alleen de overeenkomende lijn wordt uitgevoerd.

Parameters

-AllMatches

Geeft aan dat de cmdlet zoekt naar meer dan één overeenkomst in elke tekstregel. Zonder deze parameter Select-String vindt u alleen de eerste overeenkomst in elke tekstregel.

Wanneer Select-String er meer dan één overeenkomst in een tekstregel wordt gevonden, wordt er nog steeds slechts één MatchInfo-object voor de regel verzonden, maar bevat de eigenschap Overeenkomsten van het object alle overeenkomsten.

Notitie

Deze parameter wordt genegeerd wanneer deze wordt gebruikt in combinatie met de parameter SimpleMatch . Als u alle overeenkomsten wilt retourneren en het patroon waarnaar u zoekt, reguliere expressietekens bevat, moet u deze tekens ontsnappen in plaats van SimpleMatch te gebruiken. Zie about_Regular_Expressions voor meer informatie over het ontsnappen van reguliere expressies.

Type:SwitchParameter
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-CaseSensitive

Geeft aan dat de cmdlet-overeenkomsten hoofdlettergevoelig zijn. Overeenkomsten zijn standaard niet hoofdlettergevoelig.

Type:SwitchParameter
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-Context

Hiermee wordt het opgegeven aantal regels vastgelegd vóór en na de lijn die overeenkomt met het patroon.

Als u één getal invoert als de waarde van deze parameter, bepaalt dat getal het aantal regels dat voor en na de overeenkomst is vastgelegd. Als u twee getallen invoert als de waarde, bepaalt het eerste getal het aantal regels vóór de overeenkomst en het tweede getal bepaalt het aantal regels na de overeenkomst. Bijvoorbeeld -Context 2,3.

In de standaardweergave worden lijnen met een overeenkomst aangegeven door een rechte punthaak (>) (ASCII 62) in de eerste kolom van de weergave. Niet-gemarkeerde lijnen zijn de context.

De contextparameter wijzigt niet het aantal objecten dat door Select-String. Select-String genereert één MatchInfo-object voor elke overeenkomst. De context wordt opgeslagen als een matrix met tekenreeksen in de eigenschap Context van het object.

Wanneer de uitvoer van een opdracht naar een Select-String andere Select-String opdracht wordt verzonden, zoekt de ontvangende opdracht alleen naar de tekst in de overeenkomende regel. De overeenkomende lijn is de waarde van de eigenschap Lijn van het object MatchInfo , niet de tekst in de contextregels. Als gevolg hiervan is de contextparameter niet geldig voor de ontvangende Select-String opdracht.

Wanneer de context een overeenkomst bevat, bevat het MatchInfo-object voor elke overeenkomst alle contextlijnen, maar de overlappende lijnen worden slechts eenmaal weergegeven in de weergave.

Type:Int32[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Culture

Hiermee geeft u een cultuurnaam die overeenkomt met het opgegeven patroon. De parameter Culture moet worden gebruikt met de parameter SimpleMatch . Het standaardgedrag maakt gebruik van de cultuur van de huidige PowerShell-runspace (sessie).

Gebruik Get-Culture -ListAvailable de opdracht om een lijst met alle ondersteunde culturen op te halen.

Bovendien accepteert deze parameter de volgende argumenten:

  • CurrentCulture, dat is standaard;
  • Ordinaal, dat is niet-taalkundige binaire vergelijking;
  • Invariant, dat is cultuuronafhankelijke vergelijking.

Met Select-String -Culture Ordinal -CaseSensitive -SimpleMatch de opdracht krijgt u de snelste binaire vergelijking.

De parameter Cultuur maakt gebruik van tabvoltooiing om door de lijst met argumenten te bladeren die de beschikbare culturen opgeven. Gebruik de volgende opdracht om alle beschikbare argumenten weer te geven:

(Get-Command Select-String).Parameters.Culture.Attributes.ValidValues

Zie CultureInfo.Name voor meer informatie over de eigenschap .NET CultureInfo.Name.

De parameter Culture is geïntroduceerd in PowerShell 7.

Type:String
Position:Named
Default value:Culture of the current PowerShell session
Accept pipeline input:False
Accept wildcard characters:False
-Encoding

Hiermee geeft u het type codering voor het doelbestand. De standaardwaarde is utf8NoBOM.

De acceptabele waarden voor deze parameter zijn als volgt:

  • ascii: Gebruikt de codering voor de ASCII-tekenset (7-bits).
  • bigendianunicode: Codeert in UTF-16-indeling met behulp van de bytevolgorde big-endian.
  • bigendianutf32: Codeert in UTF-32-indeling met behulp van de bytevolgorde big-endian.
  • oem: maakt gebruik van de standaardcodering voor MS-DOS en consoleprogramma's.
  • unicode: Codeert in UTF-16-indeling met behulp van de bytevolgorde little-endian.
  • utf7: Codeert in UTF-7-indeling.
  • utf8: Codeert in UTF-8-indeling.
  • utf8BOM: Codeert in UTF-8-indeling met Byte Order Mark (BOM)
  • utf8NoBOM: Codeert in UTF-8-indeling zonder Byte Order Mark (BOM)
  • utf32: Codeert in UTF-32-indeling.

Vanaf PowerShell 6.2 staat de coderingsparameter ook numerieke id's toe van geregistreerde codepagina's (zoals -Encoding 1251) of tekenreeksnamen van geregistreerde codepagina's (zoals).-Encoding "windows-1251" Zie de .NET-documentatie voor Encoding.CodePage voor meer informatie.

Notitie

UTF-7* wordt niet meer aanbevolen om te gebruiken. Vanaf PowerShell 7.1 wordt een waarschuwing geschreven als u opgeeft utf7 voor de coderingsparameter .

Type:Encoding
Accepted values:ASCII, BigEndianUnicode, BigEndianUTF32, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32
Position:Named
Default value:UTF8NoBOM
Accept pipeline input:False
Accept wildcard characters:False
-Exclude

Sluit de opgegeven items uit. De waarde van deze parameter komt in aanmerking voor de path-parameter . Voer een padelement of -patroon in, zoals *.txt. Jokertekens zijn toegestaan.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True
-Include

Bevat de opgegeven items. De waarde van deze parameter komt in aanmerking voor de path-parameter . Voer een padelement of -patroon in, zoals *.txt. Jokertekens zijn toegestaan.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True
-InputObject

Hiermee geeft u de tekst die moet worden doorzocht. Voer een variabele in die de tekst bevat of typ een opdracht of expressie die de tekst ophaalt.

Het gebruik van de parameter InputObject is niet hetzelfde als het verzenden van tekenreeksen naar de pijplijn Select-String.

Wanneer u meer dan één tekenreeks doorgeeft aan de Select-String cmdlet, wordt gezocht naar de opgegeven tekst in elke tekenreeks en wordt elke tekenreeks geretourneerd die de zoektekst bevat.

Wanneer u de parameter InputObject gebruikt om een verzameling tekenreeksen te verzenden, Select-String wordt de verzameling behandeld als één gecombineerde tekenreeks. Select-String retourneert de tekenreeksen als een eenheid als de zoektekst in een tekenreeks wordt gevonden.

FileInfo-objecten worden behandeld als een pad naar een bestand. Wanneer bestandspaden worden opgegeven, wordt de inhoud van het bestand doorzocht, Select-String niet in de ToString() weergave van het object.

Type:PSObject
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-List

Alleen het eerste exemplaar van overeenkomende tekst wordt geretourneerd uit elk invoerbestand. Dit is de meest efficiënte manier om een lijst met bestanden op te halen die inhoud bevatten die overeenkomt met de reguliere expressie.

Retourneert standaard Select-String een MatchInfo-object voor elke overeenkomst die wordt gevonden.

Type:SwitchParameter
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-LiteralPath

Hiermee geeft u het pad naar de bestanden die moeten worden doorzocht. De waarde van de parameter LiteralPath wordt exact gebruikt terwijl deze wordt getypt. Er worden geen tekens geïnterpreteerd als jokertekens. Als het pad escapetekens bevat, plaatst u het tussen enkele aanhalingstekens. Enkele aanhalingstekens geven PowerShell aan dat er geen tekens moeten worden geïnterpreteerd als escapereeksen. Zie about_Quoting_Rules voor meer informatie.

Type:String[]
Aliases:PSPath, LP
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-NoEmphasis

Markeert standaard Select-String de tekenreeks die overeenkomt met het patroon dat u hebt gezocht met de parameter Pattern . De parameter NoEmphasis schakelt de markering uit.

De nadruk maakt gebruik van negatieve kleuren op basis van uw PowerShell-achtergrond en tekstkleuren. Als uw PowerShell-kleuren bijvoorbeeld een zwarte achtergrond met witte tekst zijn. De nadruk ligt op een witte achtergrond met zwarte tekst.

Deze parameter is geïntroduceerd in PowerShell 7.

Type:SwitchParameter
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-NotMatch

De parameter NotMatch zoekt tekst die niet overeenkomt met het opgegeven patroon.

Type:SwitchParameter
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-Path

Hiermee geeft u het pad naar de bestanden die moeten worden gezocht. Jokertekens zijn toegestaan. De standaardlocatie is de lokale map.

Geef bestanden op in de map, zoals log1.txt, *.docof *.*. Als u alleen een map opgeeft, mislukt de opdracht.

Type:String[]
Position:1
Default value:Local directory
Accept pipeline input:True
Accept wildcard characters:True
-Pattern

Hiermee geeft u de tekst te zoeken op elke regel. De patroonwaarde wordt behandeld als een reguliere expressie.

Zie about_Regular_Expressions voor meer informatie over reguliere expressies.

Type:String[]
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Quiet

Geeft aan dat de cmdlet een Booleaanse waarde (Waar of Onwaar) retourneert in plaats van een MatchInfo-object . De waarde is Waar als het patroon wordt gevonden; anders is de waarde Onwaar.

Type:SwitchParameter
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-Raw

Zorgt ervoor dat de cmdlet alleen de overeenkomende tekenreeksen uitvoert in plaats van MatchInfo-objecten . Dit is het resultaat van gedrag dat het meest lijkt op de Unix grep - of Windows -findstr.exe-opdrachten .

Deze parameter is geïntroduceerd in PowerShell 7.

Type:SwitchParameter
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-SimpleMatch

Geeft aan dat de cmdlet een eenvoudige overeenkomst gebruikt in plaats van een reguliere expressieovereenkomst. In een eenvoudige overeenkomst Select-String zoekt u de invoer voor de tekst in de parameter Patroon . De waarde van de parameter Pattern wordt niet geïnterpreteerd als een reguliere expressie-instructie.

Wanneer SimpleMatch wordt gebruikt, is de eigenschap Matches van het geretourneerde Object MatchInfo ook leeg.

Notitie

Wanneer deze parameter wordt gebruikt met de parameter AllMatches , wordt de AllMatches genegeerd.

Type:SwitchParameter
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

PSObject

U kunt elk object met een ToString() methode doorsluisen naar Select-String.

Uitvoerwaarden

Microsoft.PowerShell.Commands.MatchInfo, System.Boolean, System.String

Standaard is de uitvoer een set MatchInfo-objecten met één voor elke gevonden overeenkomst. Als u de parameter Quiet gebruikt, is de uitvoer een Booleaanse waarde die aangeeft of het patroon is gevonden. Als u de parameter Raw gebruikt, is de uitvoer een set tekenreeksobjecten die overeenkomen met het patroon.

Notities

Select-String is vergelijkbaar met grep in UNIX of findstr.exe in Windows.

De sls alias voor de Select-String cmdlet is geïntroduceerd in PowerShell 3.0.

Notitie

Volgens goedgekeurde werkwoorden voor PowerShell-opdrachten is schet officiële aliasvoorvoegsel voor Select-* cmdlets nietsl. Daarom moet de juiste alias Select-String zijn scs, niet sls. Dit is een uitzondering op deze regel.

Bij het doorsluisen van objecten naar Select-String:

  • FileInfo-objecten worden behandeld als een pad naar een bestand. Wanneer bestandspaden worden opgegeven, wordt de inhoud van het bestand doorzocht, Select-String niet in de ToString() weergave van het object.
  • Het ToString() resultaat van het doorgesluisde object is niet dezelfde rijke tekenreeksweergave die wordt geproduceerd door het opmaaksysteem van PowerShell. Misschien moet u de objecten Out-String eerst doorsnijden. Zie voorbeeld 10 voor meer informatie.

Als u wilt gebruiken Select-String, typt u de tekst die u wilt zoeken als de waarde van de parameter Pattern . Gebruik de volgende criteria om de tekst op te geven die moet worden doorzocht:

  • Typ de tekst in een aanhalingstekenreeks en geef deze door naar Select-String.
  • Sla een tekenreeks op in een variabele en geef de variabele op als de waarde van de parameter InputObject .
  • Als de tekst is opgeslagen in bestanden, gebruikt u de parameter Path om het pad naar de bestanden op te geven.

Interpreteert standaard Select-String de waarde van de parameter Pattern als een reguliere expressie. Zie about_Regular_Expressions voor meer informatie. U kunt de parameter SimpleMatch gebruiken om de reguliere expressiekoppeling te overschrijven. Met de parameter SimpleMatch worden exemplaren gevonden van de waarde van de parameter Pattern in de invoer.

De standaarduitvoer van Select-String is een MatchInfo-object , dat gedetailleerde informatie over de overeenkomsten bevat. De informatie in het object is handig wanneer u naar tekst in bestanden zoekt, omdat MatchInfo-objecten eigenschappen hebben, zoals Bestandsnaam en Lijn. Wanneer de invoer niet afkomstig is uit het bestand, is de waarde van deze parameters InputStream.

Als u de informatie niet nodig hebt in het Object MatchInfo , gebruikt u de parameter Quiet . De parameter Quiet retourneert een Booleaanse waarde (Waar of Onwaar) om aan te geven of er een overeenkomst is gevonden in plaats van een MatchInfo-object .

Bij overeenkomende woordgroepen wordt Select-String de huidige cultuur gebruikt die is ingesteld voor het systeem. Gebruik de Get-Culture cmdlet om de huidige cultuur te vinden.

Als u de eigenschappen van een MatchInfo-object wilt zoeken, typt u de volgende opdracht:

Select-String -Path test.txt -Pattern 'test' | Get-Member | Format-List -Property *