diff --git a/docs/HyperV/Gestione1.md b/docs/HyperV/Gestione1.md index 55e7e59..fd5c441 100644 --- a/docs/HyperV/Gestione1.md +++ b/docs/HyperV/Gestione1.md @@ -7,123 +7,141 @@ pagination_prev: null hide_table_of_contents: true --- -### 🖥️ Gestione VM Hyper-V [3] -🎨 Guida passo-passo per configurare e gestire macchine virtuali Hyper-V [3, 4] -💡 **L’obiettivo:** avere un ambiente pronto per import/export VM e gestione dischi senza errori [3, 4] +### 🖥️ Gestione VM Hyper-V + +🎨 Guida passo-passo per configurare e gestire macchine virtuali Hyper-V + +💡 **L’obiettivo:** avere un ambiente pronto per import/export VM e gestione dischi senza errori Questa guida è pensata per sviluppatori e amministratori di sistema che necessitano di un ambiente Hyper-V organizzato e efficiente per la gestione delle macchine virtuali. --- -#### 1️⃣ Requisiti [3, 4] +#### 1️⃣ Requisiti -* **PowerShell 7+** (necessario per gestione caratteri e compatibilità) [3, 4] - * Installazione da terminale amministratore su Windows: [3, 4] +* **PowerShell 7+** (necessario per gestione caratteri e compatibilità) + * Installazione da terminale amministratore su Windows: ````powershell winget install --id Microsoft.Powershell --source winget ```` :::warning -Se è presente una versione precedente di PowerShell, si consiglia di rimuoverla prima di installare la versione 7+ [4, 5]. Le versioni precedenti potrebbero causare problemi di gestione dei caratteri e di compatibilità con lo script. +Se è presente una versione precedente di PowerShell, si consiglia di rimuoverla prima di installare la versione 7+. Le versioni precedenti potrebbero causare problemi di gestione dei caratteri e di compatibilità con lo script. ::: -* **Percorso dello script `VmManage.ps1`**: Lo script è progettato per facilitare le operazioni di **Import** ed **Export** delle VM [4, 5]. - * Il percorso di rete dello script è: `` `\\tecnopack.local\sviluppo\Virtuale_Machines\Virtual_Machine-Hyper-V\VmManage.ps1` `` [6]. +* **Percorso dello script `VmManage.ps1`**: Lo script è progettato per facilitare le operazioni di **Import** ed **Export** delle VM. + * Il percorso di rete dello script è: `` \\tecnopack.local\sviluppo\Virtuale_Machines\Virtual_Machine-Hyper-V\VMScript\VmManage.ps1 ``. --- -#### 2️⃣ Creazione dei Commutatori Virtuali (Virtual Switch) [5, 6] +#### 2️⃣ Creazione dei Commutatori Virtuali (Virtual Switch) -Per consentire alle macchine virtuali di connettersi alla rete, è fondamentale creare uno o più commutatori virtuali. +* #### Rimozione Sicura Virtual Switch -1. Aprire la console di gestione Hyper-V [5, 6]. -2. Dal menu a destra, selezionare **Gestione Commutatori Virtuali...** [5, 6]. + * Apri PowerShell come Amministratore. + * Elenca gli switch esistenti (opzionale ma consigliato), Questo ti permette di vedere quali switch verranno eliminati. + ````powershell + Get-VMSwitch + ```` + * Spegni le VM. + * Esegui il comando di rimozione. + ````powershell + Get-VMSwitch | Remove-VMSwitch -Force + ```` + * Verifica la rimozione (opzionale). + Esegui di nuovo il comando per elencare gli switch. Se tutto è andato a buon fine, non dovrebbe restituire alcun risultato. + ````powershell + Get-VMSwitch + ```` +#### Per consentire alle macchine virtuali di connettersi alla rete, è fondamentale creare uno o più commutatori virtuali. -* **Commutatore 1: Wifi** [5, 6] - * **Tipo:** Esterno [5, 6] - * **Collegato a:** scheda WiFi del PC host [5, 6] - * Permette alle VM di connettersi alla rete wireless [5]. +1. Aprire la console di gestione Hyper-V +2. Dal menu a destra, selezionare **Gestione Commutatori Virtuali...** + +* **Commutatore 1: Wifi** + * Commutatore Wifi + * **Tipo:** Esterno wifi + * **Collegato a:** scheda WiFi del PC host + * Permette alle VM di connettersi alla rete wireless. -* **Commutatore 2: Lan** [5, 6] - * **Tipo:** Esterno [5, 6] - * **Collegato a:** scheda di rete fisica del PC host [5, 6] - * Permette alle VM di connettersi alla rete cablata [6, 7]. + +* **Commutatore 2: Lan** + * Commutatore Wifi + * **Tipo:** Esterno + * **Collegato a:** scheda di rete fisica del PC host + * Permette alle VM di connettersi alla rete cablata. :::tip -Dopo aver creato i commutatori, le VM potranno scegliere tra Wifi o Lan durante la configurazione della scheda di rete virtuale [7, 8]. +Dopo aver creato i commutatori, le VM potranno scegliere tra Wifi o Lan durante la configurazione della scheda di rete virtuale. ::: --- -#### 3️⃣ Impostazioni Hyper-V [7, 8] +#### 3️⃣ Impostazioni Hyper-V -Per mantenere l'organizzazione e prevenire problemi futuri con i percorsi di default, si raccomanda di configurare le impostazioni di Hyper-V [7, 8]. +* **Percorso dello script `VmManage.ps1`**: Lo script è progettato per facilitare le operazioni di **Import** ed **Export** delle VM. + * Il percorso di rete dello script è: `` \\tecnopack.local\sviluppo\Virtuale_Machines\Virtual_Machine-Hyper-V\VMScript\VmManage.ps1 ``. -* **Cartella principale VM:** `` `D:\VMs` `` [7, 8] -* **Dischi virtuali:** `` `D:\VMs\Virtual Hard Disks` `` [7, 8] -* **Configurazioni VM:** `` `D:\VMs\Virtual Machines` `` [7, 8] +Per mantenere l'organizzazione e prevenire problemi futuri con i percorsi di default, si raccomanda di configurare le impostazioni di Hyper-V. + +* **Cartella principale VM:** `` D:\VMs `` +* **Dischi virtuali:** `` D:\VMs\Virtual Hard Disks `` +* **Configurazioni VM:** `` D:\VMs\Virtual Machines `` :::tip -**Si consiglia vivamente di impostare questi percorsi personalizzati *prima* di creare qualsiasi macchina virtuale** per garantire una migliore organizzazione e facilitare la gestione futura [7, 8]. Modificare questi percorsi dopo aver creato le VM può essere più complesso. +**Si consiglia vivamente di impostare questi percorsi personalizzati *prima* di creare qualsiasi macchina virtuale** per garantire una migliore organizzazione e facilitare la gestione futura. Modificare questi percorsi dopo aver creato le VM può essere più complesso. ::: --- -#### 4️⃣ 🚀 Uso dello script `VmManage.ps1` [7, 8] +#### 4️⃣ 🚀 Uso dello script `VmManage.ps1` Lo script `VmManage.ps1` è uno strumento utile per automatizzare le operazioni di **esportazione** e **importazione** di macchine virtuali Hyper-V. -##### 4.1 Preparazione [8, 9] +##### 4.1 Preparazione -1. **Copiare** `VmManage.ps1` in una cartella locale sul tuo PC, ad esempio `` `Documenti\VmManage` `` [8, 9]. -2. **Aprire PowerShell 7 come Amministratore** [9, 10]. +1. **Copiare** La cartella`VMScript` in locale sul tuo PC, ad esempio `` Documenti ``. +2. **Aprire PowerShell 7 come Amministratore**. 3. **Navigare** nella cartella dove è stato copiato lo script: [9, 10] ````powershell - cd "C:\Users\\Documenti\VmManage" + cd ~/Documenti\VMScript ```` -##### 4.2 Avvio dello script [9, 10] +##### 4.2 Avvio dello script Eseguire lo script dal terminale PowerShell: ````powershell .\VmManage.ps1 +```` +Commutatore Wifi Lo script presenterà delle opzioni o guiderà l'utente attraverso le seguenti funzionalità: -• Per Export (Esportazione di una VM): - ◦ Lo script spegne la macchina virtuale selezionata. - ◦ Copia i file della VM in una cartella con un timestamp (data e ora dell'esportazione), utile per versioning e backup. - ◦ Una volta completata la copia, riavvia la VM allo stato precedente. - ◦ Questa funzione è utile per creare backup o per preparare una VM per il trasferimento. -• Per Import (Importazione di una VM): - ◦ Permette di importare una VM precedentemente esportata. - ◦ Durante il processo, lo script chiederà di specificare un nuovo nome per la VM da importare. - ◦ Richiederà anche di indicare la cartella di destinazione dove verranno salvati i file della nuova VM. - ◦ Prima di procedere, lo script controlla lo spazio disponibile su disco per assicurarsi che ci sia sufficiente spazio per l'importazione. -4.3 Note pratiche -• Sempre avviare PowerShell come Amministratore per evitare errori di permessi durante l'esecuzione dello script o la gestione delle VM. -• Organizzare le VM e i dischi nelle cartelle consigliate per mantenere ordine e facilitare la gestione. -• Durante l'importazione, scegliere un nome chiaro e descrittivo per la nuova VM per identificarla facilmente. -Commutatore Wifi +Commutatore Wifi --------------------------------------------------------------------------------- -5️⃣ Screenshot di esempio -Per una migliore comprensione visiva dei passaggi, sono disponibili screenshot per le seguenti azioni: -Azione -Screenshot -![Screenshot del Commutatore Wifi](/img/screenshots/hyperv/switch_wifi.jpg) -Commutatore Lan -Impostazioni percorsi -Avvio script -(Nota: Qui andrebbero inseriti i tag immagine effettivi con i percorsi ai tuoi screenshot, ad esempio: ![Commutatore Wifi](img/commutatore-wifi.png)) +* Per Export E (Esportazione di una VM): + * Commutatore Wifi + * Lo script spegne la macchina virtuale selezionata. + * Copia i file della VM in una cartella con un timestamp (data e ora dell'esportazione), utile per versioning e backup. + * Una volta completata la copia, riavvia la VM allo stato precedente. + * Questa funzione è utile per creare backup o per preparare una VM per il trasferimento. +* Per Import I (Importazione di una VM): + * Commutatore Wifi + * Permette di importare una VM precedentemente esportata. + * Durante il processo, lo script chiederà di specificare un nuovo nome per la VM da importare. + * Richiederà anche di indicare la cartella di destinazione dove verranno salvati i file della nuova VM. + * Prima di procedere, lo script controlla lo spazio disponibile su disco per assicurarsi che ci sia sufficiente spazio per l'importazione. + +##### 4.3 Note pratiche +* Sempre avviare PowerShell come Amministratore per evitare errori di permessi durante l'esecuzione dello script o la gestione delle VM. +* Organizzare le VM e i dischi nelle cartelle consigliate per mantenere ordine e facilitare la gestione. +* Durante l'importazione, scegliere un nome chiaro e descrittivo per la nuova VM per identificarla facilmente. -------------------------------------------------------------------------------- 💡 Suggerimenti rapidi: -• ✅ Sempre seguire i percorsi consigliati per mantenere l'ambiente organizzato. -• ✅ Avviare PowerShell come amministratore per tutte le operazioni di gestione VM. -• ✅ Tenere uno spazio sufficiente su disco per le VM e le operazioni di import/export. -• ✅ Nominare VM e cartelle in modo chiaro e descrittivo. + * ✅ Sempre seguire i percorsi consigliati per mantenere l'ambiente organizzato. + * ✅ Avviare PowerShell come amministratore per tutte le operazioni di gestione VM. + * ✅ Tenere uno spazio sufficiente su disco per le VM e le operazioni di import/export. + * ✅ Nominare VM e cartelle in modo chiaro e descrittivo. -------------------------------------------------------------------------------- 🔗 Risorse utili: Documentazione Hyper-V -• Documentazione ufficiale Hyper-V di Microsoft: Per approfondire gli argomenti e risolvere problemi specifici. - ◦ Creare un commutatore virtuale in Hyper-V (Informazione non contenuta nelle fonti ma aggiunta per completezza e utilità, come discusso nella conversazione precedente) - ◦ Panoramica su PowerShell per Hyper-V (Informazione non contenuta nelle fonti ma aggiunta per completezza e utilità, come discusso nella conversazione precedente) \ No newline at end of file + * [Documentazione ufficiale Hyper-V di Microsoft: Per approfondire gli argomenti e risolvere problemi specifici.](https://learn.microsoft.com/en-us/virtualization/hyper-v-on-windows/) diff --git a/static/img/screenshots/hyperv/Script1.jpg b/static/img/screenshots/hyperv/Script1.jpg new file mode 100644 index 0000000..41de4f8 Binary files /dev/null and b/static/img/screenshots/hyperv/Script1.jpg differ diff --git a/static/img/screenshots/hyperv/Script2.jpg b/static/img/screenshots/hyperv/Script2.jpg new file mode 100644 index 0000000..42333d5 Binary files /dev/null and b/static/img/screenshots/hyperv/Script2.jpg differ diff --git a/static/img/screenshots/hyperv/ScriptE.jpg b/static/img/screenshots/hyperv/ScriptE.jpg new file mode 100644 index 0000000..8697448 Binary files /dev/null and b/static/img/screenshots/hyperv/ScriptE.jpg differ diff --git a/static/img/screenshots/hyperv/ScriptI.jpg b/static/img/screenshots/hyperv/ScriptI.jpg new file mode 100644 index 0000000..6312e62 Binary files /dev/null and b/static/img/screenshots/hyperv/ScriptI.jpg differ