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`