ConvertTo-CleanStringList #

Intern – Diese Funktion ist nicht exportiert und nur modulintern verfügbar.

ÜBERSICHT #

Normalisiert einen Wert zu einer bereinigten String-Liste (string[]).

SYNTAX #

ConvertTo-CleanStringList [[-Value] <object>] [[-Separators] <char[]>] [<CommonParameters>]

BESCHREIBUNG #

Wandelt unterschiedliche Eingabetypen in eine String-Liste um, die sich sicher weiterverarbeiten lässt.

Fälle:

• $null: Rückgabe ist ein leeres Array.
• String: Split an Trennzeichen (Standard: Komma, Semikolon, Pipe), Trim, leere Einträge entfernen.
• IEnumerable (z.B. Array/Liste): jedes Element ToString().Trim(), null/leer entfernen.
• Sonstiges Objekt: wird als einzelner Eintrag ToString().Trim() behandelt.

Die Funktion gibt das Ergebnis absichtlich ohne Enumeration zurück, damit der Aufrufer immer ein string[] erhält (auch wenn nur ein einziger Eintrag vorhanden ist).

PARAMETER #

-Value #

Type: object

Eingabewert (String, Array, IEnumerable oder sonstiges Objekt).

-Separators #

Type: char[]
Default: [char[]]@('

Trennzeichen, die bei String-Eingaben verwendet werden. Standard: Komma, Semikolon, Pipe.

AUSGABEN #

System.String[]

BEISPIELE #

# String mit mehreren Empfängern normalisieren
ConvertTo-CleanStringList -Value 'a@b.de, c@d.de'

# Array aus JSON normalisieren
ConvertTo-CleanStringList -Value @('OnFailure', 'Delay')

# Null sicher behandeln
ConvertTo-CleanStringList -Value $null

HINWEISE #

Wird unter anderem in Send-JsonDbMail verwendet