Reg-to-XML GPP Converter

28. Juni 2026

Inhalt

Was das Tool macht
Voraussetzungen
Verwendung
Parameter
XML in ein GPO übernehmen
Gut zu wissen
Versionen & Quelle

Registry-Einstellungen lassen sich elegant per Group Policy Preferences (GPP) verteilen — aber nur als XML, nicht als klassische .reg-Datei. Dieser Converter nimmt eine exportierte .reg-Datei und erzeugt daraus das passende GPP-kompatible XML, das du direkt in ein Gruppenrichtlinienobjekt übernimmst.

Was das Tool macht#

Liest eine .reg-Datei und schreibt daneben eine GPP-Registry-Datei (<name>.reg.xml) im Microsoft-GPP-Format ([MS-GPPREF]) — der Gruppenrichtlinien-Editor übernimmt sie unverändert. Unterstützte Werttypen:

REG_SZ
REG_EXPAND_SZ
REG_MULTI_SZ
REG_BINARY
REG_DWORD
REG_QWORD

REG_NONE, REG_LINK und REG_DWORD_BIG_ENDIAN kennt GPP selbst nicht — solche Einträge werden übersprungen, mit einer Warnung samt betroffener Zeile.

Voraussetzungen#

PowerShell 3.0 oder neuer (auf jedem unterstützten Windows vorhanden).
Eine .reg-Datei im normalen regedit-Exportformat (beginnt mit Windows Registry Editor Version 5.00).

Verwendung#

# Einfachster Fall — erzeugt C:\Temp\MyApp.reg.xml im selben Ordner
.\Convert-RegToGppXml.ps1 -FilePath "C:\Temp\MyApp.reg"

# Mehrere Dateien auf einmal (Pfade mit Leerzeichen funktionieren)
.\Convert-RegToGppXml.ps1 -FilePath "C:\Temp\App settings.reg", "C:\Temp\Other.reg"

# Andere GPP-Aktion als die Standard-Aktion "Update"
.\Convert-RegToGppXml.ps1 -FilePath "C:\Temp\MyApp.reg" -ActionType Replace

Parameter#

Parameter	Erforderlich	Werte	Standard	Hinweise
`-FilePath`	ja	ein oder mehrere Pfade zu `.reg`-Dateien	–
`-ActionType`	nein	`Create`, `Update`, `Delete`, `Replace`	`Update`	wie GPP jeden Eintrag anwendet
`-BypassErrors`	nein	Switch	aus	schreibt `bypassErrors="1"`, damit ein fehlerhafter Wert die übrigen am Client nicht stoppt

XML in ein GPO übernehmen#

Die Ausgabe wird nicht über ein Menü importiert, sondern direkt in den Editor eingefügt:

GPO im Gruppenrichtlinien-Verwaltungs-Editor öffnen.
Zu Computerkonfiguration bzw. Benutzerkonfiguration → Einstellungen → Windows-Einstellungen → Registrierung.
Die erzeugte .reg.xml im Texteditor öffnen und komplett kopieren.
Den Knoten Registrierung markieren und einfügen (Strg+V).

Der komplette Baum erscheint als Registrierungs-Einstellungen inklusive Sammlungen. Von dort kannst du Einträge entfernen oder Item-Level-Targeting ergänzen.

Gut zu wissen#

Große Dateien sind kein Problem. Das Skript streamt Ein- und Ausgabe, ein mehrere hundert MB großer Export bleibt gut im Speicher.
Defekte Schlüssel brechen nicht ab. Werte mit XML-unzulässigen Steuerzeichen (häufig unter HKCU\Software\Classes) würden die ganze Ausgabe zerstören; sie werden übersprungen, die Zeile protokolliert, und es geht weiter.
Kodierung ist UTF-8 mit XML-Deklaration — genau wie es die GPMC selbst schreibt.
Der changed-Zeitstempel wird in UTC geschrieben, wie es das GPP-Format verlangt.

Versionen & Quelle#

Die jeweils aktuelle Fassung samt Changelog liegt im GitHub-Repository. Ältere, bereits hier veröffentlichte Versionen findest du im Download-Bereich unten als Archiv.