Invoke-AdodbQuery

EulandaXtools — Funktionsreferenz

Invoke-AdodbQuery

ÜBERSICHT

Führt eine SQL-Abfrage über eine bestehende ADODB-Verbindung aus und gibt die Datensätze als Objekte zurück.

SYNTAX

Invoke-AdodbQuery [-Conn] <__ComObject> [-Sql] <string> [<CommonParameters>]

BESCHREIBUNG

Diese Funktion verwendet eine vorhandene ADODB-Connection (z. B. von Get-ConnByUdl), um eine SQL-Abfrage auszuführen. Das Ergebnis wird als Array von PowerShell-Objekten (pro Datensatz ein Objekt mit Spaltennamen als Eigenschaften) zurückgegeben.

PARAMETER

-Conn

Type: __ComObject

Offene ADODB-Verbindung zur SQL-Datenbank.

-Sql

Type: string

SQL-Abfrage, die ausgeführt werden soll.

AUSGABEN

System.Object[]

Liste von Datensätzen, die jeweils ein PowerShell-Objekt mit Feldwerten darstellen.

BEISPIELE

# Führt eine einfache SELECT-Abfrage aus und gibt die Ergebnisse zurück
$result = Invoke-AdodbQuery -Conn $conn -Sql "SELECT TOP 5 Name, Id FROM Artikel"
# Gibt eine Liste von IDs zurück
$ids = (Invoke-AdodbQuery -Conn $conn -Sql "SELECT Id FROM Artikel WHERE Waehrung='EUR'") | ForEach-Object { $_.Id }

HINWEISE

Kompatibel mit PowerShell 5.1 und 7. Es wird kein RegEx verwendet. Die Funktion ist robust gegen NULL-Werte.