# Hyper‑V

Remerciements particuliers à notre contributeur communautaire [@Jordanwise](https://forum.ewelink.cc/u/jordanwise) pour avoir créé et partagé cette vidéo tutorielle utile :

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

### 1. Préparation <a href="#id-1.-prerequisites" id="id-1.-prerequisites"></a>

{% stepper %}
{% step %}
**Téléchargez le** CUBE OS **image**

Visitez ce [dépôt](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) pour télécharger le dernier `.vmdk` image. Veuillez extraire l'image après le téléchargement.
{% endstep %}

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

Windows 10 / 11 Pro, Enterprise ou Education (Hyper-V requis)

Hyper-V activé sur votre système : Avant d'utiliser Hyper-V, assurez-vous qu'il est activé dans Windows. Ouvrez **Panneau de configuration → Programmes → Activer ou désactiver des fonctionnalités Windows**,&#x20;

<div align="left"><figure><img src="/files/406a23dc15f3a59931eb42648d88331773533f3c" alt="" width="310"><figcaption></figcaption></figure></div>

activer **Hyper-V** (y compris *Outils de gestion Hyper-V* et *Plate-forme Hyper-V*), **Plateforme de machine virtuelle**, **Plateforme Hyperviseur Windows**, puis cliquez sur **OK** et redémarrez votre ordinateur.

<div align="left"><figure><img src="/files/0384648d09795136f78b5a66ecac72726869844f" alt="" width="332"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Adaptateur Zigbee (optionnel)**

Si vous devez ajouter des appareils Zigbee USB, veuillez noter que Hyper-V ne prend pas en charge le passage USB natif pour les périphériques matériels tels que les dongles Zigbee. Si l'accès USB est nécessaire, envisagez d'utiliser une **solution USB-over-IP** ou un **coordinateur Zigbee basé sur le réseau** à la place.
{% endstep %}
{% endstepper %}

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

Avant de créer la machine virtuelle, convertissez l'image disque CUBE OS en un format compatible avec Hyper-V **VHDX** compatible.

{% stepper %}
{% step %}
Téléchargez et installez un outil de conversion d'image VM, tel que **VM Image Converter** (recommandé sous Windows)&#x20;

<div align="left"><figure><img src="/files/ea89dac9b5fb1f3775b2ea4a086df1b294ca29fd" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Lancez le convertisseur et sélectionnez :

* Format source : **VMDK**
* Format cible : **VHDX**

<div align="left"><figure><img src="/files/c1305bd58ea48cb69319c335f1d697ca8dab3f00" alt="" width="360"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Terminez la conversion et notez l'emplacement du `.vhdx` fichier généré.

<div align="left"><figure><img src="/files/58cd0aabf876406537c036b5fd47ceadc25365af" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

### 3. Créer la machine virtuelle <a href="#id-3.-create-the-virtual-machine" id="id-3.-create-the-virtual-machine"></a>

{% stepper %}
{% step %}
Lancez **Gestionnaire Hyper-V**.

<div align="left"><figure><img src="/files/f096552b34673ca90a2416e2c60f0c2855a5e3c2" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Cliquez sur **Création rapide** → Sélectionner![](/files/76a79950942087ab9763da8be48fdab084a5801d)**Source d'installation locale**.

<div align="left"><figure><img src="/files/e515585dd4303b02f2bf2b71cca121ed95981b8a" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Sélectionnez **Modifier la source d'installation**, sélectionnez le **CUBE OS `.vhdx`** fichier converti et désactivez **Windows Secure Boot**.

<div align="left"><figure><img src="/files/cd58ffaf92262dd6bdf1a7a90cad9f0993ef4794" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Entrez un nom pour la VM (par exemple, `CUBE OS`), puis **Créer la machine virtuelle**.
{% endstep %}
{% endstepper %}

### 4. Configurer les paramètres de la machine virtuelle <a href="#id-4.-configure-virtual-machine-settings" id="id-4.-configure-virtual-machine-settings"></a>

{% stepper %}
{% step %}
Cliquez sur **Paramètres** pour la machine virtuelle nouvellement créée.

<div align="left"><figure><img src="/files/464c4c55297fdf0b0f4890ec98700c0b94fc1b62" alt="" width="375"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}
Attribuer des ressources système :

* Minimum : **4096 Mo (4 Go)**
* Désactivez la mémoire dynamique (recommandé).
* **Processeur** : 2 processeurs virtuels

<div align="left"><figure><img src="/files/63923447e185922d403f93c6cc0ec2d80d54a2ba" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Cliquez sur **Appliquer** et **OK** pour enregistrer les paramètres.
{% endstep %}
{% endstepper %}

### 5. Démarrer CUBE OS

{% stepper %}
{% step %}
Cliquez sur **Connecter** et **Démarrer** la machine virtuelle créée.

<div align="left"><figure><img src="/files/19d609b27b8aed55645b658c22cab0cdaae62010" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Attendez quelques instants que CUBE OS s'initialise. Surveillez l'écran de démarrage jusqu'à la fin du démarrage.

<div align="left"><figure><img src="/files/3c265356a864f78ff16d83aa63211d4e0bfc13f4" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Une fois terminé, l'adresse IP de CUBE OS s'affichera à l'écran. Utilisez cette adresse IP ou [cube.local](http://cube.local/) pour accéder à la page de gestion Web de CUBE OS.

<div align="left"><figure><img src="/files/21ab967e44c3521bc3ebc8554884aafce570561f" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Après un accès réussi, un identifiant court peut être consulté sur la page des paramètres. Ensuite, accédez à la page de gestion Web de CUBE OS en utilisant `cube-{short id}.local`, ce qui est utile pour différencier plusieurs instances de CUBE OS sur le même réseau local.

<div align="left"><figure><img src="/files/e56a5a44887371cd3215995963fba526a7c5300a" 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-fr/prise-en-main/quickstart/machine-virtuelle/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.