Get-ShortDescription

ÜBERSICHT

Gibt eine Kurzfassung eines längeren Textes zurück, sinnvoll abgeschnitten.

SYNTAX

Get-ShortDescription [[-Text] <string>] [[-MaxLength] <int>] [<CommonParameters>]

BESCHREIBUNG

Diese Funktion erzeugt eine kompakte Einzeilen-Zusammenfassung eines gegebenen Textes. Dabei wird der erste Zeilenumbruch beachtet und als bevorzugter Schnittpunkt verwendet. Falls der Text länger ist als der angegebene Grenzwert ('MaxLength'), wird versucht, an einem Leerzeichen zu kürzen. Wenn kein Leerzeichen gefunden wird, wird hart bei 'MaxLength' abgeschnitten.

PARAMETER

-Text

Type: string

Der Eingabetext, aus dem eine kurze Beschreibung erzeugt werden soll.

-MaxLength

Type: int
Default: 50

Die maximale Länge der Kurzbeschreibung. Standardwert: 50 Zeichen.

AUSGABEN

string

Ein gekürzter Einzeiler ohne Zeilenumbrüche.

BEISPIELE

# Gibt eine Kurzfassung zurück, die möglichst sinnvoll abgeschnitten ist (z.B.. am nächsten Leerzeichen).
Get-ShortDescription -Text "Dies ist ein sehr langer Beschreibungstext..." -MaxLength 40

HINWEISE

Diese Funktion ist besonders nützlich, um längere Texte (z.B.. HTML, Beschreibungen, Skriptkommentare) als Einzeiler in Listen, Logs oder DropDowns darzustellen. Zeilenumbrüche im Originaltext werden erkannt und bei Bedarf als Schnittpunkt verwendet.