> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/knowledge-base/fr/virtual-machines/emulate-usb.md).

# Émuler un périphérique USB

## Vue d’ensemble

{% hint style="info" %}
**Points clés**

* Créer des périphériques USB émulés pour les VM
* Permet la prise en charge des applications héritées
* Permet le hotplug du stockage pour l’installation des pilotes
* Nécessite une configuration VM spécifique
  {% endhint %}

## Prérequis

Avant de créer un périphérique USB émulé, assurez-vous que votre VM répond à ces exigences :

* Paramètres de la VM :
  * **Autoriser le hotplug** doit être activé
  * **Type de machine** doit être **9.0** ou supérieur
* Pilotes VirtIO installés dans le système d’exploitation invité

{% hint style="warning" %}
**Modifications du type de machine**

Avant de modifier le type de machine d’une VM, créez un instantané à court terme (expiration de 24 heures) afin de permettre un retour en arrière si nécessaire.
{% endhint %}

{% hint style="success" %}
**Installation des pilotes VirtIO**

* Les distributions Linux incluent généralement des pilotes VirtIO
* Sous Windows, les pilotes sont disponibles dans les ISO personnalisées VergeOS ou peuvent être téléchargés depuis : [Pilotes VirtIO](https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.iso)
  {% endhint %}

## Étapes pour créer un périphérique USB

1. **Accéder aux paramètres de la VM**
   * Accédez au tableau de bord de la VM (Machines virtuelles > Liste > Double-cliquez sur la VM cible )
2. **Créer un nouveau disque**
   * Cliquez **Lecteurs** dans le menu de gauche
   * Sélectionnez **Nouveau** dans le menu de gauche
3. **Configurer le périphérique USB**
   * Définir **Support** sur l’un des deux **Disque** ou **Disque cloné**
   * Définir **interface** à **USB**
   * Facultatif : saisissez un nom personnalisé (le système le générera automatiquement si le champ est vide)
   * Si vous utilisez Disque cloné, sélectionnez le fichier \*.raw approprié
4. **Activer le périphérique**
   * Cliquez **Soumettre** pour créer le périphérique
   * Sélectionnez le nouveau périphérique USB dans la liste des disques
   * Cliquez **Hotplug** dans le menu de gauche

Pour d’autres options de configuration du disque, voir : [Disques de la VM](/run-the-platform/virtual-machines/vm-drives.md)

## Dépannage

{% hint style="warning" %}
**Problèmes courants**

* **Problème**: Le périphérique reste à l’état « hot plugging »
  * **Solution**:
    1. Vérifiez les journaux du tableau de bord de la VM pour détecter des erreurs
    2. Vérifiez que toutes les conditions préalables sont remplies
    3. Essayez de redémarrer la VM si les paramètres ont été modifiés récemment
* **Problème**: Le périphérique apparaît hors ligne
  * **Solution**: Assurez-vous que le hotplug est activé et que les pilotes VirtIO sont installés
    {% endhint %}

***

{% hint style="info" %}
**Informations sur le document**

* Dernière mise à jour : 2024-11-19
* Version de VergeOS : 4.13
  {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.verge.io/knowledge-base/fr/virtual-machines/emulate-usb.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.