Write-IniFile #

ÜBERSICHT #

Schreibt die zuvor mit Read-IniFile geladene Hashtable in eine INI-Datei zurück und bewahrt Reihenfolge sowie Kommentare.

SYNTAX #

Write-IniFile [-Data] <Hashtable> [-Path] <string> [[-RetrySeconds] <int>] [[-RetryIntervalMs]
    <int>] [<CommonParameters>]

BESCHREIBUNG #

Schreibt die zuvor mit Read-IniFile geladene Hashtable in eine INI-Datei zurück. Dabei bleibt die ursprüngliche Reihenfolge der Einträge erhalten - ebenso wie vorhandene Kommentare und die Struktur der Datei.

Wenn die INI-Datei bereits existiert, wird sie eingelesen und gezielt ergänzt bzw. überarbeitet. Neue oder geänderte Schlüssel werden aktualisiert, bestehende Kommentare und nicht betroffene Werte bleiben erhalten. Existiert die Datei nicht, wird sie neu erstellt.

Die Funktion eignet sich besonders für klassische Windows-INI-Dateien. Diese Konfigurationsdateien sind auch heute noch praktisch, da sie einfach aufgebaut sind und sich problemlos in einem Editor wie Notepad bearbeiten lassen – ohne komplexe Syntaxregeln.

PARAMETER #

-Data #

Type: Hashtable

Hashtable mit Sektionen und Schlüssel-Wert-Paaren.

-Path #

Type: string

Zielpfad der INI-Datei.

-RetrySeconds #

Type: int
Default: 5

Timeout für exklusive Dateisperre (Standard: 5 Sek).

-RetryIntervalMs #

Type: int
Default: 250

Intervall zwischen Retry-Versuchen (Standard: 250 ms).

AUSGABEN #

void

Keinen Rückgabewert.

HINWEISE #

Für das Ändern einzelner Schlüssel verwenden Sie Set-IniKeyValue.