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"