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.

VERWANDTE LINKS

Read-IniFile

Set-IniKeyValue

Get-IniKeyValue

HINWEISE

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