Quando si gestiscono molte macchine virtuali su un host VMware ESXi, l’organizzazione e la documentazione diventano fondamentali.
Annotare informazioni come proprietario, funzione della VM, reparto di riferimento o altre note operative permette di mantenere ordine e velocizzare le attività di amministrazione.
Tuttavia, farlo manualmente su decine (o centinaia) di VM può essere noioso e soggetto a errori.
In questo articolo vedremo come automatizzare il caricamento delle note nelle Virtual Machine partendo da un semplice file CSV e utilizzando PowerCLI, lo strumento di VMware che consente di gestire l’infrastruttura vSphere tramite PowerShell.
PREREQUISITI
- Sistema operativo Windows con PowerShell installato
- Modulo VMware.PowerCLI installato (Install-Module VMware.PowerCLI)
- Accesso al vCenter (utente con permessi di scrittura)
- File CSV strutturato con i seguenti campi:
- Name,Team, Owner, Ambiente, OS, Ticket,Descrizione, Descrizione Lunga
NOTA BENE: per installare il modulo Modulo PowerCLI eseguire da una Console Powershell con diritti Amministrativi il seguente comando:
|
0 |
Install-Module VMware.PowerCLI -Scope CurrentUser |
DESCRIZIONE DELLO SCRIPT
Lo script esegue le seguenti operazioni:
- Chiede il nome del vCenter a cui collegarsi
- Legge un file CSV contenente i nomi delle VM e i relativi metadati
Per ogni VM trovata nel vCenter:
- Recupera la data di creazione della VM (CreateDate) dal vSphere API
- Crea una sezione di note con i dati
- Se sono presenti note esistenti, aggiunge la nuova sezione (append)
- Altrimenti scrive la sezione ex novo
- Mostra un report delle VM modificate
SCRIPT COMPLETO
|
0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 |
# Richiesta del vCenter all'utente $vCenter = Read-Host "Inserisci il nome o l'indirizzo del vCenter" Connect-VIServer -Server $vCenter # Percorso del file CSV $csvPath = "C:\Temp\vm_info.csv" # Importa i dati $vms = Import-Csv -Path $csvPath # Lista delle VM su cui è stato fatto append $appendList = @() # INIZIO del ciclo foreach foreach ($entry in $vms) { $vmName = $entry.Name.Trim() $vm = Get-VM -Name $vmName -ErrorAction SilentlyContinue if (-not $vm) { Write-Host "VM non trovata, salto: $vmName" -ForegroundColor Yellow continue } # Mappatura con fallback $installationDate = if ($vm.ExtensionData.Config.CreateDate) { $vm.ExtensionData.Config.CreateDate } else { "N/A" } $requestor = if ($entry.Team) { $entry.Team } else { "N/A" } $owner = if ($entry.Owner) { $entry.Owner } else { "N/A" } $env = if ($entry.Ambiente) { $entry.Ambiente } else { "N/A" } $os = if ($entry.OS) { $entry.OS } else { "N/A" } $ticket = if ($entry.Ticket) { $entry.Ticket } else { "N/A" } # Campo Role derivato da Descrizione + Descrizione Lunga $role1 = if ($entry.Descrizione) { $entry.Descrizione } else { "" } $role2 = if ($entry.'Descrizione Lunga') { $entry.'Descrizione Lunga' } else { "" } if ($role1 -and $role2) { $role = "$role1 - $role2" } elseif ($role1) { $role = $role1 } elseif ($role2) { $role = $role2 } else { $role = "N/A" } # Nuova sezione da aggiungere alle note $newSection = @" --- Installation Date: $installationDate Requestor: $requestor Owner: $owner Env: $env Role: $role O.S.: $os Ticket: $ticket "@.Trim() # Note attuali (se presenti) $currentNote = $vm.ExtensionData.Summary.Config.Annotation if ($currentNote) { # Append $combinedNote = $currentNote.Trim() + "`n`n" + $newSection $appendList += $vmName Write-Host "Note esistenti trovate: append effettuato su $vmName" -ForegroundColor Cyan } else { # Prima scrittura $combinedNote = $newSection Write-Host "Note scritte ex novo su: $vmName" -ForegroundColor Green } # Aggiorna il campo Notes Set-VM -VM $vm -Notes $combinedNote -Confirm:$false } # ← QUESTA È LA GRAFFA DI CHIUSURA DEL foreach # Disconnessione dal vCenter Disconnect-VIServer -Server $vCenter -Confirm:$false # Report finale if ($appendList.Count -gt 0) { Write-Host "`nVM con note aggiornate in append:" -ForegroundColor Magenta $appendList | ForEach-Object { Write-Host "- $_" } } else { Write-Host "`nNessuna VM con note preesistenti. Nessun append effettuato." -ForegroundColor Gray } |
ESEMPIO DI BLOCCO NOTE FINALE
Installation Date: 2024-12-01T10:25:00Z
Requestor: TeamA
Owner: Mario Rossi
Env: PROD
Role: Web Server – Frontend NodeJS
O.S.: Ubuntu 24.04
Ticket: SR123456
CONSIGLI
ATTENZIONE: Eseguire lo script in test prima di usarlo in produzione…
Per preparare un backup delle note esistenti seguire l’articolo:
Esportazione in CSV del campo Note delle Virtual Machine su VMware ESXi tramite PowerCLI
0 commenti