Expand-EulandaEnvString #

ÜBERSICHT #

Ersetzt EULANDA-Custom-Platzhalter %env.VAR% durch Werte aus der Prozess-Umgebungsvariable VAR.

SYNTAX #

Expand-EulandaEnvString [-Value] <string> [<CommonParameters>]

BESCHREIBUNG #

EULANDA nutzt für bestimmte Registry-Werte (z.B. DMS-BaseFolder: \VENDOR\esol\MODULES\DMS\BaseFolder = %env.EULANDA_DMS%) eine eigene Interpolations-Syntax %env.VAR%, die sich von der Windows-Standard-Syntax %VAR% unterscheidet. Diese Funktion löst die EULANDA-Platzhalter clientseitig auf – die Variable muss in der aktuellen Prozess-Umgebung gesetzt sein.

Verhalten bei nicht gesetzter Variable: der Platzhalter bleibt unverändert stehen. Damit ist im Ergebnis sichtbar, dass eine Aufloesung fehlgeschlagen ist, statt einen leeren Teilstring zu bekommen (der sich leise in konkatenierte Pfade einschleichen würde).

Mehrfache Platzhalter im selben String werden alle aufgelöst. Andere Teile des Strings bleiben unverändert.

PARAMETER #

-Value #

Type: string

String mit ggf. %env.VAR%-Platzhaltern. $null oder leer werden unverändert zurückgegeben.

AUSGABEN #

string

BEISPIELE #

# Typischer DMS-BasePath, wenn EULANDA_DMS=\\server\dms$ gesetzt ist
Expand-EulandaEnvString -Value '%env.EULANDA_DMS%'
# -> "\\server\dms$"

# Zusammengesetzter Pfad
Expand-EulandaEnvString -Value '%env.EULANDA_DMS%\Adresse\MUSTER'
# -> "\\server\dms$\Adresse\MUSTER"

# Nicht gesetzte Variable bleibt sichtbar
Expand-EulandaEnvString -Value '%env.NICHT_GESETZT%\sub'
# -> "%env.NICHT_GESETZT%\sub"