ConvertTo-SafeFileName

ÜBERSICHT

Wandelt einen beliebigen Text in einen Windows-kompatiblen Dateinamen um.

SYNTAX

ConvertTo-SafeFileName [-Name] <string> [[-Default] <string>] [<CommonParameters>]

BESCHREIBUNG

Diese Hilfsfunktion ersetzt alle ungültigen Dateinamen-Zeichen (laut .NET/Windows) durch Unterstriche. Dadurch kann der zurückgegebene String sicher als Dateiname verwendet werden.

Zusätzlich wird sichergestellt, dass das Ergebnis nicht leer ist: Falls nach dem Ersetzen kein sinnvoller Inhalt übrig bleibt, wird "UNBENANNT" zurückgegeben.

Typische Verwendung:

• Bestellnummern, Kundennummern oder externe IDs als Teil eines Dateinamens
• OutputFileTemplate wie "ORDER ({GroupKeySafe}).xml"

PARAMETER

-Name

Type: string

Der Eingabetext, der zu einem gültigen Dateinamen umgewandelt werden soll.

-Default

Type: string
Default: 'UNBENANNT'

Wird kein Name ermittelt (Null oder Whitespaces), wird UNBENANNT bzw. dieser Default als Dateiname verwendet.

AUSGABEN

string

Ein bereinigter Dateiname ohne ungültige Zeichen.

BEISPIELE

# Bestellnummer für Dateinamen bereinigen
ConvertTo-SafeFileName -Name 'AB/123:45*?'

# Leerer String wird zu einem Fallback-Namen
ConvertTo-SafeFileName -Name '' -Default 'NoName'