Select-String

Syntax

Select-String
      [-Pattern] <String[]>
      [-Path] <String[]>
      [-SimpleMatch]
      [-CaseSensitive]
      [-Quiet]
      [-List]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-NotMatch]
      [-AllMatches]
      [-Encoding <String>]
      [-Context <Int32[]>]
      [<CommonParameters>]

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

Select-String
      [-Pattern] <String[]>
      -LiteralPath <String[]>
      [-SimpleMatch]
      [-CaseSensitive]
      [-Quiet]
      [-List]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-NotMatch]
      [-AllMatches]
      [-Encoding <String>]
      [-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:\Windows\System32\WindowsPowerShell\v1.0\en-US\about_ActivityCommonParameters.help.txt:2:   about_ActivityCommonParameters
C:\Windows\System32\WindowsPowerShell\v1.0\en-US\about_ActivityCommonParameters.help.txt:31:  see about_WorkflowCommonParameters.
C:\Windows\System32\WindowsPowerShell\v1.0\en-US\about_ActivityCommonParameters.help.txt:33:  about_CommonParameters.

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:1186:Cmdlet          Get-CmsMessage            3.0.0.0    Microsoft.PowerShell.Security
  Command.txt:1187:Cmdlet          Get-Command               3.0.0.0    Microsoft.PowerShell.Core
> Command.txt:1188:Cmdlet          Get-ComputerInfo          3.1.0.0    Microsoft.PowerShell.Management
> Command.txt:1189:Cmdlet          Get-ComputerRestorePoint  3.1.0.0    Microsoft.PowerShell.Management
  Command.txt:1190:Cmdlet          Get-Content               3.1.0.0    Microsoft.PowerShell.Management
  Command.txt:1191:Cmdlet          Get-ControlPanelItem      3.1.0.0    Microsoft.PowerShell.Management
  Command.txt:1192:Cmdlet          Get-Counter               3.0.0.0    Microsoft.PowerShell.Diagnostics

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:\Windows\System32\WindowsPowerShell\v1.0\en-US\about_ActivityCommonParameters.help.txt:5:    Describes the parameters that Windows PowerShell
C:\Windows\System32\WindowsPowerShell\v1.0\en-US\about_ActivityCommonParameters.help.txt:9:    Windows PowerShell Workflow adds the activity common

$A.Matches

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

$A.Matches.Length

2073

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

2200

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

-Encoding

-Exclude

-Include

-InputObject

-List

-LiteralPath

-NotMatch

-Path

-Pattern

-Quiet

-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.

Kommentarer

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

• sls

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

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