# Hyper-V

Un ringraziamento speciale al nostro contributore della community [@Jordanwise](https://forum.ewelink.cc/u/jordanwise) per aver creato e condiviso questo utile video tutorial:

{% embed url="<https://www.youtube.com/watch?v=StVw-60Piuk>" %}

### 1. Preparazione <a href="#id-1.-prerequisites" id="id-1.-prerequisites"></a>

{% stepper %}
{% step %}
**Scarica il** CUBE OS **immagine**

Visita questo [repository](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) per scaricare l'ultima `.vmdk` immagine. Si prega di estrarre l'immagine dopo il download.
{% endstep %}

{% step %}
**Installa Hyper-V**

Windows 10 / 11 Pro, Enterprise o Education (richiesto Hyper-V)

Hyper-V abilitato sul tuo sistema: prima di usare Hyper-V, assicurati che sia abilitato in Windows. Apri **Pannello di controllo → Programmi → Attiva o disattiva funzionalità Windows**,&#x20;

<div align="left"><figure><img src="https://2847557189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FWDcT9mnUIFijGtyKD6cm%2Fimage.png?alt=media&#x26;token=e436eae3-61cb-4e08-a3e0-612f0b37960b" alt="" width="310"><figcaption></figcaption></figure></div>

abilita **Hyper-V** (inclusi *Strumenti di gestione Hyper-V* e *Piattaforma Hyper-V*), **Piattaforma Macchina Virtuale**, **Piattaforma Hypervisor di Windows**, quindi fai clic su **OK** e riavvia il computer.

<div align="left"><figure><img src="https://2847557189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FULGXxO2KkrnniwM6CQvr%2Fimage.png?alt=media&#x26;token=0ce61757-dbf8-4ba5-9ab9-b8d635250028" alt="" width="332"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Adattatore Zigbee (opzionale)**

Se hai bisogno di aggiungere dispositivi Zigbee USB, nota che Hyper-V non supporta il passthrough USB nativo per dispositivi hardware come dongle Zigbee. Se è necessario l'accesso USB, considera l'uso di una **soluzione USB-over-IP** o un **coordinatore Zigbee basato su rete** invece.
{% endstep %}
{% endstepper %}

### 2. Convertire l'immagine CUBE OS in VHDX <a href="#id-2.-convert-the-cube-os-image-to-vhdx" id="id-2.-convert-the-cube-os-image-to-vhdx"></a>

Prima di creare la macchina virtuale, converti l'immagine del disco di CUBE OS in un formato Hyper-V **VHDX** compatibile.

{% stepper %}
{% step %}
Scarica e installa uno strumento di conversione immagine VM, come **VM Image Converter** (consigliato su Windows)&#x20;

<div align="left"><figure><img src="https://2847557189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FClQstydrldjmcLuKnY6J%2Fimage.png?alt=media&#x26;token=82d68ed0-cbdb-40ab-a655-43355f62d0d9" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Avvia il convertitore e seleziona:

* Formato sorgente: **VMDK**
* Formato di destinazione: **VHDX**

<div align="left"><figure><img src="https://2847557189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F7iCfbFg9ACqHTf4qWAMQ%2Fimage.png?alt=media&#x26;token=9cdf81ab-e4b2-4cd9-a75f-f6a265b57973" alt="" width="360"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Completa la conversione e annota la posizione del `.vhdx` file generato.

<div align="left"><figure><img src="https://2847557189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FQKS70hxaW1oTz6RCwmic%2Fimage.png?alt=media&#x26;token=eeffdb9e-2408-46aa-926e-a1be47ad6bb2" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

### 3. Crea la macchina virtuale <a href="#id-3.-create-the-virtual-machine" id="id-3.-create-the-virtual-machine"></a>

{% stepper %}
{% step %}
Avvia **Hyper-V Manager**.

<div align="left"><figure><img src="https://2847557189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FKLGnYhpnW4TUgAiSVzta%2Fimage.png?alt=media&#x26;token=27dfe2ee-cefa-473b-a5eb-397ecf905871" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Fai clic su **Creazione rapida** → Seleziona![](https://2847557189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F8yCryNG9EQ2ZML71mllN%2Fimage.png?alt=media\&token=d005ecdb-686a-4373-bf54-14a94a273d1f)**Sorgente di installazione locale**.

<div align="left"><figure><img src="https://2847557189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2Ff5qgA3WXeEw1KlNAQehR%2Fimage.png?alt=media&#x26;token=6f4f67dc-11c5-4f87-b794-26cb34e01b97" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Seleziona **Cambia sorgente di installazione**, seleziona il **CUBE OS `.vhdx`** file convertito e disabilita **Windows Secure Boot**.

<div align="left"><figure><img src="https://2847557189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FLekBkkamd2Hydx4xsEYv%2Fimage.png?alt=media&#x26;token=0ed27f1f-3756-4fdf-8dab-d3491a5ca132" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Inserisci un nome per la VM (per esempio, `CUBE OS`), e poi **Crea macchina virtuale**.
{% endstep %}
{% endstepper %}

### 4. Configura le impostazioni della macchina virtuale <a href="#id-4.-configure-virtual-machine-settings" id="id-4.-configure-virtual-machine-settings"></a>

{% stepper %}
{% step %}
Fai clic su **Impostazioni** per la macchina virtuale appena creata.

<div align="left"><figure><img src="https://2847557189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FlyxZ9KvMx4bpzL0cQEes%2Fimage.png?alt=media&#x26;token=e6cbd439-042d-4cef-821a-7d86bf1558bc" alt="" width="375"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}
Assegna risorse di sistema:

* Minimo: **4096 MB (4 GB)**
* Disabilita la Memoria Dinamica (consigliato).
* **Processore**: 2 processori virtuali

<div align="left"><figure><img src="https://2847557189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FZdfwbJkXE2NyfMI6Wcsb%2Fimage.png?alt=media&#x26;token=c941758a-e5b1-44ad-91e9-03f757a6434f" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Fai clic su **Applica** e **OK** per salvare le impostazioni.
{% endstep %}
{% endstepper %}

### 5. Avvia CUBE OS

{% stepper %}
{% step %}
Fai clic su **Connetti** e **Avvia** la macchina virtuale creata.

<div align="left"><figure><img src="https://2847557189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FafxqxaM2WCQFAmiBM1PL%2Fimage.png?alt=media&#x26;token=78525be1-b531-4151-af31-c4a3952da45e" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Attendi qualche istante affinché CUBE OS si inizializzi. Monitora lo schermo di avvio fino al completamento del boot.

<div align="left"><figure><img src="https://2847557189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FmsvbU2r30xq0WmtqjTLP%2Fimage.png?alt=media&#x26;token=bbe50140-3a33-4d18-92cf-43df705b49b1" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Una volta completato, vedrai l'IP di CUBE OS visualizzato sullo schermo. Usa questo indirizzo IP o [cube.local](http://cube.local/) per accedere alla pagina di gestione Web di CUBE OS.

<div align="left"><figure><img src="https://2847557189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F6T5sTzxEzfPdiYX1nH0t%2Fimage.png?alt=media&#x26;token=bc18e466-130b-42c2-9f1f-70e704895398" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Una volta effettuato l'accesso con successo, un ID breve sarà visibile nella pagina delle impostazioni. Successivamente, accedi alla pagina di gestione Web di CUBE OS usando `cube-{short id}.local`, che è utile per differenziare più istanze di CUBE OS sulla stessa rete locale.

<div align="left"><figure><img src="https://2847557189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FtKCHG1Z8FMgijVHgUxdU%2Fimage.png?alt=media&#x26;token=d0f0bc2f-9599-4b45-9c7c-61eb7af32ab4" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://cube.ewelink.cc/english-it/primi-passi/quickstart/macchina-virtuale/hyper-v.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.