Test-AdoConnection #

ÜBERSICHT #

Prüft, ob eine ADO-Connection aktiv, also geöffnet ist.

SYNTAX #

Test-AdoConnection [[-Conn] <__ComObject>] [-Strict] [<CommonParameters>]

BESCHREIBUNG #

Gibt $true zurück, wenn das übergebene COM-Objekt eine geöffnete ADO-Verbindung darstellt State -eq 1, andernfalls $false. Mit Parameter -Strict wird bei Problemen eine Exception ausgelöst.

PARAMETER #

-Conn #

Type: __ComObject

Ein ADO-Connection COM-Objekt beispielsweise ADODB.Connection.

-Strict #

Type: switch

Wenn gesetzt, wirft die Funktion bei Problemen eine Exception anstatt nur $false zurückzugeben.

AUSGABEN #

bool

BEISPIELE #

# Prüft, ob die übergebene ADO-Verbindung aktiv ist. Verwendet den Standardwert für -ErrorAction.
Test-AdoConnection -Conn $session.Connection

# Wirft eine Exception, da die Verbindung ungültig ist.
Test-AdoConnection $null -ErrorAction Stop

# Gibt $false zurück und zeigt zusätzlich eine Fehlermeldung an.
Test-AdoConnection $null -ErrorAction SilentlyContinue

# Ergibt eine Exception, wenn Verbindung nicht geöffnet oder ungültig ist.
Test-AdoConnection -Conn $conn -Strict

HINWEISE #

Diese Funktion ersetzt die Test-DbConnectionOrThrow durch folgenden Aufruf: Test-AdoConnection -Conn $Conn -ErrorAction Stop -Strict