Get-IniKeyValue #

ÜBERSICHT #

Liest einen einzelnen Wert aus einer INI-Datei oder einem INI-String anhand von Sektion und Schlüsselname.

SYNTAX #

Get-IniKeyValue [-FilePath] <string> [-Content] <string> [-SectionPath] <string> [-KeyName]
    <string> [[-Encoding] <string>]

BESCHREIBUNG #

Liest einen einzelnen Schlüsselwert aus einer INI-Datei (-FilePath) oder einem bereits eingelesenen INI-String (-Content). Die Funktion unterstützt einfache Werte, quoted Werte mit Escape-Sequenzen (""), mehrzeilige Werte (Quote-Zählung) und binhex-Werte.

Im Gegensatz zu Read-IniFile, das die gesamte Datei als Hashtable einliest, arbeitet Get-IniKeyValue gezielt auf Einzel-Key-Ebene und eignet sich besonders für den schnellen Zugriff auf einzelne Konfigurationswerte.

PARAMETER #

-FilePath #

Type: string
Mandatory: True

Pfad zur INI-Datei (ParameterSet FromFile).

-Content #

Type: string
Mandatory: True

INI-Inhalt als String (ParameterSet FromString).

-SectionPath #

Type: string
Mandatory: True

Name der Sektion (ohne eckige Klammern).

-KeyName #

Type: string
Mandatory: True

Name des Schlüssels.

-Encoding #

Type: string
Default: "windows-1252"

Encoding für das Lesen der Datei (Standard: windows-1252).

AUSGABEN #

string

Der Wert des Schlüssels, oder $null wenn nicht gefunden.

BEISPIELE #

# Wert aus Datei lesen
$val = Get-IniKeyValue -FilePath 'C:\config.ini' -SectionPath 'Database' -KeyName 'Server'

# Wert aus String lesen
$text = Get-Content 'config.ini' -Raw
$val = Get-IniKeyValue -Content $text -SectionPath 'Database' -KeyName 'Server'

HINWEISE #

Für das Lesen der gesamten INI-Datei als Hashtable verwenden Sie Read-IniFile.