Read-IniFile

ÜBERSICHT

Liest eine INI-Datei in eine verschachtelte Hashtable.

SYNTAX

Read-IniFile [-Path] <System.IO.FileInfo> [<CommonParameters>]

BESCHREIBUNG

Die Funktion liest eine INI-Datei ein und konvertiert deren Inhalt in eine verschachtelte Hashtable. Sektionen werden dabei als eigene Hashtables mit Schlüssel-Wert-Paaren abgebildet. Kommentare oder Einträge ohne zugehörige Sektion werden unter der Sektion `No-Section` gespeichert.

Die Funktion eignet sich insbesondere für klassische Windows-INI-Dateien. Solche Konfigurationsdateien sind auch heute noch nützlich, da sie einfach aufgebaut sind und sich problemlos in einem Editor wie Notepad bearbeiten lassen - ganz ohne komplexe Syntaxregeln.

PARAMETER

-Path

Type: System.IO.FileInfo

Der vollständige Pfad zur INI-Datei, die gelesen werden soll.

AUSGABEN

hashtable

Doppelt geschachtele Hashtable.

BEISPIELE

# Liest die Datei "config.ini" und gibt eine Hashtable zurück.
$ini = Read-IniFile -Path 'C:\config.ini'

# Testen, ob eine Sektion existiert
if ($ini.ContainsKey('Meier')) {
  Write-Host "Sektion vorhanden!"
}

# Testen, ob ein Schlüssel existiert
if ($ini['Meier'] -and $ini['Meier'].ContainsKey('test')) {
  Write-Host "Schlüssel vorhanden!"
}

# Testen, ob ein Schlüssel existiert
if (-not $ini.ContainsKey('Meier')) {
  $ini['Meier'] = [ordered]@{}
}

# Zuweisen eines neuen Werts
$ini['Meier']['test'] = 'NeuerWert'

VERWANDTE LINKS

Write-IniFile

Get-IniKeyValue

HINWEISE

Ein Zurückschreiben der geänderten Werte erfolgt über die Funktion Write-IniFile. Für den gezielten Zugriff auf einzelne Schlüssel verwenden Sie `Get-IniKeyValue`.