Get-FrontMatterItem

ÜBERSICHT

Liest einen Eintrag aus einem YAML-FrontMatter-Block und wandelt ihn optional in einen bestimmten Datentyp um.

SYNTAX

Get-FrontMatterItem [-FrontMatter] <string> [-Name] <string> [[-Type] <string>]
    [<CommonParameters>]

BESCHREIBUNG

Diese Funktion extrahiert den Wert eines bestimmten YAML-Schlüssels (`name`) aus einem übergebenen FrontMatter-Block (als Text). Optional kann der Rückgabewert in einen bestimmten Typ (`int`, `datetime`, `double`, `bool`) umgewandelt werden.

Wird der Eintrag nicht gefunden oder ist ungültig, kann ein Defaultwert zurückgegeben werden.

PARAMETER

-FrontMatter

Type: string
Mandatory: True

Der gesamte FrontMatter-Inhalt als String (z. B. von einem Markdown-Dokument).

-Name

Type: string
Mandatory: True

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

-Type

Type: string
Default: 'string'

Gewünschter Rückgabetyp: `string` (Standard), `int`, `datetime`, `double`, `bool`.

-DefaultValue

Optionaler Rückgabewert, falls das Feld nicht existiert oder nicht interpretierbar ist.

BEISPIELE

# Gibt den Wert des Feldes `title` als String zurück.
Get-FrontMatterItem -FrontMatter $front -Name "title"

# Gibt das Datum als [datetime]-Wert zurück oder `MinValue`, wenn ungültig.
Get-FrontMatterItem -FrontMatter $front -Name "lastMod" -Type datetime