ConvertTo-SqlLiteral #

ÜBERSICHT #

Konvertiert einen PowerShell-Wert in ein SQL-Server-Literal.

SYNTAX #

ConvertTo-SqlLiteral  [<CommonParameters>]

BESCHREIBUNG #

Helper für Funktionen, die SQL-Statements aus PowerShell-Werten zusammensetzen (z.B. Invoke-EulUpsert, Excel-Import-Pipeline, Plugin-spezifische Lookups). Liefert ein direkt einsetzbares Literal-String.

Regeln:

$null und [DBNull] → NULL
[bool] → 1 / 0
[datetime] → 'yyyy-MM-dd HH:mm:ss'
Integer-Typen (byte/int16/int32/int64 + unsigned) → Invariant-Culture
Fließkomma (single/double/decimal) → Invariant-Culture (Punkt als Dezimaltrenner)
[Guid] → 'guid-string'
sonst → String, in Hochkommata, ’ verdoppelt, mit N'…'-Prefix (Unicode-sicher)

PARAMETER #

-Value #

Der zu konvertierende Wert (beliebiger Typ).

AUSGABEN #

[string] – SQL-Literal, ohne weitere Quoting nötig.

BEISPIELE #

ConvertTo-SqlLiteral 'O''Brien'        # → N'O''Brien'
ConvertTo-SqlLiteral 12.5              # → 12.5
ConvertTo-SqlLiteral $true             # → 1
ConvertTo-SqlLiteral (Get-Date)        # → '2026-05-21 12:34:56'
ConvertTo-SqlLiteral $null             # → NULL