Dela via

Select-String

  • Referens
Modul:
Microsoft.PowerShell.Utility

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

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.

Kommentar

Beroende på dina behörigheter kan du se Åtkomst nekad 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 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

Anger att cmdleten söker efter mer än en matchning i varje textrad. Utan den här parametern Select-String hittar du bara den första matchningen i varje textrad.

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

Kommentar

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 att undvika reguljära uttryck finns i about_Regular_Expressions .

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-CaseSensitive

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

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Context

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

Om du anger ett tal som värdet för den här parametern avgör det talet antalet rader som samlats in 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. Exempel: -Context 2,3

I standardvisningen indikeras rader med en matchning med höger vinkelparentes (>) (ASCII 62) i den första kolumnen i displayen. 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 efter texten på den matchade raden. Den matchade raden är värdet för egenskapen Line 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 i visningen.

Typ:Int32[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Culture

Anger ett kulturnamn som matchar det angivna mönstret. Parametern Kultur måste användas med parametern SimpleMatch . Standardbeteendet använder kulturen i det aktuella PowerShell-körningsutrymmet (session).

Om du vill hämta en lista över alla kulturer som stöds använder du Get-Culture -ListAvailable kommandot .

Dessutom accepterar den här parametern följande argument:

  • CurrentCulture, som är standard;
  • Ordningstal, det är icke-språklig binär jämförelse;
  • Invariant, det är kulturoberoende jämförelse.

Med Select-String -Culture Ordinal -CaseSensitive -SimpleMatch kommandot får du den snabbaste binära jämförelsen.

Parametern Kultur använder tabbavslut för att bläddra igenom listan med argument som anger tillgängliga kulturer. Om du vill visa en lista över alla tillgängliga argument använder du följande kommando:

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

Mer information om egenskapen .NET CultureInfo.Name finns i CultureInfo.Name.

Parametern Kultur introducerades i PowerShell 7.

Typ:String
Position:Named
Standardvärde:Culture of the current PowerShell session
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Encoding

Anger typen 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).
  • ansi: Använder kodningen för för den aktuella kulturens ANSI-kodsida. Det här alternativet lades till i PowerShell 7.4.
  • bigendianunicode: Kodar i UTF-16-format med hjälp av den stora byteordningen.
  • bigendianutf32: Kodar i UTF-32-format med hjälp av storslutsbyteordningen.
  • oem: Använder standardkodning för MS-DOS och konsolprogram.
  • unicode: Kodar i UTF-16-format med hjälp av den lite endianska byteordningen.
  • utf7: Kodar i UTF-7-format.
  • utf8: Kodar i UTF-8-format.
  • utf8BOM: Kodar i UTF-8-format med Byte Order Mark (BOM)
  • utf8NoBOM: Kodar i UTF-8-format utan Byte Order Mark (BOM)
  • utf32: Kodar i UTF-32-format.

Från och med PowerShell 6.2 tillåter kodningsparametern även numeriska ID:n 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.

Från och med PowerShell 7.4 kan du använda Ansi värdet för kodningsparametern för att skicka det numeriska ID:t för den aktuella kulturens ANSI-kodsida utan att behöva ange det manuellt.

Kommentar

UTF-7* rekommenderas inte längre att använda. Från och med PowerShell 7.1 skrivs en varning om du anger utf7 för kodningsparametern .

Typ:Encoding
Godkända värden:ASCII, BigEndianUnicode, BigEndianUTF32, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32
Position:Named
Standardvärde:UTF8NoBOM
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Exclude

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

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:True

-InputObject

Anger den text som ska sökas igenom. 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 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.

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.

Typ:PSObject
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken: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 över filer som har innehåll som matchar det reguljära uttrycket.

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

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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 med enkla citattecken. Enkla citattecken gör att PowerShell inte tolkar några tecken som escape-sekvenser. Mer information finns i about_Quoting_Rules.

Typ:String[]
Alias:PSPath, LP
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-NoEmphasis

Som standard Select-String markeras strängen som matchar det mönster som du sökte efter med parametern Mönster . Parametern NoEmphasis inaktiverar markeringen.

Betoningen använder negativa färger baserat på dina PowerShell-bakgrunds- och textfärger. Om dina PowerShell-färger till exempel är en svart bakgrund med vit text. Betoningen är en vit bakgrund med svart text.

Den här parametern introducerades i PowerShell 7.

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-NotMatch

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

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:String[]
Position:1
Standardvärde:Local directory
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:String[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Quiet

Anger att cmdleten returnerar ett enkelt svar i stället för ett MatchInfo-objekt . Det returnerade värdet är $true om mönstret hittas eller $null om mönstret inte hittas.

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Raw

Gör att cmdleten endast matar ut matchande strängar i stället för MatchInfo-objekt . Det här är resultatet av beteendet som mest liknar Unix grep - eller Windows-kommandona findstr.exe .

Den här parametern introducerades i PowerShell 7.

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SimpleMatch

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

När SimpleMatch används är dessutom matchningsegenskapen för det Returnerade MatchInfo-objektet tom.

Kommentar

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

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

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.

Kommentar

Enligt godkända verb för PowerShell-kommandon är scdet officiella aliasprefixet för Select-* cmdletar , inte sl. Därför bör rätt alias för Select-String vara scs, inte sls. Det här är ett undantag från den här regeln.

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 *