Search-TextInFiles #

ÜBERSICHT #

Durchsucht Dateien nach einem Suchtext.

SYNTAX #

Search-TextInFiles [-SearchText] <string> [[-BasePath] <string>] [[-Filter] <string[]>]
    [-CommonFilters] [-Recurse] [<CommonParameters>]

BESCHREIBUNG #

Diese Funktion durchsucht Dateien in einem angegebenen Basisordner nach einem Suchtext. Optional kann rekursiv gesucht werden. Über den Parameter Filter können mehrere Dateimuster angegeben werden (z. B. *.xml, *.log).

Mit dem Schalter -CommonFilters werden automatisch die gängigsten Filter (*.xml, *.txt, *.json) gesetzt, ohne dass diese explizit angegeben werden müssen.

PARAMETER #

-SearchText #

Type: string
Mandatory: True

Der gesuchte Text, nach dem in den Dateien gesucht wird.

-BasePath #

Type: string
Default: (Get-Location).Path

Der Startordner, in dem die Suche beginnt. Standard ist das aktuelle Verzeichnis.

-Filter #

Type: string[]
Default: @('*.xml')

Ein oder mehrere Dateifilter (Wildcard-Muster). Standard ist ‘*.xml’.

-CommonFilters #

Type: switch

Wenn angegeben, werden automatisch die Filter ‘.xml’,’.txt’,’*.json’ verwendet. Manuelle Filter werden in diesem Fall ignoriert.

-Recurse #

Type: switch

Wenn angegeben, wird rekursiv auch in Unterordnern gesucht.

AUSGABEN #

PSCustomObject mit den Eigenschaften File, Line, Text

BEISPIELE #

# Sucht rekursiv in *.xml, *.txt und *.json im aktuellen Ordner
Search-TextInFiles -SearchText 'EULANDA' -Recurse -CommonFilters

# Sucht nur im Hauptordner C:\Logs nach 'ERROR' in *.log und *.txt
Search-TextInFiles -SearchText 'ERROR' -BasePath 'C:\Logs' -Filter '*.log','*.txt'