Select-String

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

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

C:\PS>"Hello","HELLO" | select-string -pattern "HELLO" -casesensitive

Beschreibung
-----------
Dieser Befehl vergleicht Text, der über die Pipeline an den Befehl "Select-String" übergeben wurde, unter Berücksichtigung der Groß-/Kleinschreibung. 

Daher findet Select-String nur "HELLO", da "Hello" nicht übereinstimmt.

Da jede der Zeichenfolgen in Anführungszeichen als Zeile behandelt wird, interpretiert Select-String ohne den CaseSensitive-Parameter beide Zeichenfolgen als Übereinstimmung.

C:\PS>select-string -path *.xml -pattern "the the"

Beschreibung
-----------
Mit diesem Befehl werden alle Dateien mit der Dateinamenerweiterung ".xml" im aktuellen Verzeichnis durchsucht und die Zeilen in diesen Dateien angezeigt, die die Zeichenfolge "the the" enthalten.

C:\PS>select-string -path $pshome\en-US\*.txt -pattern "@"

Beschreibung
-----------
Mit diesem Befehl werden in den konzeptionellen Hilfedateien ("about_*.txt") für Windows PowerShell Informationen über die Verwendung das at-Zeichens (@) gesucht. 

Der Pfad wird in diesem Befehl mit dem Wert der automatischen Variablen "$pshome" angegeben, in der der Pfad des Windows PowerShell-Installationsverzeichnisses gespeichert wird. In diesem Beispiel durchsucht der Befehl das Unterverzeichnis "en-US", das die Hilfedateien für Windows PowerShell in englischer Sprache (Englisch, USA) enthält.

C:\PS>function search-help
{
    $pshelp = "$pshome\es\about_*.txt", "$pshome\en-US\*dll-help.xml"
    select-string -path $pshelp -pattern $args[0]
}

Beschreibung
-----------
Diese einfache Funktion sucht mit dem Cmdlet "Select-String" in den Windows PowerShell-Hilfedateien nach einer bestimmten Zeichenfolge. In diesem Beispiel sucht die Funktion im Unterverzeichnis "en-US" nach Dateien in englischer Sprache (Englisch, USA).

Um mit der Funktion eine Zeichenfolge, z. B. "psdrive", zu suchen, geben Sie folgenden Befehl ein: "search-help psdrive".

Um diese Funktion in einer beliebigen Windows PowerShell-Konsole zu verwenden, ändern Sie den Pfad in den Pfad der Windows PowerShell-Hilfedateien auf dem System, und fügen Sie dann die Funktion in das Windows PowerShell-Profil ein.

C:\PS>$events = get-eventlog -logname application -newest 100

C:\PS> $events | select-string -inputobject {$_.message} -pattern "failed"

Beschreibung
-----------
In diesem Beispiel wird in den 100 neuesten Ereignissen im Anwendungsprotokoll der Ereignisanzeige nach der Zeichenfolge "failed" gesucht.

Im ersten Befehl wird das Cmdlet "Get-EventLog" verwendet, um die 100 letzten Ereignisse aus dem Anwendungsereignisprotokoll abzurufen. Dann werden die Ereignisse in der Variablen "$events" gespeichert. 

Im zweiten Befehl werden die Objekte in der Variablen "$events" mit einem Pipelineoperator (|) an Select-String gesendet. Die Eingabe aus der Variablen "$events" wird mithilfe des InputObject-Parameters dargestellt. Der Wert des InputObject-Parameters ist die Message-Eigenschaft jedes Objekts, das gerade über die Pipeline übertragen wird. Das aktuelle Objekt wird durch das Symbol "$_" dargestellt.

Bei der Ankunft jedes Ereignisses in der Pipeline sucht Select-String im Wert der zugehörigen Message-Eigenschaft nach der Zeichenfolge "failed" und zeigt dann Zeilen an, die eine Übereinstimmung enthalten.

C:\PS>get-childitem c:\windows\system32\* -include *.txt -recurse |
select-string -pattern "Microsoft" -casesensitive

Beschreibung
-----------
Mit diesem Befehl werden alle Dateien in den Unterverzeichnissen von "C:\Windows\System32" mit der Dateinamenerweiterung ".txt" überprüft und nach der Zeichenfolge "Microsoft" durchsucht. Der CaseSensitive-Parameter gibt an, dass das "M" in "Microsoft" ein Großbuchstabe sein muss und die restlichen Zeichen Kleinbuchstaben sein müssen, damit Select-String eine Übereinstimmung findet.

C:\PS>select-string -path process.txt -pattern idle, svchost -notmatch

Beschreibung
-----------
Mit diesem Befehl werden Textzeilen in der Datei "Process.txt" gesucht, die weder das Wort "idle" noch das Wort "svchost" enthalten.

C:\PS>$f = select-string -path audit.log -pattern "logon failed" -context 2, 3

C:\PS> $f.count

C:\PS> ($f)[0].context | format-list

Beschreibung
-----------
Im ersten Befehl wird in der Datei "audit.log" der Ausdruck "logon failed" gesucht. Mit dem Context-Parameter werden 2 Zeilen vor und 3 Zeilen nach der Übereinstimmung erfasst. 

Im zweiten Befehl wird die Anzahl der gefundenen Übereinstimmungen mithilfe der Count-Eigenschaft von Objektarrays angezeigt. In diesem Fall wurden 2 Übereinstimmungen gefunden. 

Im dritten Befehl werden die in der Context-Eigenschaft des ersten MatchInfo-Objekts gespeicherten Zeilen angezeigt. Die erste Übereinstimmung (Übereinstimmung 0 in einem nullbasierten Array) wird mithilfe der Arraynotation angegeben, und mit dem Cmdlet "Format-List" wird der Wert der Context-Eigenschaft als Liste angezeigt.

Die Ausgabe besteht aus zwei MatchInfo-Objekten (eines pro gefundene Übereinstimmung). Die Kontextzeilen werden in der Context-Eigenschaft des MatchInfo-Objekts gespeichert.

C:\PS>$a = get-childitem $pshome\en-us\about*.help.txt | select-string -pattern transcript


C:\PS> $b = get-childitem $pshome\en-us\about*.help.txt | select-string -pattern transcript -allmatches

C:\PS> $a
C:\Windows\system32\WindowsPowerShell\v1.0\en-us\about_Pssnapins.help.txt:39:       Start-Transcript and Stop-Transcript.

C:\PS> $b
C:\Windows\system32\WindowsPowerShell\v1.0\en-us\about_Pssnapins.help.txt:39:       Start-Transcript and Stop-Transcript.


C:\PS>> $a.matches
Groups   : {Transcript}
Success  : True
Captures : {Transcript}
Index    : 13
Length   : 10
Value    : Transcript


C:\PS> $b.matches
Groups   : {Transcript}
Success  : True
Captures : {Transcript}
Index    : 13
Length   : 10
Value    : Transcript

Groups   : {Transcript}
Success  : True
Captures : {Transcript}
Index    : 33
Length   : 10
Value    : Transcript

Beschreibung
-----------
In diesem Beispiel werden die Auswirkungen des AllMatches-Parameters von Select-String veranschaulicht. Mit AllMatches werden alle Musterübereinstimmungen in einer Zeile und nicht nur die erste Übereinstimmung in jeder Zeile gesucht.

Im ersten Befehl des Beispiels werden die konzeptionellen Hilfedateien ("about"-Hilfe) für Windows PowerShell nach Instanzen des Worts "transcript" durchsucht. Der zweite Befehl unterscheidet sich nur darin, dass er den AllMatches-Parameter verwendet.

Die Ausgabe des ersten Befehls wird in der Variablen "$a" gespeichert. Die Ausgabe des zweiten Befehls wird in der Variablen "$b" gespeichert. 

Wenn Sie den Wert der Variablen anzeigen, ist die Standardanzeige identisch, wie in der Beispielausgabe gezeigt.

Im fünften und sechsten Befehl wird jedoch der Wert der Matches-Eigenschaft jedes Objekts angezeigt. Die Matches-Eigenschaft des ersten Befehls enthält nur eine Übereinstimmung (d. h. ein System.Text.RegularExpressions.Match-Objekt), wohingegen die Matches-Eigenschaft des zweiten Befehls Objekte für beide Übereinstimmungen in der Zeile enthält.