# Hyper-V

Szczególne podziękowania dla naszego współtwórcy społeczności [@Jordanwise](https://forum.ewelink.cc/u/jordanwise) za stworzenie i udostępnienie tego pomocnego wideo instruktażowego:

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

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

{% stepper %}
{% step %}
**Pobierz** CUBE OS **obraz**

Odwiedź to [repozytorium](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) aby pobrać najnowszy `.vmdk` obraz. Po pobraniu proszę rozpakować obraz.
{% endstep %}

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

Windows 10 / 11 Pro, Enterprise lub Education (wymagany Hyper-V)

Hyper-V włączony w systemie: przed użyciem Hyper-V upewnij się, że jest on włączony w Windows. Otwórz **Panel sterowania → Programy → Włącz lub wyłącz funkcje systemu Windows**,&#x20;

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

włącz **Hyper-V** (w tym *Narzędzia zarządzania Hyper-V* i *Platforma Hyper-V*), **Platforma maszyn wirtualnych**, **Platforma hyperwizora Windows**, następnie kliknij **OK** i uruchom ponownie komputer.

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

Jeśli musisz dodać urządzenia USB Zigbee, pamiętaj, że Hyper-V nie obsługuje natywnego przekazywania USB dla urządzeń sprzętowych, takich jak dongle Zigbee. Jeśli wymagany jest dostęp do USB, rozważ użycie **rozwiązania USB-over-IP** lub **opartego na sieci koordynatora Zigbee** zamiast tego.
{% endstep %}
{% endstepper %}

### 2. Konwersja obrazu CUBE OS do VHDX <a href="#id-2.-convert-the-cube-os-image-to-vhdx" id="id-2.-convert-the-cube-os-image-to-vhdx"></a>

Przed utworzeniem maszyny wirtualnej przekonwertuj obraz dysku CUBE OS na format zgodny z Hyper-V **VHDX** .

{% stepper %}
{% step %}
Pobierz i zainstaluj narzędzie do konwersji obrazów VM, takie jak **VM Image Converter** (zalecane na Windows)&#x20;

<div align="left"><figure><img src="https://2450271282-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 %}
Uruchom konwerter i wybierz:

* Format źródłowy: **VMDK**
* Format docelowy: **VHDX**

<div align="left"><figure><img src="https://2450271282-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 %}
Ukończ konwersję i zanotuj lokalizację wygenerowanego `.vhdx` pliku.

<div align="left"><figure><img src="https://2450271282-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. Utwórz maszynę wirtualną <a href="#id-3.-create-the-virtual-machine" id="id-3.-create-the-virtual-machine"></a>

{% stepper %}
{% step %}
Uruchom **Menedżera Hyper-V**.

<div align="left"><figure><img src="https://2450271282-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 %}
Kliknij **Szybkie tworzenie** → Wybierz![](https://2450271282-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)**Lokalne źródło instalacji**.

<div align="left"><figure><img src="https://2450271282-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 %}
Wybierz **Zmień źródło instalacji**, wybierz przekonwertowany **CUBE OS `.vhdx`** plik i wyłącz **Windows Secure Boot**.

<div align="left"><figure><img src="https://2450271282-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 %}
Wprowadź nazwę VM (na przykład, `CUBE OS`), a następnie **Utwórz maszynę wirtualną**.
{% endstep %}
{% endstepper %}

### 4. Skonfiguruj ustawienia maszyny wirtualnej <a href="#id-4.-configure-virtual-machine-settings" id="id-4.-configure-virtual-machine-settings"></a>

{% stepper %}
{% step %}
Kliknij **Ustawienia** dla nowo utworzonej maszyny wirtualnej.

<div align="left"><figure><img src="https://2450271282-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 %}
Przydziel zasoby systemowe:

* Minimum: **4096 MB (4 GB)**
* Wyłącz Dynamiczną pamięć (zalecane).
* **Procesor**: 2 wirtualne procesory

<div align="left"><figure><img src="https://2450271282-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 %}
Kliknij **Zastosuj** i **OK** aby zapisać ustawienia.
{% endstep %}
{% endstepper %}

### 5. Uruchom CUBE OS

{% stepper %}
{% step %}
Kliknij **Połącz** i **Uruchom** utworzoną maszynę wirtualną.

<div align="left"><figure><img src="https://2450271282-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 %}
Poczekaj chwilę, aż CUBE OS się zainicjuje. Monitoruj ekran rozruchu, aż rozruch zostanie zakończony.

<div align="left"><figure><img src="https://2450271282-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 %}
Po zakończeniu na ekranie zobaczysz wyświetlony adres IP CUBE OS. Użyj tego adresu IP lub [cube.local](http://cube.local/) aby uzyskać dostęp do strony zarządzania siecią Web CUBE OS.

<div align="left"><figure><img src="https://2450271282-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 %}
Po pomyślnym dostępie na stronie ustawień można zobaczyć krótki identyfikator. Następnie uzyskaj dostęp do strony zarządzania CUBE OS przy użyciu `cube-{short id}.local`, co jest przydatne do odróżnienia wielu instancji CUBE OS w tej samej sieci lokalnej.

<div align="left"><figure><img src="https://2450271282-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-pl/rozpoczecie/quickstart/maszyna-wirtualna/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.