Übersicht

Remove-EulandaRegistryKey #

ÜBERSICHT #

Löscht einen kompletten Subkey inklusive aller Values und aller verschachtelten Unter-Subkeys aus der SQL-Registry. Im Hive-Modus wird der entsprechende Subtree auch aus der Cache-Datei entfernt.

SYNTAX #

Remove-EulandaRegistryKey [-Conn] <__ComObject> [[-Udl] <string>] [[-ConnStr] <string>]
    [<CommonParameters>]

BESCHREIBUNG #

Write-Through-Semantik: erst DB-Delete (cn_RegOpenPath + cn_RegDelKey), dann Remove-EulRegTree auf den Hive-Root-Subkey. Der Hive-RegDeleteTree löscht rekursiv, d.h. der komplette Subtree wird invalidiert - nicht nur der angegebene Knoten.

Das ist der richtige Weg, einen temporären Test- oder Konfig- Subtree sauber zu entsorgen (DB + Cache). Wer nur den Cache leeren will (ohne DB-Delete), nutzt stattdessen Clear-EulandaRegistryCache -Path <Pfad>.

Idempotent: fehlender Key liefert 0 zurück, kein Fehler.

Vorsicht mit Root-Pfaden. Remove-EulandaRegistryKey -Path '\MODULES\Grundwerte' löscht den gesamten Grundwerte-Baum (Firmenstamm, Xfacture, Banken, etc.). Die Registry hat keinen Papierkorb. Pfade bewusst wählen.

PARAMETER #

-Path #

Zu löschender Subkey-Pfad.

-Conn #

Type: __ComObject

Bestehende ADODB.Connection. Alternativ -Udl oder -ConnStr.

AUSGABEN #

[int] - 1 wenn der Key existierte, 0 wenn nicht vorhanden.

BEISPIELE #

# Test-Subtree nach Smoke-Test entsorgen
Remove-EulandaRegistryKey -Conn $conn -Path '\TEMP\EulandaXtools\SmokeTest'

# Obsoleten Feature-Toggle samt Unter-Konfig entfernen
Remove-EulandaRegistryKey -Conn $conn -Path '\SYSTEM\Config\LegacyFeature'

HINWEISE #

Nutzt $script:RegStore.RemoveKey (Store-Operation, seit 2026-04-17 verfügbar). Im Hive-Modus wird der Subtree per RegDeleteTree aus der lokalen Cache-Datei entfernt.