Join-Path

Das Cmdlet Join-Path kombiniert mehrere Pfadsegmente zu einem gültigen Dateisystempfad.

Es wird verwendet, um:

• Pfade plattformunabhängig zusammenzusetzen

• manuelles Hantieren mit Trennzeichen (\ oder /) zu vermeiden

• Fehler durch doppelte oder fehlende Separatoren zu verhindern

---

🔧 Syntax

    Join-Path [-Path] <String> [-ChildPath] <String> [[-AdditionalChildPath] <String[]>] [<CommonParameters>]

-Path

• Typ: String

• Pflicht: Ja

• Basispfad (z. B. Verzeichnis)

-ChildPath

• Typ: String

• Pflicht: Ja

• Pfadsegment, das an -Path angehängt wird

    Join-Path -Path "C:\Temp" -ChildPath "Datei.txt"

-AdditionalChildPath

Verfügbar ab: PowerShell 6+

• Typ: String[]

• Pflicht: Nein

• Weitere Pfadsegmente, die nacheinander angehängt werden

    Join-Path -Path "C:\Temp" -ChildPath "Logs" -AdditionalChildPath "2026","April"

---

⚠️ Hinweise zur Verwendung

• Trennzeichen werden automatisch korrekt gesetzt (kein manuelles \ nötig)

• Funktioniert providerübergreifend (z. B. Registry, Zertifikate)

• Mehrere Segmente werden sauber zusammengeführt

• Bestehende Trennzeichen im Input werden berücksichtigt (keine doppelten \\)

---

📊 Verhalten

Eigenschaft	Beschreibung
Plattformabhängigkeit	Berücksichtigt das jeweilige Dateisystem
Rückgabewert	String (zusammengesetzter Pfad)
Validierung	Keine Existenzprüfung des Pfades
Separator-Handling	Automatisch korrekt

---

🧪 Beispiele

Einfaches Zusammenfügen

Join-Path -Path "C:\Temp" -ChildPath "Datei.txt"

Ergebnis: C:\Temp\Datei.txt

---

Mehrere Segmente

Join-Path -Path "C:\Temp" -ChildPath "Logs" -AdditionalChildPath "2026","April"

Ergebnis: C:\Temp\Logs\2026\April

---

Mit Variablen

$base = "C:\Temp"
$file = "report.txt"

Join-Path -Path $base -ChildPath $file

Ergebnis: C:\Temp\report.txt

---

Provider-unabhängig (z. B. Registry)

Join-Path -Path "HKCU:\Software" -ChildPath "Microsoft"

---

⚙️ Typische Anwendungsfälle

• Dynamische Dateipfade erstellen

• Arbeiten mit temporären Verzeichnissen

• Plattformunabhängige Skripte schreiben

• Zusammenbau von Registry-Pfaden

---

❗ Alternativen / Ergänzungen

String-Konkatenation

# ❌ Fehleranfällig
"C:\Temp\" + "Datei.txt"

• Fehleranfällig bei fehlenden oder doppelten Trennzeichen

• Nicht plattformunabhängig

---

[System.IO.Path]::Combine()

[System.IO.Path]::Combine("C:\Temp", "Datei.txt")

Unterschiede:

• .NET-Methode, nicht PowerShell-spezifisch

• Keine Provider-Unterstützung (nur Dateisystem)

• Kein Support für CommonParameters

---

🧠 Best Practices

• Immer Join-Path statt String-Konkatenation verwenden

• Ab PowerShell 6 kann für mehrere Segmente -AdditionalChildPath verwendet werden.

• Kombination mit Test-Path für Existenzprüfung

• Variablen statt Hardcoding verwenden

---

Wenn du Pfade immer noch per String zusammenklebst, dann sabotierst du dich halt selbst mit Ansage. Funktioniert kurz, bricht später, und dann suchst du den Fehler wie ein Detektiv ohne Kaffee. Nimm einfach Join-Path und erspar dir das Drama.