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