From c89e9ca909796d85f38237802cf75dbab58adf13 Mon Sep 17 00:00:00 2001 From: Ole Andre Werdal Date: Thu, 18 Jun 2026 11:13:28 +0200 Subject: [PATCH] first commit --- README.md | 69 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 69 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..54568f0 --- /dev/null +++ b/README.md @@ -0,0 +1,69 @@ +# W-tek Scriptbibliotek + +Internt, sentralt bibliotek for automatiserings- og driftsscript på tvers av plattformene vi forvalter: +**Windows Server, Microsoft 365, NinjaRMM, SentinelOne og Cove** – pluss delte hjelpefunksjoner. + +Målet er at script skal være lette å finne, trygge å kjøre, og dokumentert godt nok til at en kollega +kan ta dem i bruk uten å spørre forfatteren. + +## Mappestruktur + +Biblioteket er organisert **etter plattform/verktøy** på toppnivå, med funksjonelle undermapper: + +``` +script-library/ +├─ windows-server/ # Drift og herding av Windows Server +│ ├─ maintenance/ # Vedlikehold, opprydding, oppdatering +│ ├─ monitoring/ # Helsesjekker, statusrapporter +│ ├─ security-hardening/ # Herding, baseline, GPO +│ ├─ deployment/ # Utrulling, installasjon +│ └─ reporting/ # Rapporter og uttrekk +├─ microsoft-365/ # M365 / Entra / Exchange / Teams / SharePoint +│ ├─ entra-id/ +│ ├─ exchange-online/ +│ ├─ teams/ +│ ├─ sharepoint-onedrive/ +│ ├─ security-compliance/ +│ └─ reporting/ +├─ ninjarmm/ # Script som kjøres via NinjaRMM +│ ├─ automations/ +│ ├─ monitoring/ +│ ├─ software-deployment/ +│ └─ reporting/ +├─ sentinelone/ # SentinelOne drift og API +│ ├─ deployment/ +│ ├─ response-actions/ +│ ├─ reporting/ +│ └─ api/ +├─ cove/ # Cove Data Protection (backup) +│ ├─ backup-jobs/ +│ ├─ monitoring/ +│ └─ reporting/ +├─ _shared/ # Gjenbrukbare moduler, funksjoner og ressurser +│ ├─ modules/ +│ ├─ functions/ +│ └─ assets/ +├─ templates/ # Maler for nye script (PS1/SH/PY) + script-README +└─ docs/ # Overordnet dokumentasjon +``` + +Finnes det ikke en passende mappe? Opprett en ny undermappe i riktig plattform, og legg ved en kort `README.md`. + +## Slik legger du inn et nytt script + +1. Velg riktig plattform- og funksjonsmappe. +2. Kopier en mal fra `templates/` (`template.ps1`, `template.sh`, `template.py`). +3. Gi fila et beskrivende navn etter konvensjonen (se `CONTRIBUTING.md`). +4. Fyll ut **hele headeren** (synopsis, parametere, eksempel, forfatter, versjon, krav, endringslogg). +5. Enkle script kan ligge som én fil. Trenger scriptet flere filer/ressurser, lag en egen undermappe med en `README.md` (bruk `templates/SCRIPT_README_TEMPLATE.md`). +6. Commit på en egen branch og åpne en pull request for gjennomgang (se `CONTRIBUTING.md`). + +## Grunnregler + +- **Aldri hemmeligheter i repoet.** Ingen passord, API-nøkler, tokens eller kundedata. Bruk parametere, miljøvariabler eller en hemmelighetsløsning. +- **Alle script skal ha utfyllende header** og minst ett `EXAMPLE`. +- **Idempotent og trygt der mulig** – støtt `-WhatIf`/dry-run for endringer. +- **Test før merge** – beskriv hva som er testet og på hvilken versjon. +- **Én oppgave per script** – hold dem fokuserte og gjenbrukbare. + +Se `CONTRIBUTING.md` for fullstendige konvensjoner.