Get-Conn

EulandaXtools — Funktionsreferenz

Get-Conn

ÜBERSICHT

Liefert eine geöffnete ADODB-Verbindung aus einem bestehenden Objekt, einer Udl-Datei oder einem Connection-String.

SYNTAX

Get-Conn [[-Conn] <__ComObject>] [[-Udl] <string>] [[-ConnStr] <string>] [<CommonParameters>]

BESCHREIBUNG

Gibt ein ADODB.Connection-Objekt zurück, basierend auf einer bestehenden Verbindung (`Conn`), einer Udl-Datei (`Udl`) oder einem Connection-String (`ConnStr`). Falls keine Quelle angegeben ist oder die Verbindung nicht geöffnet werden kann, wird `$null` zurückgegeben. Es erfolgt maximal eine Warnung.

PARAMETER

-Conn

Type: __ComObject

Bestehendes ADODB.Connection-Objekt. Falls noch geschlossen, wird `.Open()` aufgerufen.

-Udl

Type: string

Pfad zu einer Udl-Datei, über die die Verbindung geöffnet wird.

-ConnStr

Type: string

ADODB-Connection-String zur Initialisierung der Verbindung.

AUSGABEN

__ComObject, System.Object

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

BEISPIELE

# Öffnet eine ADODB-Verbindung über einen Connection-String.
$conn = Get-Conn -ConnStr "Provider=SQLOLEDB;Data Source=.\SQLEXPRESS;Initial Catalog=EULANDA_Mustermann;Integrated Security=SSPI"

VERWANDTE LINKS

New-ConnStr