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

VERWANDTE LINKS

Write-IniFile

Get-IniKeyValue

HINWEISE

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