Get-ConnByUdl

EulandaXtools — Funktionsreferenz

Get-ConnByUdl

ÜBERSICHT

Öffnet eine ADODB-Verbindung auf Basis einer UDL-Datei.

SYNTAX

Get-ConnByUdl [-Udl] <string> [<CommonParameters>]

BESCHREIBUNG

Diese Funktion liest den Connection-String aus einer angegebenen UDL-Datei und gibt ein geöffnetes ADODB.Connection-Objekt zurück. Die Funktion prüft, ob die Datei vorhanden ist und enthält einen gültigen Provider-Eintrag.

Im Fehlerfall gibt die Funktion eine Warnung aus und liefert $null zurück.

PARAMETER

-Udl

Type: string

Pfad zur UDL-Datei (z.B. C:\config\meine.udl). Muss vorhanden sein.

AUSGABEN

System.__ComObject, System.Object

ADODB.Connection bei Erfolg und `$null` bei Fehler oder ungültigem Connection-String.

BEISPIELE

# Liefert eine geöffnete Connection anhand einer UDL-Datei
$conn = Get-ConnByUdl -UdlPath ".\config\erp.udl"

if ($conn) {
    # Verbindung verwenden
} else {
    Write-Warning "Keine Verbindung hergestellt."
}

HINWEISE

Die UDL-Datei muss mindestens einen gültigen "Provider"-Eintrag enthalten. Erfordert PowerShell 5.1 oder höher.