first commit

Hyper-V/Report_Checkpoint_HyperV.ps1/README.md

@@ -0,0 +1,56 @@
+## Funzionalità dello Script
+
+Questo script PowerShell serve per **monitorare e documentare lo stato dei checkpoint (snapshot) delle macchine virtuali Hyper-V** presenti sul server locale.
+
+### Operazioni Principali
+
+Lo script esegue le seguenti attività:
+
+**Raccolta Informazioni**
+- Recupera l'elenco completo di tutte le VM Hyper-V presenti sul sistema locale
+- Per ogni VM, conta il numero di checkpoint esistenti
+- Registra lo stato operativo corrente di ogni macchina virtuale (Running, Off, Saved, ecc.)
+
+**Generazione Report**
+- Crea un report strutturato contenente tre informazioni per ogni VM:
+  - **NomeVM**: il nome della macchina virtuale
+  - **StatoOperativo**: lo stato attuale (accesa, spenta, salvata)
+  - **NumeroCheckpoint**: il conteggio totale dei checkpoint presenti
+
+**Output**
+- Visualizza un'anteprima formattata a schermo per una verifica immediata
+- Esporta automaticamente i dati in formato CSV nel percorso `C:\temp\Report_Checkpoint_HyperV.csv`
+- Il CSV utilizza codifica UTF-8 e virgola come delimitatore
+
+---
+
+## Privilegi di Amministratore
+
+**Lo script DEVE essere eseguito con privilegi di amministratore.**
+
+### Motivi Tecnici
+
+I cmdlet utilizzati dallo script richiedono permessi elevati:
+
+- **Get-VM**: richiede diritti amministrativi per accedere al servizio di gestione Hyper-V (VMMS)
+- **Get-VMSnapshot**: necessita di permessi per interrogare la configurazione delle VM e i relativi checkpoint
+
+Senza privilegi elevati, lo script genererà errori di accesso negato e non potrà completare l'esecuzione.
+
+### Come Eseguirlo Correttamente
+
+Apri PowerShell con privilegi amministrativi:
+- Cerca "PowerShell" nel menu Start
+- Clicca con il tasto destro e seleziona **"Esegui come amministratore"**
+- Esegui lo script dal prompt elevato
+
+---
+
+## Utilità Pratica
+
+Questo script è particolarmente utile per:
+
+- **Auditing**: monitorare quanti checkpoint esistono per ciascuna VM
+- **Gestione dello spazio**: identificare VM con troppi checkpoint che occupano spazio su disco
+- **Compliance**: documentare periodicamente lo stato delle VM per scopi di conformità
+- **Housekeeping**: pianificare operazioni di pulizia dei checkpoint obsoleti