Resolve-EulandaPath

EulandaXtools — Funktionsreferenz

Resolve-EulandaPath Intern

ÜBERSICHT

Löst einen relativen oder absoluten Dateipfad abhängig vom angegebenen Arbeitsverzeichnis auf.

SYNTAX

Resolve-EulandaPath [[-WorkingDir] <string>] [-FilePath] <string> [<CommonParameters>]

BESCHREIBUNG

Diese Funktion verarbeitet relative oder absolute Pfade und kombiniert sie mit einem übergebenen Arbeitsverzeichnis. Ist der Pfad bereits absolut, wird er direkt verwendet. Ist der Pfad relativ, erfolgt die Auflösung nach folgenden Regeln:

1. Wenn 'WorkingDir' explizit auf '.' gesetzt ist, wird das aktuelle Verzeichnis der Konsole verwendet.

2. Wenn 'WorkingDir' leer ist oder nicht gesetzt:

3. Der kombinierte Pfad wird, falls möglich, mit 'Resolve-Path' aufgelöst. Existiert der Pfad nicht, wird der kombinierte Pfad als Fallback zurückgegeben.

PARAMETER

-WorkingDir

Type: string

Optionales Arbeitsverzeichnis, zu dem der Pfad relativ aufgelöst werden soll. Kann auf '.' gesetzt werden, um das aktuelle Arbeitsverzeichnis zu erzwingen. Bleibt es leer, wird '$env:TEMP\xfacture' verwendet – sofern vorhanden – oder das aktuelle Verzeichnis.

-FilePath

Type: string

Ein Datei- oder Ordnerpfad, relativ oder absolut. Wenn relativ, wird er relativ zum 'WorkingDir' interpretiert.

AUSGABEN

string

Ein absoluter Pfad, entweder aufgelöst über 'Resolve-Path', oder zusammengesetzt aus 'WorkingDir' und 'FilePath'.

BEISPIELE

# Liefert z. B. "C:\Users\Name\AppData\Local\Temp\xfacture\output.xml" oder ".\output.xml"
Resolve-EulandaPath -FilePath "output.xml"
# Liefert z. B. "C:\Projekte\Xfacture\output.xml"
Resolve-EulandaPath -FilePath "output.xml" -WorkingDir "."
# Liefert "C:\tmp\invoice.xml" direkt zurück.
Resolve-EulandaPath -FilePath "C:\tmp\invoice.xml"

HINWEISE

Diese Funktion ist PowerShell 5.1-kompatibel und besonders geeignet für portable Skripte mit optionalen Arbeitsverzeichnissen.