Set-IniKeyValue #

ÜBERSICHT #

Ändert oder ergänzt einen einzelnen Schlüsselwert in einer INI-Datei oder einem INI-String.

SYNTAX #

Set-IniKeyValue [-FilePath] <string> [-Content] <string> [-SectionPath] <string> [-KeyName]
    <string> [-Value] <string> [[-ValueType] <string>] [[-Encoding] <string>]

BESCHREIBUNG #

Ändert einen einzelnen Schlüsselwert in einer INI-Datei (-FilePath) oder einem INI-String (-Content). Die Funktion arbeitet zeilenweise und erhält die Reihenfolge der Einträge exakt. Mehrzeilige Werte werden beim Ersetzen korrekt übersprungen.

Existiert die angegebene Sektion nicht, wird sie am Ende hinzugefügt. Existiert der Schlüssel nicht in der Sektion, wird er am Ende der Sektion eingefügt.

Im FromFile-Modus wird die Datei direkt geschrieben und $true zurückgegeben. Im FromString-Modus wird der geänderte String zurückgegeben.

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.

-Value #

Type: string
Mandatory: True

Der neue Wert.

-ValueType #

Type: string
Default: "string"

Art des Werts: string (Standard, wird gequoted), number (ohne Quotes), binhex (mit binhex:-Präfix).

-Encoding #

Type: string
Default: "windows-1252"

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

AUSGABEN #

bool

Im FromFile-Modus: $true bei Erfolg. string Im FromString-Modus: Der geänderte INI-String.

BEISPIELE #

# Wert in Datei ändern
Set-IniKeyValue -FilePath 'C:\config.ini' -SectionPath 'Database' -KeyName 'Server' -Value 'localhost'

# Wert in String ändern
$newText = Set-IniKeyValue -Content $text -SectionPath 'Database' -KeyName 'Port' -Value '1433' -ValueType number

HINWEISE #

Für das Schreiben einer vollständigen Hashtable verwenden Sie Write-IniFile.