Set-FrontMatterValue #

ÜBERSICHT #

Setzt oder aktualisiert einen Eintrag in einem YAML-FrontMatter-Block.

SYNTAX #

Set-FrontMatterValue [[-FrontMatter] <string>] [-Name] <string> [-Value] <string>
    [<CommonParameters>]

BESCHREIBUNG #

Diese Funktion prüft, ob im übergebenen FrontMatter-String bereits ein Eintrag mit dem angegebenen Namen existiert. Falls ja, wird dessen Wert ersetzt. Falls nein, wird eine neue Zeile angehängt.

Doppelte Leerzeilen im Ergebnis werden bereinigt. Bei leerem FrontMatter-Input wird eine einzelne Zeile Name: Value zurückgegeben.

PARAMETER #

-FrontMatter #

Type: string

Der bestehende FrontMatter-Inhalt als String.

-Name #

Type: string
Mandatory: True

Der Name des YAML-Feldes (z. B. title, lastMod).

-Value #

Type: string
Mandatory: True

Der neue Wert für das Feld.

AUSGABEN #

Der aktualisierte FrontMatter-String.

BEISPIELE #

# Aktualisiert den Titel im FrontMatter.
$fm = "title: Alt`r`nlastMod: 2024-01-01"
Set-FrontMatterValue -FrontMatter $fm -Name "title" -Value "Neu"

# Fügt ein neues Feld hinzu.
$fm = "title: Mein Titel"
Set-FrontMatterValue -FrontMatter $fm -Name "draft" -Value "true"