From 2ebbbd8a0c0752b0fb8d62fab8ce28f1f29120a2 Mon Sep 17 00:00:00 2001
From: maxxi <maxxi@gitea.de>
Date: Wed, 25 Mar 2026 23:27:48 +0100
Subject: [PATCH] add readme

---
 readme.md | 54 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 54 insertions(+)
 create mode 100644 readme.md

diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..c5f6cdf
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,54 @@
+# System Inventory Script (PowerShell)
+
+## 📖 Beschreibung
+
+Dieses PowerShell-Skript dient zur Erfassung der auf einem Windows-System installierten Software inklusive Versionsinformationen.
+
+Die Daten werden aus der Windows-Registry ausgelesen und anschließend als JSON-Datei exportiert. Der Dateiname enthält einen Zeitstempel, sodass mehrere Durchläufe versioniert gespeichert werden können.
+
+---
+
+## ⚙️ Funktionalität
+
+Das Skript führt folgende Schritte aus:
+
+1. **Auslesen installierter Software**
+
+   * Liest Einträge aus den Registry-Pfaden:
+
+     * `HKLM:\Software\Microsoft\Windows\CurrentVersion\Uninstall\*`
+     * `HKLM:\Software\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\*`
+   * Dadurch werden sowohl **64-Bit** als auch **32-Bit Anwendungen** erfasst
+
+2. **Filtern der Daten**
+
+   * Es werden nur Einträge berücksichtigt, die einen Anzeigenamen (`DisplayName`) besitzen
+
+3. **Extraktion relevanter Informationen**
+
+   * Name
+   * Version
+   * Publisher
+   * Installationsdatum
+
+4. **Datenbereinigung**
+
+   * Sortierung nach Name
+   * Entfernen von Duplikaten
+
+5. **Export**
+
+   * Ausgabe als JSON-Datei
+   * Dateiname enthält einen Zeitstempel (Format: `MM-dd-yyyy-HH-mm`)
+
+---
+
+## ▶️ Verwendung
+
+### Script ausführen
+
+```powershell
+.\Get-InstalledSoftware.ps1
+```
+
+Nach der Ausführung wird eine Datei im