Dela via

Select-String

  • Referens
Modul:
Microsoft.PowerShell.Utility

Söker efter text i strängar och filer.

Syntax

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

Description

Cmdleten Select-String söker efter text- och 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 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 till att 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 använder matchning av reguljära uttryck, men kan också utföra en matchning som söker efter den text som du anger.

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 filens kodningsformat. Om filen inte har någon BOM förutsätter den att kodningen är UTF8.

Exempel

Exempel 1: Hitta en skiftlägeskänslig matchning

Det här exemplet gör en skiftlägeskänslig matchning av 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åt i pipelinen till cmdletenSelect-String. Select-String använder parametern Pattern för att ange HELLO. Parametern CaseSensitive anger att skiftläget 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 används och Get-Command med cmdleten Out-File för att skapa två textfiler i den aktuella katalogen ,Alias.txt och Command.txt.

Select-Stringanvänder sökvägsparametern 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 den ska matcha ett frågetecken (?) i varje fil. Ett omvänt snedstreck (\) används som 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.

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

PS> Search-Help

C:\Program Files\PowerShell\6\en-US\default.help.txt:67:    The titles of conceptual topics begin with "About_".
C:\Program Files\PowerShell\6\en-US\default.help.txt:70:    Get-Help About_<topic-name>
C:\Program Files\PowerShell\6\en-US\default.help.txt:93:    Get-Help About_Modules : Displays help about PowerShell modules.
C:\Program Files\PowerShell\6\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 enligt exemplet. När den avslutande hakparentesen har lagts till återgår 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 Path och Pattern . 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: Search för 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åt 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 artar strängen Failed (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åt 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.

Anteckning

Beroende på dina behörigheter kan du se Åtkomst nekade meddelanden i utdata.

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åt i pipelinen till Out-File för att skapa denCommand.txt filen i den aktuella katalogen. Select-String använder parametern Path för att ange denCommand.txt filen. Parametern Pattern anger Get och Set som sökmönster. Parametern NotMatch utesluter 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 raderna 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åt i pipelinen till Out-File för att skapa denCommand.txt filen i den aktuella katalogen. Select-String använder parametern Path för att ange denCommand.txt filen. 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 .

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

PS> $A

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

PS> $A.Matches

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

PS> $A.Matches.Length

8

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

PS> $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åt 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 visas variabelinnehållet $A . 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 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.

Parametrar

-AllMatches

Anger att cmdleten söker efter fler än en matchning på varje textrad. Utan den här parametern Select-String hittar endast den första matchningen på varje textrad.

När Select-String hittar fler än en matchning i en textrad genererar den fortfarande bara ett MatchInfo-objekt för raden, men objektets matchningsegenskap innehåller alla matchningar.

Anteckning

Den här parametern ignoreras när den används i kombination med parametern SimpleMatch . Om du vill returnera alla matchningar och det mönster som du söker efter innehåller reguljära uttryckstecken måste du undvika dessa tecken i stället för att använda SimpleMatch. Mer information om undantag från reguljära uttryck finns i about_Regular_Expressions .

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

-CaseSensitive

Anger att cmdlet-matchningarna är skiftlägeskänsliga. Matchningar är som standard inte skiftlägeskänsliga.

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

-Context

Samlar in det angivna antalet rader före och efter den rad som matchar mönstret.

Om du anger ett tal som värde för den här parametern avgör talet antalet rader som registrerats före och efter matchningen. Om du anger två tal som värde avgör det första talet antalet rader före matchningen och det andra talet avgör antalet rader efter matchningen. Till exempel -Context 2,3.

På standardskärmen indikeras rader med en matchning med en höger vinkelparentes (>) (ASCII 62) i den första kolumnen på skärmen. Omarkerade rader är kontexten.

Parametern Context ändrar inte antalet objekt som genereras av Select-String. Select-String genererar ett MatchInfo-objekt för varje matchning. Kontexten lagras som en matris med strängar i objektets kontextegenskap .

När utdata från ett Select-String kommando skickas nedåt i pipelinen till ett annat Select-String kommando söker det mottagande kommandot bara igenom texten på den matchade raden. Den matchade raden är värdet för egenskapen Rad för MatchInfo-objektet , inte texten i kontextraderna. Därför är parametern Context inte giltig för det mottagande Select-String kommandot.

När kontexten innehåller en matchning innehåller MatchInfo-objektet för varje matchning alla kontextrader, men de överlappande raderna visas bara en gång på skärmen.

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

-Encoding

Anger typ av kodning för målfilen. Standardvärdet är utf8NoBOM.

Godkända värden för den här parametern är följande:

  • ascii: Använder kodningen för ASCII-teckenuppsättningen (7-bitars).
  • bigendianunicode: Kodar i UTF-16-format med hjälp av den stora byteordningen.
  • oem: Använder standardkodning för MS-DOS och konsolprogram.
  • unicode: Kodar i UTF-16-format med den little-endianska byteordningen.
  • utf7: Kodar i UTF-7-format.
  • utf8: Kodar i UTF-8-format.
  • utf8BOM: Kodar i UTF-8-format med BOM (Byte Order Mark)
  • utf8NoBOM: Kodar i UTF-8-format utan bom (Byte Order Mark)
  • utf32: Kodar i UTF-32-format.

Från och med PowerShell 6.2 tillåter kodningsparametern även numeriska ID:er för registrerade kodsidor (till exempel -Encoding 1251) eller strängnamn för registrerade kodsidor (till exempel -Encoding "windows-1251"). Mer information finns i .NET-dokumentationen för Encoding.CodePage.

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

-Exclude

Undanta de angivna objekten. Värdet för den här parametern kvalificerar parametern Path . Ange ett sökvägselement eller mönster, till exempel *.txt. Jokertecken tillåts.

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

-Include

Innehåller de angivna objekten. Värdet för den här parametern kvalificerar parametern Path . Ange ett sökvägselement eller mönster, till exempel *.txt. Jokertecken tillåts.

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

-InputObject

Anger den text som ska genomsökas. Ange en variabel som innehåller texten eller skriv ett kommando eller uttryck som hämtar texten.

Att använda parametern InputObject är inte detsamma som att skicka strängar nedåt i pipelinen till Select-String.

När du skickar fler än en sträng till cmdleten söker den Select-String efter den angivna texten i varje sträng och returnerar varje sträng som innehåller söktexten.

När du använder parametern InputObject för att skicka en samling strängar behandlar Select-String samlingen som en enda kombinerad sträng. Select-String returnerar strängarna som en enhet om den hittar söktexten i en sträng.

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

-List

Endast den första instansen av matchande text returneras från varje indatafil. Det här är det mest effektiva sättet att hämta en lista med filer med innehåll som matchar det reguljära uttrycket.

Som standard Select-String returnerar ett MatchInfo-objekt för varje matchning som hittas.

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

-LiteralPath

Anger sökvägen till de filer som ska sökas igenom. Värdet för parametern LiteralPath används exakt som det skrivs. Inga tecken tolkas som jokertecken. Om sökvägen innehåller escape-tecken omger du den inom enkla citattecken. Enkla citattecken säger till PowerShell att inte tolka några tecken som escape-sekvenser. Mer information finns i about_Quoting_Rules.

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

-NotMatch

Parametern NotMatch hittar text som inte matchar det angivna mönstret.

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

-Path

Anger sökvägen till filerna som ska sökas. Jokertecken tillåts. Standardplatsen är den lokala katalogen.

Ange filer i katalogen, till exempel log1.txt, *.doceller *.*. Om du bara anger en katalog misslyckas kommandot.

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

-Pattern

Anger den text som ska hittas på varje rad. Mönstervärdet behandlas som ett reguljärt uttryck.

Mer information om reguljära uttryck finns i about_Regular_Expressions.

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

-Quiet

Anger att cmdleten returnerar ett booleskt värde (sant eller falskt) i stället för ett MatchInfo-objekt . Värdet är Sant om mönstret hittas. annars är värdet Falskt.

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

-SimpleMatch

Anger att cmdleten använder en enkel matchning snarare än en reguljär uttrycksmatchning. I en enkel matchning Select-String söker du efter indata för texten i parametern Pattern . Värdet för parametern Pattern tolkas inte som ett reguljärt uttryck.

När SimpleMatch används är egenskapen Matches för det Returnerade MatchInfo-objektet tom.

Anteckning

När den här parametern används med parametern AllMatches ignoreras AllMatches .

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

Indata

PSObject

Du kan skicka alla objekt som har en ToString-metod till Select-String.

Utdata

Microsoft.PowerShell.Commands.MatchInfo or System.Boolean

Som standard är utdata en uppsättning MatchInfo-objekt med en för varje matchning som hittas. Om du använder parametern Quiet är utdata ett booleskt värde som anger om mönstret hittades.

Kommentarer

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

Sls-aliaset för cmdleten Select-String introducerades i PowerShell 3.0.

Anteckning

Enligt Approved Verbs for PowerShell Commands (Godkända verb för PowerShell-kommandon) är scdet officiella aliasprefixet för Select-* cmdletar , inte sl. Därför ska rätt alias för Select-String vara scs, inte sls. Det här är ett undantag till den här regeln.

Om du vill använda Select-Stringskriver du den text som du vill hitta som värde för parametern Pattern . Använd följande villkor för att ange vilken text som ska genomsökas:

  • 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 Select-String för ä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 Quiet . Parametern Quiet returnerar ett booleskt värde (Sant eller Falskt) som anger om den hittade en matchning i stället för ett MatchInfo-objekt .

När du matchar fraser Select-String använder den aktuella kulturen 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 *