hyperv-scripts/Hyper-V/Report_Checkpoint_HyperV.ps1/README.md

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