Convert to Safe File Name
Zuletzt geändert: 14.03.2026 05:56

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'