# Hyper-V

Agradecimientos especiales a nuestro colaborador de la comunidad [@Jordanwise](https://forum.ewelink.cc/u/jordanwise) por crear y compartir este útil video tutorial:

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

### 1. Preparación <a href="#id-1.-prerequisites" id="id-1.-prerequisites"></a>

{% stepper %}
{% step %}
**Descargue el** CUBE OS **imagen**

Visite este [repositorio](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) para descargar la última `.vmdk` imagen. Por favor extraiga la imagen después de descargarla.
{% endstep %}

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

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

Hyper-V habilitado en su sistema: Antes de usar Hyper-V, asegúrese de que esté habilitado en Windows. Abra **Panel de control → Programas → Activar o desactivar las características de Windows**,&#x20;

<div align="left"><figure><img src="https://1438513814-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>

habilitar **Hyper-V** (incluyendo *Herramientas de administración de Hyper-V* y *Plataforma Hyper-V*), **Plataforma de máquina virtual**, **Plataforma del hipervisor de Windows**, luego haga clic en **OK** y reinicie su computadora.

<div align="left"><figure><img src="https://1438513814-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 %}
**Adaptador Zigbee (opcional)**

Si necesita agregar dispositivos Zigbee USB, tenga en cuenta que Hyper-V no admite el reenvío USB nativo para dispositivos de hardware como los dongles Zigbee. Si se requiere acceso USB, considere usar una **solución USB-over-IP** o un **coordinador Zigbee basado en red** en su lugar.
{% endstep %}
{% endstepper %}

### 2. Convertir la imagen de CUBE OS a VHDX <a href="#id-2.-convert-the-cube-os-image-to-vhdx" id="id-2.-convert-the-cube-os-image-to-vhdx"></a>

Antes de crear la máquina virtual, convierta la imagen de disco de CUBE OS a un **VHDX** formato compatible con Hyper-V.

{% stepper %}
{% step %}
Descargue e instale una herramienta de conversión de imágenes de máquina virtual, como **VM Image Converter** (recomendado en Windows)&#x20;

<div align="left"><figure><img src="https://1438513814-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 %}
Inicie el convertidor y seleccione:

* Formato de origen: **VMDK**
* Formato de destino: **VHDX**

<div align="left"><figure><img src="https://1438513814-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 %}
Complete la conversión y anote la ubicación del `.vhdx` archivo generado.

<div align="left"><figure><img src="https://1438513814-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. Crear la máquina virtual <a href="#id-3.-create-the-virtual-machine" id="id-3.-create-the-virtual-machine"></a>

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

<div align="left"><figure><img src="https://1438513814-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 %}
Haga clic en **Creación rápida** → Seleccionar![](https://1438513814-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)**Origen de instalación local**.

<div align="left"><figure><img src="https://1438513814-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 %}
Seleccione **Cambiar origen de instalación**, seleccione el **CUBE OS `.vhdx`** archivo convertido y desactive **Arranque seguro de Windows**.

<div align="left"><figure><img src="https://1438513814-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 %}
Introduzca un nombre para la máquina virtual (por ejemplo, `CUBE OS`), y luego **Crear máquina virtual**.
{% endstep %}
{% endstepper %}

### 4. Configurar los ajustes de la máquina virtual <a href="#id-4.-configure-virtual-machine-settings" id="id-4.-configure-virtual-machine-settings"></a>

{% stepper %}
{% step %}
Haga clic en **Configuración** para la máquina virtual recién creada.

<div align="left"><figure><img src="https://1438513814-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 %}
Asignar recursos del sistema:

* Mínimo: **4096 MB (4 GB)**
* Desactive la memoria dinámica (recomendado).
* **Procesador**: 2 procesadores virtuales

<div align="left"><figure><img src="https://1438513814-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 %}
Haga clic en **Aplicar** y **OK** para guardar los ajustes.
{% endstep %}
{% endstepper %}

### 5. Arrancar CUBE OS

{% stepper %}
{% step %}
Haga clic en **Conectar** y **Iniciar** la máquina virtual creada.

<div align="left"><figure><img src="https://1438513814-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 %}
Espere unos momentos a que CUBE OS se inicialice. Supervise la pantalla de arranque hasta que el proceso finalice.

<div align="left"><figure><img src="https://1438513814-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 vez completado, verá la IP de CUBE OS mostrada en la pantalla. Use esta dirección IP o [cube.local](http://cube.local/) para acceder a la página de gestión web de CUBE OS.

<div align="left"><figure><img src="https://1438513814-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 %}
Al acceder correctamente, se puede ver un ID corto en la página de configuración. Posteriormente, acceda a la página de gestión web de CUBE OS usando `cube-{short id}.local`, lo cual es útil para diferenciar múltiples instancias de CUBE OS en la misma red local.

<div align="left"><figure><img src="https://1438513814-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/cube-os-es/primeros-pasos/quickstart/maquina-virtual/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.