Windows-Installer

Der MSI-Installer ist der bequemste Weg auf einer Windows-Workstation. Er packt die CLI, registriert sie im PATH und installiert die VS Code Extension wenn VS Code gefunden wird.

Download

Hol den Installer aus dem Portal unter /downloads. Du brauchst dafür eine aktive Subscription oder einen laufenden Trial.

Die Datei heisst codeguard-X.Y.Z-installer.msi. Etwa 8 MB gross, weil .NET-Runtime nicht mitgebracht werden muss, der Installer ist framework-dependent und nutzt das auf der Maschine installierte .NET.

Installation

Doppelklick auf die MSI, "Next" durchklicken, fertig. Per Default installiert nach C:\Program Files\CodeGuard\.

Für stille Installation (z.B. via Group Policy oder MDM):

msiexec /i codeguard-X.Y.Z-installer.msi /qn

Mit Logging:

msiexec /i codeguard-X.Y.Z-installer.msi /qn /l*v install.log

Was der Installer macht

1. CLI ablegen unter C:\Program Files\CodeGuard\codeguard.exe.
2. PATH ergänzen systemweit. Eine neue PowerShell oder ein neues Terminal sieht das Binary danach direkt.
3. VS Code Extension installieren, falls code im PATH gefunden wird. Andernfalls überspringt der Installer diesen Schritt, du kannst die VSIX später manuell installieren.
4. Versions-Registry-Key schreiben unter HKLM\SOFTWARE\CodeGuard damit der Installer Upgrades sauber erkennt.

Update

Der Installer überschreibt die alte Version. Lade einfach die neue MSI und führe sie aus.

Wenn ihr Updates per Skript verteilt, ist der Versions-Registry-Key verlässlich:

(Get-ItemProperty 'HKLM:\SOFTWARE\CodeGuard').Version

Deinstallation

Über "Apps & Features" oder per Kommandozeile:

msiexec /x codeguard-X.Y.Z-installer.msi /qn

Der Deinstaller entfernt nur die installierten Dateien und PATH-Einträge. Deine .cgr-Dateien in euren Repos bleiben unangetastet.

Wenn ihr ohne Installer arbeiten wollt

Auf CI oder in Docker ist der MSI unhandlich. Nutzt dafür die Standalone-CLI, ist ein einzelnes ZIP mit einem Binary drin, kein Setup nötig.