Invoke-AdodbNonQuery

EulandaXtools — Funktionsreferenz

Invoke-AdodbNonQuery

ÜBERSICHT

Führt einen SQL-Befehl ohne Rückgabewert über eine bestehende ADODB-Verbindung aus.

SYNTAX

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

BESCHREIBUNG

Diese Funktion verwendet eine vorhandene ADODB-Connection (z. B. von Get-ConnByUdl), um SQL-Anweisungen wie UPDATE, INSERT oder DELETE auszuführen. Sie gibt die Anzahl der betroffenen Datensätze zurück, sofern der Provider dies unterstützt.

PARAMETER

-Conn

Type: __ComObject

Offene ADODB-Verbindung zur SQL-Datenbank.

-Sql

Type: string

SQL-Befehl, der ausgeführt werden soll (z. B. UPDATE, INSERT, DELETE).

AUSGABEN

System.Int32

Anzahl der betroffenen Datensätze (sofern vom Provider unterstützt), sonst 0.

BEISPIELE

# Setzt das Exportdatum eines bestimmten Auftrags
$count = Invoke-AdodbNonQuery -Conn $conn -Sql "UPDATE Auftrag SET UserD1 = GETDATE() WHERE ID = 1234"

HINWEISE

Kompatibel mit PowerShell 5.1 und 7. Kein RegEx, kein Output — stabil für SQL Server.