From 65e4be3dfd76815ae3633645416fa654f31e8f69 Mon Sep 17 00:00:00 2001 From: rogier Date: Sun, 12 Oct 2025 11:28:36 +0200 Subject: [PATCH] Update README.md --- README.md | 249 +++++++++++++++++++++++++++--------------------------- 1 file changed, 123 insertions(+), 126 deletions(-) diff --git a/README.md b/README.md index f6250b2..d802d63 100644 --- a/README.md +++ b/README.md @@ -1,126 +1,123 @@ -# HHO PowerShell Configuratie Menu - -Dit is een alles-in-één PowerShell script dat alle verschillende configuraties voor HHO laptops combineert in een gebruiksvriendelijk menu. - -## Bestanden - -- `main-menu.ps1` - Het hoofdmenu PowerShell script -- `main-menu.cmd` - Batch wrapper voor eenvoudige uitvoering -- `apps/medewerkers.txt` - Lijst van apps voor medewerkers -- `apps/gasten.txt` - Lijst van apps voor gasten -- `scripts/` - Map met alle individuele scripts - -## Gebruik - -### Optie 1: Via Batch bestand (Aanbevolen) -Dubbelklik op `main-menu.cmd` of voer uit vanaf de command line: -``` -main-menu.cmd -``` - -### Optie 2: Direct PowerShell -Open PowerShell als Administrator en voer uit: -```powershell -.\main-menu.ps1 -``` - -## Menu Opties - -### 1. Get Serial Number -- Haalt het serienummer van de laptop op -- Slaat het op in een tekstbestand met formaat: `HOSTNAME_SERIAL.txt` -- Bevat ook computernaam, datum en tijd - -### 2. Set Background voor gebruikers en Administrator -- Downloadt de HHO achtergrondafbeelding van `https://hibbit.cloud/hho/background.jpg` -- Stelt deze in als bureaubladachtergrond voor alle gebruikers - -### 3. Install Apps -Submenu met twee opties: -- **a. Medewerkers configuratie** - Installeert apps uit `apps/medewerkers.txt` -- **b. Gasten configuratie** - Installeert apps uit `apps/gasten.txt` - -Beide opties: -- Controleren administrator rechten -- Controleren winget beschikbaarheid -- Installeren apps via winget met machine-wide scope -- Tonen voortgang per app - -### 4. Update Apps -- Update alle geïnstalleerde applicaties via winget -- Vereist administrator rechten -- Voert `winget upgrade --all` uit - -### 5. Update All (Complete systeem update) -- Voert het complete update script uit (`scripts/update-all.cmd`) -- Inclusief Windows updates, driver updates, applicatie updates en systeem optimalisatie -- Vereist administrator rechten -- Vraagt om bevestiging voordat het start - -### 6. Enable BitLocker Encryption -- Versleutelt de systeemschijf (C:) met BitLocker -- Genereert en slaat recovery key op in de `output` map -- Vereist administrator rechten en Windows Pro/Enterprise/Education -- Waarschuwt voor systeemherstel tijdens het proces -- Ondersteunt zowel nieuwe versleuteling als het ophalen van bestaande recovery keys - -## Vereisten - -- Windows PowerShell 5.1 of hoger -- Administrator rechten voor opties 3, 4, 5 en 6 -- winget (Windows Package Manager) voor app installaties en updates -- Internetverbinding voor achtergrond download en app installaties -- Windows Pro/Enterprise/Education voor BitLocker functionaliteit (optie 6) - -## App Configuratie Bestanden - -### medewerkers.txt -```powershell -$apps = @( - "Microsoft.DotNet.DesktopRuntime.8", - "Google.Chrome", - "Google.GoogleDrive", - "Google.ChromeRemoteDesktopHost", - "Dell.CommandUpdate", - "Logitech.OptionsPlus" -) -``` - -### gasten.txt -```powershell -$apps = @( - "Microsoft.DotNet.DesktopRuntime.8", - "Google.Chrome", - "Mozilla.Firefox", - "Google.Drive", - "Google.ChromeRemoteDesktopHost" - "Dell.CommandUpdate", - "Logitech.OptionsPlus", - "Notepad++.Notepad++", - "Microsoft.PowerToys", - "Sysinternals.Autologon" -) -``` - -## Foutafhandeling - -Het script bevat uitgebreide foutafhandeling voor: -- Ontbrekende administrator rechten -- Ontbrekende winget installatie -- Netwerkfouten bij downloads -- App installatie fouten -- Ontbrekende configuratie bestanden - -## Logging - -- Alle belangrijke acties worden gelogd naar het scherm -- Het update-all script maakt een `update-log.txt` bestand aan -- Serial number wordt opgeslagen in een tekstbestand - -## Ondersteuning - -Voor vragen of problemen, controleer: -1. Of je administrator rechten hebt -2. Of winget geïnstalleerd is -3. Of je internetverbinding hebt -4. Of de configuratie bestanden bestaan en correct zijn geformatteerd +# HHO PowerShell Configuratie Menu + +Dit is een alles-in-één PowerShell script dat alle verschillende configuraties voor HHO laptops combineert in een gebruiksvriendelijk menu. + +## Bestanden + +- `main-menu.ps1` - Het hoofdmenu PowerShell script +- `main-menu.cmd` - Batch wrapper voor eenvoudige uitvoering +- `apps/medewerkers.txt` - Lijst van apps voor medewerkers +- `apps/gasten.txt` - Lijst van apps voor gasten +- `scripts/` - Map met alle individuele scripts + +## Gebruik + +### Optie 1: Via Batch bestand (Aanbevolen) +Dubbelklik op `main-menu.cmd` of voer uit vanaf de command line: +``` +main-menu.cmd +``` + +### Optie 2: Direct PowerShell +Open PowerShell als Administrator en voer uit: +```powershell +.\main-menu.ps1 +``` + +## Menu Opties + +### 1. Get Serial Number +- Haalt het serienummer van de laptop op +- Slaat het op in een tekstbestand met formaat: `HOSTNAME_SERIAL.txt` +- Bevat ook computernaam, datum en tijd + +### 2. Set Background voor gebruikers en Administrator +- Downloadt de HHO achtergrondafbeelding van `https://hibbit.cloud/hho/background.jpg` +- Stelt deze in als bureaubladachtergrond voor alle gebruikers + +### 3. Install Apps +Submenu met twee opties: +- **a. Medewerkers configuratie** - Installeert apps uit `apps/medewerkers.txt` +- **b. Gasten configuratie** - Installeert apps uit `apps/gasten.txt` + +#### setup Autologon: +Terminal: `Autologon64` + +### 4. Update Apps +- Update alle geïnstalleerde applicaties via winget +- Vereist administrator rechten +- Voert `winget upgrade --all` uit + +### 5. Update All (Complete systeem update) +- Voert het complete update script uit (`scripts/update-all.cmd`) +- Inclusief Windows updates, driver updates, applicatie updates en systeem optimalisatie +- Vereist administrator rechten +- Vraagt om bevestiging voordat het start + +### 6. Enable BitLocker Encryption +- Versleutelt de systeemschijf (C:) met BitLocker +- Genereert en slaat recovery key op in de `output` map +- Vereist administrator rechten en Windows Pro/Enterprise/Education +- Waarschuwt voor systeemherstel tijdens het proces +- Ondersteunt zowel nieuwe versleuteling als het ophalen van bestaande recovery keys + +## Vereisten + +- Windows PowerShell 5.1 of hoger +- Administrator rechten voor opties 3, 4, 5 en 6 +- winget (Windows Package Manager) voor app installaties en updates +- Internetverbinding voor achtergrond download en app installaties +- Windows Pro/Enterprise/Education voor BitLocker functionaliteit (optie 6) + +## App Configuratie Bestanden + +### medewerkers.txt +```powershell +$apps = @( + "Microsoft.DotNet.DesktopRuntime.8", + "Google.Chrome", + "Google.GoogleDrive", + "Google.ChromeRemoteDesktopHost", + "Dell.CommandUpdate", + "Logitech.OptionsPlus" +) +``` + +### gasten.txt +```powershell +$apps = @( + "Microsoft.DotNet.DesktopRuntime.8", + "Google.Chrome", + "Mozilla.Firefox", + "Google.Drive", + "Google.ChromeRemoteDesktopHost" + "Dell.CommandUpdate", + "Logitech.OptionsPlus", + "Notepad++.Notepad++", + "Microsoft.PowerToys", + "Sysinternals.Autologon" +) +``` + +## Foutafhandeling + +Het script bevat uitgebreide foutafhandeling voor: +- Ontbrekende administrator rechten +- Ontbrekende winget installatie +- Netwerkfouten bij downloads +- App installatie fouten +- Ontbrekende configuratie bestanden + +## Logging + +- Alle belangrijke acties worden gelogd naar het scherm +- Het update-all script maakt een `update-log.txt` bestand aan +- Serial number wordt opgeslagen in een tekstbestand + +## Ondersteuning + +Voor vragen of problemen, controleer: +1. Of je administrator rechten hebt +2. Of winget geïnstalleerd is +3. Of je internetverbinding hebt +4. Of de configuratie bestanden bestaan en correct zijn geformatteerd