Search-TextInFiles

EulandaXtools — Funktionsreferenz

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'