Select-String
Sucht nach Text in Dateien und Zeichenfolgen.
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>]
Beschreibung
Das Select-String
Cmdlet sucht in Eingabezeichenfolgen und Dateien nach Text- und Textmustern. Sie können grep in UNIX oder findstr.exe in Windows verwendenSelect-String
.
Select-String
basiert auf Textzeilen. Sucht standardmäßig Select-String
die erste Übereinstimmung in jeder Zeile und zeigt für jede Übereinstimmung den Dateinamen, die Zeilennummer und den gesamten Text in der Zeile an, die die Übereinstimmung enthält. Sie können mehrere Select-String
Übereinstimmungen pro Zeile suchen, Text vor und nach der Übereinstimmung anzeigen oder einen booleschen Wert (True oder False) anzeigen, der angibt, ob eine Übereinstimmung gefunden wird.
Select-String
verwendet den Abgleich regulärer Ausdrücke, kann aber auch eine Übereinstimmung durchführen, die die Eingabe nach dem von Ihnen angegebenen Text durchsucht.
Select-String
kann alle Text-Übereinstimmungen anzeigen oder nach der ersten Übereinstimmung in jeder Eingabedatei beenden.
Select-String
kann verwendet werden, um den gesamten Text anzuzeigen, der nicht dem angegebenen Muster entspricht.
Sie können auch angeben, dass Select-String
eine bestimmte Zeichencodierung erwartet werden soll, z. B. beim Durchsuchen von Unicode-Textdateien. Select-String
verwendet die Bytereihenfolgemarkierung (BOM), um das Codierungsformat der Datei zu erkennen. Wenn die Datei keine BOM enthält, wird davon ausgegangen, dass die Codierung UTF8 ist.
Beispiele
Beispiel 1: Suchen einer Übereinstimmung zwischen Groß- und Kleinschreibung
In diesem Beispiel wird eine Übereinstimmung zwischen Groß- und Kleinschreibung des Texts ausgeführt, der in der Pipeline an das Select-String
Cmdlet gesendet wurde.
'Hello', 'HELLO' | Select-String -Pattern 'HELLO' -CaseSensitive -SimpleMatch
Die Textzeichenfolgen Hello und HELLO werden in der Pipeline an das Select-String
Cmdlet gesendet.
Select-String
verwendet den Pattern-Parameter , um HELLO anzugeben. Der Parameter CaseSensitive gibt an, dass die Groß-/Kleinschreibung nur dem Großbuchstabenmuster entsprechen darf. SimpleMatch ist ein optionaler Parameter und gibt an, dass die Zeichenfolge im Muster nicht als regulärer Ausdruck interpretiert wird.
Select-String
zeigt HELLO in der PowerShell-Konsole an.
Beispiel 2: Suchen von Übereinstimmungen in Textdateien
Dieser Befehl durchsucht alle Dateien mit der .txt
Dateinamenerweiterung im aktuellen Verzeichnis. Die Ausgabe zeigt die Zeilen in den Dateien an, die die angegebene Zeichenfolge enthalten.
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 diesem Beispiel werden und Get-Command
mit dem Out-File
Cmdlet verwendet, Get-Alias
um zwei Textdateien im aktuellen Verzeichnis zu erstellen, Alias.txt und Command.txt.
Select-String
verwendet den Path-Parameter mit dem Sternchen (*
) platzhalter, um alle Dateien im aktuellen Verzeichnis mit der Dateinamenerweiterung .txt
zu durchsuchen. Der Parameter Pattern gibt den Text an, der get-. Select-String
zeigt die Ausgabe in der PowerShell-Konsole an. Der Dateiname und die Zeilennummer gehen jeder Inhaltszeile voran, die eine Übereinstimmung für den Pattern-Parameter enthält.
Beispiel 3: Suchen einer Mustervergleichung
In diesem Beispiel werden mehrere Dateien durchsucht, um Übereinstimmungen für das angegebene Muster zu finden. Das Muster verwendet einen Quantifizierer für reguläre Ausdrücke. Weitere Informationen finden Sie unter 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
Das Select-String
Cmdlet verwendet zwei Parameter: Path und Pattern. Der Path-Parameter verwendet die Variable $PSHOME
, die das PowerShell-Verzeichnis angibt. Der rest des Pfads enthält das Unterverzeichnis en-US und gibt jede *.txt
Datei im Verzeichnis an. Der Parameter Pattern gibt an, dass in jeder Datei ein Fragezeichen (?
) zugeordnet werden soll. Ein umgekehrter Schrägstrich (\
) wird als Escapezeichen verwendet und ist erforderlich, da das Fragezeichen (?
) ein Quantifizierer für reguläre Ausdrücke ist. Select-String
zeigt die Ausgabe in der PowerShell-Konsole an. Der Dateiname und die Zeilennummer gehen jeder Inhaltszeile voran, die eine Übereinstimmung für den Pattern-Parameter enthält.
Beispiel 4: Verwenden von Select-String in einer Funktion
In diesem Beispiel wird eine Funktion zum Suchen nach einem Muster in den PowerShell-Hilfedateien erstellt. In diesem Beispiel ist die Funktion nur in der PowerShell-Sitzung vorhanden. Wenn die PowerShell-Sitzung geschlossen wird, wird die Funktion gelöscht. Weitere Informationen finden Sie unter 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
Die Funktion wird in der PowerShell-Befehlszeile erstellt. Der Function
Befehl verwendet den Namen Search-Help. Drücken Sie die EINGABETASTE , um mit dem Hinzufügen von Anweisungen zur Funktion zu beginnen. Fügen Sie an der >>
Eingabeaufforderung jede Anweisung hinzu, und drücken Sie die EINGABETASTE , wie im Beispiel gezeigt. Nachdem die schließende Klammer hinzugefügt wurde, werden Sie zu einer PowerShell-Eingabeaufforderung zurückgegeben.
Die Funktion enthält zwei Befehle. Die $PSHelp
Variable speichert den Pfad zu den PowerShell-Hilfedateien. $PSHOME
ist das PowerShell-Installationsverzeichnis mit dem Unterverzeichnis en-US , das jede *.txt
Datei im Verzeichnis angibt.
Der Select-String
Befehl in der Funktion verwendet die Parameter Path und Pattern . Der Path-Parameter verwendet die $PSHelp
Variable, um den Pfad abzurufen. Der Parameter Pattern verwendet die Zeichenfolge About_ als Suchkriterium.
Geben Sie zum Ausführen der Funktion ein Search-Help
. Der Befehl der Select-String
Funktion zeigt die Ausgabe in der PowerShell-Konsole an.
Beispiel 5: Search für eine Zeichenfolge in einem Windows-Ereignisprotokoll
In diesem Beispiel wird in einem Windows-Ereignisprotokoll nach einer Zeichenfolge gesucht. Die Variable $_
stellt das aktuelle Objekt in der Pipeline dar. Weitere Informationen finden Sie unter about_Automatic_Variables.
$Events = Get-WinEvent -LogName Application -MaxEvents 50
$Events | Select-String -InputObject {$_.message} -Pattern 'Failed'
Das Get-WinEvent
Cmdlet verwendet den LogName-Parameter , um das Anwendungsprotokoll anzugeben. Der Parameter MaxEvents ruft die 50 letzten Ereignisse aus dem Protokoll ab. Der Protokollinhalt wird in der Variablen mit dem Namen $Events
gespeichert.
Die $Events
Variable wird in der Pipeline an das Select-String
Cmdlet gesendet. Select-String
verwendet den InputObject-Parameter . Die $_
Variable stellt das aktuelle Objekt dar und message
ist eine Eigenschaft des Ereignisses. Der Pattern-Parameter gibt die Zeichenfolge Failed ab und sucht in $_.message
nach Übereinstimmungen. Select-String
zeigt die Ausgabe in der PowerShell-Konsole an.
Beispiel 6: Suchen einer Zeichenfolge in Unterverzeichnissen
In diesem Beispiel wird ein Verzeichnis und alle zugehörigen Unterverzeichnisse nach einer bestimmten Textzeichenfolge durchsucht.
Get-ChildItem -Path C:\Windows\System32\*.txt -Recurse | Select-String -Pattern 'Microsoft' -CaseSensitive
Get-ChildItem
verwendet den Path-Parameter , um C:\Windows\System32*.txtanzugeben. Der Recurse-Parameter enthält die Unterverzeichnisse. Die -Objekte werden in der Pipeline an Select-String
gesendet.
Select-String
verwendet den Pattern-Parameter und gibt die Zeichenfolge Microsoft an. Der CaseSensitive-Parameter wird verwendet, um die genaue Groß-/Kleinschreibung der Zeichenfolge abzugleichen. Select-String
zeigt die Ausgabe in der PowerShell-Konsole an.
Hinweis
Abhängig von Ihren Berechtigungen werden in der Ausgabe möglicherweise Nachrichten vom Typ Access verweigert angezeigt .
Beispiel 7: Suchen nach Zeichenfolgen, die keinem Muster entsprechen
In diesem Beispiel wird gezeigt, wie Datenzeilen ausgeschlossen werden, die nicht einem Muster entsprechen.
Get-Command | Out-File -FilePath .\Command.txt
Select-String -Path .\Command.txt -Pattern 'Get', 'Set' -NotMatch
Das Get-Command
Cmdlet sendet Objekte an die Pipeline, um Out-File
die Command.txt-Datei im aktuellen Verzeichnis zu erstellen. Select-String
verwendet den Path-Parameter , um die Command.txt-Datei anzugeben. Der Parameter Pattern gibt Get und Set als Suchmuster an. Der Parameter NotMatch schließt Get und Set aus den Ergebnissen aus.
Select-String
zeigt die Ausgabe in der PowerShell-Konsole an, die Get oder Set nicht enthält.
Beispiel 8: Suchen von Zeilen vor und nach einer Übereinstimmung
In diesem Beispiel wird gezeigt, wie Die Zeilen vor und nach dem übereinstimmenden Muster abgerufen werden.
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
Das Get-Command
Cmdlet sendet Objekte an die Pipeline, um Out-File
die Command.txt-Datei im aktuellen Verzeichnis zu erstellen. Select-String
verwendet den Path-Parameter , um die Command.txt-Datei anzugeben. Der Parameter Pattern gibt Get-Computer als Suchmuster an. Der Context-Parameter verwendet zwei Werte , vorher und nachher, und markiert Mustervergleiche in der Ausgabe mit einer spitzen Klammer (>
). Der Context-Parameter gibt die beiden Zeilen vor der ersten Mustervergleichung und drei Zeilen nach der letzten Mustervergleichung aus.
Beispiel 9: Suchen aller Mustervergleiche
In diesem Beispiel wird gezeigt, wie der AllMatches-Parameter jede Musterübereinstimmung in einer Textzeile findet. Sucht standardmäßig Select-String
nur das erste Vorkommen eines Musters in einer Textzeile. In diesem Beispiel werden Objekteigenschaften verwendet, die mit dem Get-Member
Cmdlet gefunden werden.
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
Das Get-ChildItem
Cmdlet verwendet den Path-Parameter . Der Path-Parameter verwendet die Variable $PSHOME
, die das PowerShell-Verzeichnis angibt. Der rest des Pfads enthält das Unterverzeichnis en-US und gibt jede *.txt
Datei im Verzeichnis an. Die Get-ChildItem
Objekte werden in der $A
Variablen gespeichert. Die $A
Variable wird in der Pipeline an das Select-String
Cmdlet gesendet. Select-String
verwendet den Pattern-Parameter , um jede Datei nach der Zeichenfolge PowerShell zu durchsuchen.
In der PowerShell-Befehlszeile werden die $A
Variableninhalte angezeigt. Es gibt eine Zeile, die zwei Vorkommen der Zeichenfolge PowerShell enthält.
Die $A.Matches
-Eigenschaft listet das erste Vorkommen des Musters PowerShell in jeder Zeile auf.
Die $A.Matches.Length
-Eigenschaft zählt das erste Vorkommen des Musters PowerShell in jeder Zeile.
Die $B
Variable verwendet dieselben Get-ChildItem
Cmdlets und Select-String
, fügt jedoch den Parameter AllMatches hinzu. AllMatches findet jedes Vorkommen des Musters PowerShell in jeder Zeile. Die in den $A
Variablen und $B
gespeicherten Objekte sind identisch.
Die $B.Matches.Length
Eigenschaft wird erhöht, da für jede Zeile jedes Vorkommen des Musters PowerShell gezählt wird.
Parameter
-AllMatches
Gibt an, dass das Cmdlet nach mehr als einer Übereinstimmung in jeder Textzeile sucht. Ohne diesen Parameter Select-String
findet nur die erste Übereinstimmung in jeder Textzeile.
Wenn Select-String
mehr als eine Übereinstimmung in einer Textzeile gefunden wird, gibt sie immer noch nur ein MatchInfo-Objekt für die Zeile aus, aber die Matches-Eigenschaft des Objekts enthält alle Übereinstimmungen.
Hinweis
Dieser Parameter wird ignoriert, wenn er in Kombination mit dem SimpleMatch-Parameter verwendet wird. Wenn Sie alle Übereinstimmungen zurückgeben möchten und das gesuchte Muster reguläre Ausdruckszeichen enthält, müssen Sie diese Zeichen mit escapen statt SimpleMatch verwenden. Weitere Informationen zum Entfernen regulärer Ausdrücke finden Sie unter about_Regular_Expressions .
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CaseSensitive
Gibt an, dass beim Cmdlet die Groß-/Kleinschreibung beachtet wird. Standardmäßig wird bei Übereinstimmungen die Groß-/Kleinschreibung nicht beachtet.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Context
Erfasst die angegebene Anzahl von Zeilen vor und nach der Zeile, die dem Muster entspricht.
Wenn Sie eine Zahl als Wert dieses Parameters eingeben, bestimmt diese Zahl die Anzahl der vor und nach der Übereinstimmung erfassten Zeilen. Wenn Sie zwei Zahlen als Wert eingeben, bestimmt die erste Zahl die Anzahl der Zeilen vor der Übereinstimmung und die zweite Zahl die Anzahl der Zeilen nach der Übereinstimmung. Beispiel: -Context 2,3
.
In der Standardanzeige werden Zeilen mit einer Übereinstimmung durch eine rechtwinklibe Klammer () (>
ASCII 62) in der ersten Spalte der Anzeige angezeigt. Nicht gekennzeichnete Zeilen stehen für Kontext.
Der Context-Parameter ändert nicht die Anzahl der von generierten Select-String
Objekte.
Select-String
generiert ein MatchInfo-Objekt für jede Übereinstimmung. Der Kontext wird als Array von Zeichenfolgen in der Context-Eigenschaft des -Objekts gespeichert.
Wenn die Ausgabe eines Select-String
Befehls über die Pipeline an einen anderen Select-String
Befehl gesendet wird, durchsucht der empfangende Befehl nur den Text in der übereinstimmenden Zeile. Die übereinstimmene Zeile ist der Wert der Line-Eigenschaft des MatchInfo-Objekts , nicht der Text in den Kontextzeilen. Daher ist der Context-Parameter für den empfangenden Select-String
Befehl ungültig.
Wenn der Kontext eine Übereinstimmung enthält, enthält das MatchInfo-Objekt für jede Übereinstimmung alle Kontextzeilen, aber die sich überlappenden Zeilen werden nur einmal in der Anzeige angezeigt.
Type: | Int32[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Encoding
Gibt den Typ der Codierung für die Zieldatei an. Standardwert: utf8NoBOM
.
Die zulässigen Werte für diesen Parameter sind wie folgt:
ascii
: Verwendet die Codierung für den ASCII-Zeichensatz (7-Bit).bigendianunicode
: Codiert im UTF-16-Format mit der Big-Endian-Bytereihenfolge.oem
: Verwendet die Standardcodierung für MS-DOS- und Konsolenprogramme.unicode
: Codiert im UTF-16-Format mit der Bytereihenfolge little-endian.utf7
: Codiert im UTF-7-Format.utf8
: Codiert im UTF-8-Format.utf8BOM
: Codiert im UTF-8-Format mit Byte Order Mark (BOM)utf8NoBOM
: Codiert im UTF-8-Format ohne Byte Order Mark (BOM)utf32
: Codiert im UTF-32-Format.
Ab PowerShell 6.2 lässt der Codierungsparameter auch numerische IDs registrierter Codeseiten (z. B -Encoding 1251
. ) oder Zeichenfolgennamen registrierter Codeseiten (z. B -Encoding "windows-1251"
. ) zu. Weitere Informationen finden Sie in der .NET-Dokumentation 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
Schließen Sie die angegebenen Elemente aus. Der Wert dieses Parameters qualifiziert den Path-Parameter. Geben Sie ein Pfadelement oder -muster ein, z. B *.txt
. . Platzhalter sind zulässig.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Include
Schließt die angegebenen Elemente ein. Der Wert dieses Parameters qualifiziert den Path-Parameter. Geben Sie ein Pfadelement oder -muster ein, z. B *.txt
. . Platzhalter sind zulässig.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-InputObject
Gibt den zu durchsuchenden Text an. Geben Sie eine Variable ein, die den Text enthält, oder geben Sie einen Befehl oder Ausdruck ein, der den Text abruft.
Die Verwendung des InputObject-Parameters ist nicht mit dem Senden von Zeichenfolgen an die Pipeline identisch Select-String
.
Wenn Sie mehrere Zeichenfolgen an das Select-String
Cmdlet übergeben, sucht es nach dem angegebenen Text in jeder Zeichenfolge und gibt jede Zeichenfolge zurück, die den Suchtext enthält.
Wenn Sie den InputObject-Parameter verwenden, um eine Auflistung von Zeichenfolgen zu übermitteln, Select-String
behandelt die Auflistung als eine einzelne kombinierte Zeichenfolge. Select-String
gibt die Zeichenfolgen als Einheit zurück, wenn der Suchtext in einer beliebigen Zeichenfolge gefunden wird.
Type: | PSObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-List
Aus jeder Eingabedatei wird nur der erste instance übereinstimmenden Text zurückgegeben. Dies ist die effizienteste Methode zum Abrufen einer Liste von Dateien, deren Inhalt dem regulären Ausdruck entspricht.
Standardmäßig gibt für jede gefundene Select-String
Übereinstimmung ein MatchInfo-Objekt zurück.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LiteralPath
Gibt den Pfad zu den Dateien an, die durchsucht werden sollen. Der Wert des LiteralPath-Parameters wird genau so verwendet, wie er eingegeben wird. Es werden keine Zeichen als Platzhalter interpretiert. Wenn der Pfad Escapezeichen enthält, müssen Sie ihn in einfache Anführungszeichen einschließen. Einfache Anführungszeichen weisen PowerShell an, keine Zeichen als Escapesequenzen zu interpretieren. Weitere Informationen finden Sie unter about_Quoting_Rules.
Type: | String[] |
Aliases: | PSPath, LP |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NotMatch
Der Parameter NotMatch findet Text, der nicht dem angegebenen Muster entspricht.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Gibt den Pfad zu den zu durchsuchenden Dateien an. Platzhalter sind zulässig. Der Standardspeicherort ist das lokale Verzeichnis.
Geben Sie Dateien im Verzeichnis an, z log1.txt
. B. , *.doc
oder *.*
. Wenn Sie nur das Verzeichnis angeben, führt der Befehl zu einem Fehler.
Type: | String[] |
Position: | 1 |
Default value: | Local directory |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Pattern
Gibt den Text an, der in jeder Zeile gesucht werden soll. Der Musterwert wird als regulärer Ausdruck behandelt.
Weitere Informationen zu regulären Ausdrücken finden Sie unter about_Regular_Expressions.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Quiet
Gibt an, dass das Cmdlet anstelle eines MatchInfo-Objekts einen booleschen Wert (True oder False) zurückgibt. Der Wert ist True, wenn das Muster gefunden wird. Andernfalls ist der Wert False.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SimpleMatch
Gibt an, dass das Cmdlet eine einfache Übereinstimmung anstelle einer Übereinstimmung mit regulären Ausdrücken verwendet. In einer einfachen Übereinstimmung Select-String
durchsucht die Eingabe nach dem Text im Pattern-Parameter . Der Wert des Pattern-Parameters wird nicht als Anweisung für reguläre Ausdrücke interpretiert.
Außerdem ist bei Verwendung von SimpleMatch die Matches-Eigenschaft des zurückgegebenen MatchInfo-Objekts leer.
Hinweis
Wenn dieser Parameter mit dem AllMatches-Parameter verwendet wird, wird allMatches ignoriert.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
Sie können jedes Objekt, das über eine ToString-Methode verfügt, an übergeben Select-String
.
Ausgaben
Microsoft.PowerShell.Commands.MatchInfo or System.Boolean
Standardmäßig ist die Ausgabe eine Gruppe von MatchInfo-Objekten mit einem für jede gefundene Übereinstimmung. Wenn Sie den Quiet-Parameter verwenden, ist die Ausgabe ein boolescher Wert, der angibt, ob das Muster gefunden wurde.
Hinweise
Select-String
ähnelt grep unter UNIX oder findstr.exe unter Windows.
Der sls-Alias für das Select-String
Cmdlet wurde in PowerShell 3.0 eingeführt.
Hinweis
Gemäß genehmigten Verben für PowerShell-Befehle ist sc
das offizielle Aliaspräfix für Select-*
Cmdlets , nicht sl
. Daher sollte der richtige Alias für Select-String
nicht seinscs
sls
. Dies ist eine Ausnahme von dieser Regel.
Um zu verwenden Select-String
, geben Sie den Text ein, den Sie als Wert des Pattern-Parameters suchen möchten. Verwenden Sie die folgenden Kriterien, um den zu durchsuchenden Text anzugeben:
- Geben Sie den Text in eine Anführungszeichenzeichenfolge ein, und leiten Sie ihn
Select-String
an . - Speichern Sie eine Textzeichenfolge in einer Variablen, und geben Sie dann die Variable als Wert des InputObject-Parameters an .
- Wenn der Text in Dateien gespeichert ist, verwenden Sie den Path-Parameter , um den Pfad zu den Dateien anzugeben.
Interpretiert standardmäßig Select-String
den Wert des Pattern-Parameters als regulären Ausdruck. Weitere Informationen finden Sie unter about_Regular_Expressions. Sie können den SimpleMatch-Parameter verwenden, um den Regulären Ausdrucksabgleich außer Kraft zu setzen. Der SimpleMatch-Parameter findet Instanzen des Werts des Pattern-Parameters in der Eingabe.
Die Standardausgabe von Select-String
ist ein MatchInfo-Objekt , das detaillierte Informationen zu den Übereinstimmungen enthält. Die Informationen im -Objekt sind nützlich, wenn Sie nach Text in Dateien suchen, da MatchInfo-Objekte Eigenschaften wie Filename und Line aufweisen. Wenn die Eingabe nicht aus der Datei stammt, ist der Wert dieser Parameter InputStream.
Wenn Sie die Informationen im MatchInfo-Objekt nicht benötigen, verwenden Sie den Parameter Quiet . Der Quiet-Parameter gibt einen booleschen Wert (True oder False) zurück, um anzugeben, ob anstelle eines MatchInfo-Objekts eine Übereinstimmung gefunden wurde.
Verwendet beim Abgleich von Ausdrücken Select-String
die aktuelle Kultur, die für das System festgelegt ist. Verwenden Sie das Cmdlet, um die Get-Culture
aktuelle Kultur zu finden.
Geben Sie den folgenden Befehl ein, um die Eigenschaften eines MatchInfo-Objekts zu finden:
Select-String -Path test.txt -Pattern 'test' | Get-Member | Format-List -Property *