diff --git a/docs/HyperV/Gestione1.md b/docs/HyperV/Gestione1.md new file mode 100644 index 0000000..f84146e --- /dev/null +++ b/docs/HyperV/Gestione1.md @@ -0,0 +1,129 @@ +--- +id: Gestione1 +sidebar_position: 0 +title: Gestione VM Hyper-V1 +sidebar_label: Gestione VM Hyper-V1 +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] + +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] + +* **PowerShell 7+** (necessario per gestione caratteri e compatibilità) [3, 4] + * Installazione da terminale amministratore su Windows: [3, 4] + ````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. +::: + +* **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]. + +--- + +#### 2️⃣ Creazione dei Commutatori Virtuali (Virtual Switch) [5, 6] + +Per consentire alle macchine virtuali di connettersi alla rete, è fondamentale creare uno o più commutatori virtuali. + +1. Aprire la console di gestione Hyper-V [5, 6]. +2. Dal menu a destra, selezionare **Gestione Commutatori Virtuali...** [5, 6]. + +* **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]. + +* **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]. + +:::tip +Dopo aver creato i commutatori, le VM potranno scegliere tra Wifi o Lan durante la configurazione della scheda di rete virtuale [7, 8]. +::: + +--- + +#### 3️⃣ Impostazioni Hyper-V [7, 8] + +Per mantenere l'organizzazione e prevenire problemi futuri con i percorsi di default, si raccomanda di configurare le impostazioni di Hyper-V [7, 8]. + +* **Cartella principale VM:** `` `D:\VMs` `` [7, 8] +* **Dischi virtuali:** `` `D:\VMs\Virtual Hard Disks` `` [7, 8] +* **Configurazioni VM:** `` `D:\VMs\Virtual Machines` `` [7, 8] + +:::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. +::: + +--- + +#### 4️⃣ 🚀 Uso dello script `VmManage.ps1` [7, 8] + +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] + +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]. +3. **Navigare** nella cartella dove è stato copiato lo script: [9, 10] + ````powershell + cd "C:\Users\\Documenti\VmManage" + ```` + +##### 4.2 Avvio dello script [9, 10] + +Eseguire lo script dal terminale PowerShell: +````powershell +.\VmManage.ps1 +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. + +-------------------------------------------------------------------------------- +5️⃣ Screenshot di esempio +Per una migliore comprensione visiva dei passaggi, sono disponibili screenshot per le seguenti azioni: +Azione +Screenshot +Screenshot del Commutatore Wifi +![Screenshot del Commutatore Wifi](/img/switch_wifi.png) +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)) + +-------------------------------------------------------------------------------- +💡 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. + +-------------------------------------------------------------------------------- +🔗 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 diff --git a/docs/HyperV/GestioneVm.md b/docs/HyperV/GestioneVm.md index 9c8da77..cb96405 100644 --- a/docs/HyperV/GestioneVm.md +++ b/docs/HyperV/GestioneVm.md @@ -1,6 +1,6 @@ --- id: GestioneVMHyperv -sidebar_position: 0 +sidebar_position: 1 title: Gestione VM HyperV sidebar_label: Gestione VM HyperV pagination_prev: null diff --git a/docs/HyperV/img/switch_lan.png b/docs/HyperV/img/switch_lan.png new file mode 100644 index 0000000..6cb5f65 Binary files /dev/null and b/docs/HyperV/img/switch_lan.png differ diff --git a/docs/HyperV/img/switch_wifi.png b/docs/HyperV/img/switch_wifi.png new file mode 100644 index 0000000..33d80b4 Binary files /dev/null and b/docs/HyperV/img/switch_wifi.png differ