Convert to Extended Path
Zuletzt geändert: 14.03.2026 05:56

Convert-ToExtendedPath #

ÜBERSICHT #

Wandelt einen Pfad (lokal oder UNC) in das Extended-Length-Format um.

SYNTAX #

Convert-ToExtendedPath [-Path] <string> [-OnlyIfTooLong] [<CommonParameters>]

BESCHREIBUNG #

Unter Windows kann die normale MAX_PATH-Limitierung (260 Zeichen) Probleme bereiten. Diese Funktion wandelt einen Pfad in die Extended-Length-Notation (\\?\ für lokale Laufwerke bzw. \\?\UNC\ für UNC-Pfade) um, sodass er auch für sehr lange Pfade verwendbar ist.

Das Verhalten ist konfigurierbar:

  • Standard: Alle Pfade werden in Extended-Notation umgewandelt.
  • Mit -OnlyIfTooLong: Nur Pfade, die länger als 259 Zeichen sind, werden angepasst.
  • Unter Linux/macOS erfolgt keine Umwandlung, es wird lediglich der absolute Pfad zurückgegeben.

PARAMETER #

-Path #

Type: string

Der Eingabepfad (relativ oder absolut). Relativpfade werden automatisch in absolute Pfade aufgelöst.

-OnlyIfTooLong #

Type: switch

Wenn gesetzt, werden nur Pfade umgewandelt, die zu lang für das klassische Windows-Limit sind.

AUSGABEN #

System.String

Gibt den absoluten (ggf. erweiterten) Pfad als String zurück.

BEISPIELE #

# Immer Extended-Notation zurückgeben
Convert-ToExtendedPath -Path 'C:\temp\file.txt'

# Nur wenn nötig (Pfad zu lang)
Convert-ToExtendedPath -Path 'C:\very\long\...' -OnlyIfTooLong