Übersicht

Remove-EulandaRegistryValue #

ÜBERSICHT #

Löscht einen einzelnen Value aus der SQL-Registry. Im Hive-Modus wird der Value auch aus der lokalen Cache-Datei entfernt (Write-Through-Semantik).

SYNTAX #

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

BESCHREIBUNG #

Analog zu Set-EulandaRegistryString: die Datenbank ist Quelle der Wahrheit und wird zuerst aktualisiert (cn_RegOpenPath + cn_RegValueDelete). Im Hive-Modus wird anschliessend der Value aus der Hive-Datei entfernt, damit ein direkt folgender Read den Wert nicht mehr sieht.

Der Subtree-FetchedAt bleibt unveraendert - analog zur Set-Semantik. Andere Values im Subtree wurden nicht geprueft, also bleibt der letzte Populate-Zeitstempel gültig.

Wenn weder der Key noch der Value existieren, ist das kein Fehler (Idempotenz). Rückgabe ist dann 0.

PARAMETER #

-Path #

Registry-Pfad, z.B. \MODULES\Grundwerte\Firmenstamm.

-Name #

Value-Name unter dem Pfad.

-Conn #

Type: __ComObject

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

AUSGABEN #

[int] - 1 wenn der Key existierte (unabhaengig davon, ob der Value

da war), 0 wenn der Key nicht existierte.

BEISPIELE #

Remove-EulandaRegistryValue -Conn $conn `
  -Path '\SYSTEM\Config' -Name 'ObsoleteFeature'

HINWEISE #

Nutzt $script:RegStore.Remove - im Hive-Modus Write-Through via New-EulRegHiveStore, im Legacy-/Off-Modus direkt über cn_RegValueDelete.