Select-String

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

Cmdleten Select-String använder reguljär uttrycksmatchning för att söka efter textmönster i indatasträngar och filer. Du kan använda Select-String liknande grep i UNIX eller findstr.exe i Windows.

Select-String baseras på textrader. Som standard Select-String hittar du den första matchningen på varje rad och för varje matchning visas filnamnet, radnumret och all text på raden som innehåller matchningen. Du kan dirigera Select-String om du vill hitta flera matchningar per rad, visa text före och efter matchningen eller visa ett booleskt värde (sant eller falskt) som anger om en matchning hittas.

Select-String kan visa alla textmatchningar eller stoppa efter den första matchningen i varje indatafil. Select-String kan användas för att visa all text som inte matchar det angivna mönstret.

Du kan också ange att Select-String du bör förvänta dig en viss teckenkodning, till exempel när du söker i filer med Unicode-text. Select-String använder byte-order-mark (BOM) för att identifiera kodningsformatet för filen. Om filen inte har någon strukturlista förutsätter den att kodningen är UTF8.

Exempel

Exempel 1: Hitta en skiftlägeskänslig matchning

Det här exemplet matchar skiftlägeskänsligt texten som skickades ned i pipelinen till cmdleten Select-String .

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

Textsträngarna Hello och HELLO skickas ned i pipelinen till cmdleten Select-String . Select-String använder parametern Pattern för att ange HELLO. Parametern CaseSensitive anger att ärendet endast måste matcha versaler. SimpleMatch är en valfri parameter och anger att strängen i mönstret inte tolkas som ett reguljärt uttryck. Select-String visar HELLO i PowerShell-konsolen.

Exempel 2: Hitta matchningar i textfiler

Det här kommandot söker igenom alla filer med filnamnstillägget .txt i den aktuella katalogen. Utdata visar raderna i de filer som innehåller den angivna strängen.

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

I det här exemplet Get-Alias Get-Command och används med cmdleten Out-File för att skapa två textfiler i den aktuella katalogen, Alias.txt och Command.txt.

Select-String använder parametern Path med jokertecknet asterisk (*) för att söka i alla filer i den aktuella katalogen med filnamnstillägget .txt. Parametern Pattern anger den text som ska matcha Get-. Select-String visar utdata i PowerShell-konsolen. Filnamnet och radnumret föregår varje innehållsrad som innehåller en matchning för parametern Pattern .

Exempel 3: Hitta en mönstermatchning

I det här exemplet genomsöks flera filer för att hitta matchningar för det angivna mönstret. Mönstret använder en kvantifierare för reguljära uttryck. Mer information finns i about_Regular_Expressions.

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

Cmdleten Select-String använder två parametrar, Path och Pattern. Parametern Path använder variabeln $PSHOME som anger PowerShell-katalogen. Resten av sökvägen innehåller underkatalogen en-US och anger varje *.txt fil i katalogen. Parametern Pattern anger att det ska matcha ett frågetecken (?) i varje fil. Ett omvänt snedstreck (\) används som ett escape-tecken och är nödvändigt eftersom frågetecknet (?) är en kvantifierare för reguljära uttryck. Select-String visar utdata i PowerShell-konsolen. Filnamnet och radnumret föregår varje innehållsrad som innehåller en matchning för parametern Pattern .

Exempel 4: Använd Select-String i en funktion

Det här exemplet skapar en funktion för att söka efter ett mönster i PowerShell-hjälpfilerna. I det här exemplet finns funktionen bara i PowerShell-sessionen. När PowerShell-sessionen stängs tas funktionen bort. Mer information finns i about_Functions.

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

Funktionen skapas på PowerShell-kommandoraden. Kommandot Function använder namnet Search-Help. Tryck på Retur för att börja lägga till instruktioner i funktionen. Lägg till varje instruktion från prompten >> och tryck på Retur som du ser i exemplet. När den avslutande hakparentesen har lagts till returneras du till en PowerShell-prompt.

Funktionen innehåller två kommandon. Variabeln $PSHelp lagrar sökvägen till PowerShell-hjälpfilerna. $PSHOME är PowerShell-installationskatalogen med underkatalogen en-US som anger varje *.txt fil i katalogen.

Kommandot Select-String i funktionen använder parametrarna Sökväg och Mönster . Parametern Path använder variabeln $PSHelp för att hämta sökvägen. Parametern Pattern använder strängen About_ som sökvillkor.

Om du vill köra funktionen skriver du Search-Help. Funktionens Select-String kommando visar utdata i PowerShell-konsolen.

Exempel 5: Sök efter en sträng i en Windows-händelselogg

Det här exemplet söker efter en sträng i en Windows-händelselogg. Variabeln $_ representerar det aktuella objektet i pipelinen. Mer information finns i about_Automatic_Variables.

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

Cmdleten Get-WinEvent använder LogName-parametern för att ange programloggen. Parametern MaxEvents hämtar de 50 senaste händelserna från loggen. Logginnehållet lagras i variabeln med namnet $Events.

Variabeln $Events skickas ned i pipelinen till cmdleten Select-String . Select-String använder parametern InputObject . Variabeln $_ representerar det aktuella objektet och message är en egenskap för händelsen. Parametern Pattern anger strängen Misslyckades och söker efter matchningar i $_.message . Select-String visar utdata i PowerShell-konsolen.

Exempel 6: Hitta en sträng i underkataloger

Det här exemplet söker i en katalog och alla dess underkataloger efter en specifik textsträng.

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

Get-ChildItem använder parametern Path för att ange C:\Windows\System32*.txt. Parametern Recurse innehåller underkatalogerna. Objekten skickas ned i pipelinen till Select-String.

Select-String använder parametern Pattern och anger strängen Microsoft. Parametern CaseSensitive används för att matcha strängens exakta skiftläge. Select-String visar utdata i PowerShell-konsolen.

Exempel 7: Hitta strängar som inte matchar ett mönster

Det här exemplet visar hur du exkluderar datarader som inte matchar ett mönster.

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

Cmdleten Get-Command skickar objekt ned i pipelinen Out-File till för att skapa den Command.txt filen i den aktuella katalogen. Select-String använder parametern Sökväg för att ange filen Command.txt . Parametern Pattern anger Get och Set som sökmönster. Parametern NotMatch undantar Get och Set från resultatet. Select-String visar utdata i PowerShell-konsolen som inte innehåller Hämta eller Ange.

Exempel 8: Hitta rader före och efter en matchning

Det här exemplet visar hur du hämtar linjerna före och efter det matchade mönstret.

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

Cmdleten Get-Command skickar objekt ned i pipelinen Out-File till för att skapa den Command.txt filen i den aktuella katalogen. Select-String använder parametern Sökväg för att ange filen Command.txt . Parametern Pattern anger Get-Computer som sökmönster. Parametern Context använder två värden, före och efter, och markerar mönstermatchningar i utdata med en vinkelparentes (>). Parametern Context matar ut de två raderna före den första mönstermatchningen och tre rader efter den sista mönstermatchningen.

Exempel 9: Hitta alla mönstermatchningar

Det här exemplet visar hur parametern AllMatches hittar varje mönstermatchning i en textrad. Som standard Select-String hittar endast den första förekomsten av ett mönster i en textrad. I det här exemplet används objektegenskaper som finns med cmdleten Get-Member .

$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

Cmdleten Get-ChildItem använder parametern Path . Parametern Path använder variabeln $PSHOME som anger PowerShell-katalogen. Resten av sökvägen innehåller underkatalogen en-US och anger varje *.txt fil i katalogen. Objekten Get-ChildItem lagras i variabeln $A . Variabeln $A skickas ned i pipelinen till cmdleten Select-String . Select-String använder parametern Pattern för att söka i varje fil efter strängen PowerShell.

Från PowerShell-kommandoraden $A visas variabelinnehållet. Det finns en rad som innehåller två förekomster av strängen PowerShell.

Egenskapen $A.Matches visar den första förekomsten av mönstret PowerShell på varje rad.

Egenskapen $A.Matches.Length räknar den första förekomsten av mönstret PowerShell på varje rad.

Variabeln $B använder samma Get-ChildItem cmdletar och Select-String cmdletar, men lägger till parametern AllMatches . AllMatches hittar varje förekomst av mönstret PowerShell på varje rad. Objekten som lagras i variablerna $A och $B är identiska.

Egenskapen $B.Matches.Length ökar eftersom varje förekomst av mönstret PowerShell räknas för varje rad.

Exempel 10 – Konvertera pipelineobjekt till strängar med "Out-String"

Resultatet ToString() av piped-objektet är inte samma omfattande strängrepresentation som produceras av PowerShells formateringssystem. Så du kan behöva leda objekten till Out-String först.

Rördragning för att Out-String konvertera formaterade utdata till ett enda flerradssträngsobjekt. Det innebär att när Select-String en matchning hittas matar den ut hela flerradssträngen.

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

Rördragning för att Out-String -Stream konvertera formaterade utdata till flera enradssträngsobjekt. Det innebär att när Select-String en matchning hittas matas endast den matchande raden ut.

Parametrar

-AllMatches

-CaseSensitive

-Context

-Culture

-Encoding

-Exclude

-Include

-InputObject

-List

-LiteralPath

-NoEmphasis

-NotMatch

-Path

-Pattern

-Quiet

-Raw

-SimpleMatch

Indata

PSObject

Du kan skicka alla objekt som har en ToString() metod till den här cmdleten.

Utdata

MatchInfo

Som standard returnerar den här cmdleten ett MatchInfo-objekt för varje matchning som hittas.

Boolean

När du använder parametern Tyst returnerar den här cmdleten ett booleskt värde som anger om mönstret hittades.

String

När du använder raw-parametern returnerar den här cmdleten en uppsättning strängobjekt som matchar mönstret.

Kommentarer

PowerShell innehåller följande alias för Select-String:

• Alla plattformar:
  • sls

Select-String liknar grep i UNIX eller findstr.exe i Windows.

Aliaset sls för cmdleten Select-String introducerades i PowerShell 3.0.

När du rör objekt till Select-String:

• FileInfo-objekt behandlas som en sökväg till en fil. När du anger Select-String filsökvägar söker du igenom innehållet i filen, inte representationen ToString() av objektet.
• Resultatet ToString() av piped-objektet är inte samma omfattande strängrepresentation som produceras av PowerShells formateringssystem. Så du kan behöva leda objekten till Out-String först. Mer information finns i Exempel 10.

Om du vill använda Select-Stringskriver du den text som du vill hitta som värdet för parametern Pattern . Om du vill ange den text som ska sökas igenom använder du följande villkor:

• Skriv texten i en citerad sträng och skicka den sedan till Select-String.
• Lagra en textsträng i en variabel och ange sedan variabeln som värdet för parametern InputObject .
• Om texten lagras i filer använder du parametern Sökväg för att ange sökvägen till filerna.

Som standard Select-String tolkar värdet för parametern Pattern som ett reguljärt uttryck. Mer information finns i about_Regular_Expressions. Du kan använda parametern SimpleMatch för att åsidosätta matchningen av reguljära uttryck. Parametern SimpleMatch hittar instanser av värdet för parametern Pattern i indata.

Standardutdata för Select-String är ett MatchInfo-objekt , som innehåller detaljerad information om matchningarna. Informationen i objektet är användbar när du söker efter text i filer, eftersom MatchInfo-objekt har egenskaper som Filnamn och Rad. När indata inte kommer från filen är värdet för dessa parametrar InputStream.

Om du inte behöver informationen i MatchInfo-objektet använder du parametern Tyst . Parametern Quiet returnerar ett booleskt värde (sant eller falskt) för att ange om den hittade en matchning i stället för ett MatchInfo-objekt .

När du matchar fraser Select-String använder du den aktuella kultur som har angetts för systemet. Använd cmdleten för Get-Culture att hitta den aktuella kulturen.

Om du vill hitta egenskaperna för ett MatchInfo-objekt skriver du följande kommando:

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

Relaterade länkar

• about_Automatic_Variables
• about_Comparison_Operators
• about_Functions
• about_Quoting_Rules
• about_Regular_Expressions
• Get-Alias
• Get-ChildItem
• Get-Command
• Get-Member
• Get-WinEvent
• Out-File