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'

VERWANDTE LINKS

Read-IniFile

Set-IniKeyValue

HINWEISE

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