Projekte / Reg-to-XML GPP Converter

Reg-to-XML GPP Converter

.reg-Dateien in GPP-kompatibles XML umwandeln und per Gruppenrichtlinie verteilen.

★ 1 aktualisiert 27. Juni 2026 GitHub ↗

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

XML in ein GPO übernehmen

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

1. GPO im Gruppenrichtlinien-Verwaltungs-Editor öffnen.
2. Zu Computerkonfiguration bzw. Benutzerkonfiguration → Einstellungen → Windows-Einstellungen → Registrierung.
3. Die erzeugte .reg.xml im Texteditor öffnen und komplett kopieren.
4. 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.