ConvertTo-CleanStringList

Ü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