# Hyper-V

Besonderer Dank an unseren Community-Beitragenden [@Jordanwise](https://forum.ewelink.cc/u/jordanwise) für das Erstellen und Teilen dieses hilfreichen Tutorial-Videos:

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

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

{% stepper %}
{% step %}
**Laden Sie das** CUBE OS **Image**

Besuchen Sie dieses [Repo](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) um das neueste `.vmdk` Image herunterzuladen. Bitte extrahieren Sie das Image nach dem Herunterladen.
{% endstep %}

{% step %}
**Installieren Sie Hyper-V**

Windows 10 / 11 Pro, Enterprise oder Education (Hyper-V erforderlich)

Hyper-V auf Ihrem System aktiviert: Bevor Sie Hyper-V verwenden, stellen Sie sicher, dass es in Windows aktiviert ist. Öffnen Sie **Systemsteuerung → Programme → Windows-Features ein- oder ausschalten**,&#x20;

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

aktivieren **Hyper-V** (einschließlich *Hyper-V-Verwaltungstools* und *Hyper-V-Plattform*), **Virtual Machine Platform**, **Windows Hypervisor Platform**, dann klicken Sie **OK** und starten Sie Ihren Computer neu.

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

Wenn Sie USB-Zigbee-Geräte hinzufügen müssen, beachten Sie bitte, dass Hyper-V keine native USB-Durchleitung für Hardwaregeräte wie Zigbee-Dongles unterstützt. Falls USB-Zugriff erforderlich ist, sollten Sie eine **USB-over-IP-Lösung** oder einen **netzwerkbasierten Zigbee-Koordinator** stattdessen in Betracht ziehen.
{% endstep %}
{% endstepper %}

### 2. Konvertieren des CUBE OS-Images in VHDX <a href="#id-2.-convert-the-cube-os-image-to-vhdx" id="id-2.-convert-the-cube-os-image-to-vhdx"></a>

Bevor Sie die virtuelle Maschine erstellen, konvertieren Sie das CUBE OS-Festplattenimage in ein Hyper-V- **VHDX** kompatibles Format.

{% stepper %}
{% step %}
Laden Sie ein Tool zur VM-Image-Konvertierung herunter und installieren Sie es, z. B. **VM Image Converter** (empfohlen für Windows)&#x20;

<div align="left"><figure><img src="https://1528069096-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 %}
Starten Sie den Konverter und wählen Sie:

* Quellformat: **VMDK**
* Zielformat: **VHDX**

<div align="left"><figure><img src="https://1528069096-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 %}
Schließen Sie die Konvertierung ab und merken Sie sich den Speicherort der erzeugten `.vhdx` Datei.

<div align="left"><figure><img src="https://1528069096-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. Erstellen der virtuellen Maschine <a href="#id-3.-create-the-virtual-machine" id="id-3.-create-the-virtual-machine"></a>

{% stepper %}
{% step %}
Starten Sie **Hyper-V-Manager**.

<div align="left"><figure><img src="https://1528069096-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 %}
Klicken Sie **Schnell erstellen** → Wählen![](https://1528069096-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)**Lokale Installationsquelle**.

<div align="left"><figure><img src="https://1528069096-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 %}
Wählen Sie **Installationsquelle ändern**, wählen Sie die konvertierte **CUBE OS `.vhdx`** Datei und deaktivieren Sie **Windows Secure Boot**.

<div align="left"><figure><img src="https://1528069096-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 %}
Geben Sie einen Namen für die VM ein (zum Beispiel, `CUBE OS`), und dann **Virtuelle Maschine erstellen**.
{% endstep %}
{% endstepper %}

### 4. Konfigurieren der Einstellungen der virtuellen Maschine <a href="#id-4.-configure-virtual-machine-settings" id="id-4.-configure-virtual-machine-settings"></a>

{% stepper %}
{% step %}
Klicken Sie **Einstellungen** für die neu erstellte virtuelle Maschine.

<div align="left"><figure><img src="https://1528069096-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 %}
Systemressourcen zuweisen:

* Minimum: **4096 MB (4 GB)**
* Deaktivieren Sie dynamischen Arbeitsspeicher (empfohlen).
* **Prozessor**: 2 virtuelle Prozessoren

<div align="left"><figure><img src="https://1528069096-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 %}
Klicken Sie **Übernehmen** und **OK** um die Einstellungen zu speichern.
{% endstep %}
{% endstepper %}

### 5. CUBE OS starten

{% stepper %}
{% step %}
Klicken Sie **Verbinden** und **Starten** Sie die erstellte virtuelle Maschine.

<div align="left"><figure><img src="https://1528069096-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 %}
Warten Sie einen Moment, bis CUBE OS initialisiert ist. Überwachen Sie den Boot-Bildschirm, bis der Startvorgang abgeschlossen ist.

<div align="left"><figure><img src="https://1528069096-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 %}
Nach Abschluss wird die IP von CUBE OS auf dem Bildschirm angezeigt. Verwenden Sie diese IP-Adresse oder [cube.local](http://cube.local/) um auf die CUBE OS-Webverwaltungsseite zuzugreifen.

<div align="left"><figure><img src="https://1528069096-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 %}
Nach erfolgreichem Zugriff kann auf der Einstellungsseite eine kurze ID angezeigt werden. Greifen Sie anschließend mit `cube-{short id}.local`auf die CUBE OS-Webverwaltungsseite zu, was nützlich ist, um mehrere CUBE OS-Instanzen im selben lokalen Netzwerk zu unterscheiden.

<div align="left"><figure><img src="https://1528069096-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/german/erste-schritte/quickstart/virtual-machine/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.