> 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/de/virtual-machines/emulate-usb.md).

# Ein USB-Gerät emulieren

## Überblick

{% hint style="info" %}
**Wichtige Punkte**

* Emulierte USB-Geräte für VMs erstellen
* Ermöglicht die Unterstützung älterer Anwendungen
* Ermöglicht das Hotpluggen von Speicher für die Treiberinstallation
* Erfordert eine bestimmte VM-Konfiguration
  {% endhint %}

## Voraussetzungen

Bevor Sie ein emuliertes USB-Gerät erstellen, stellen Sie sicher, dass Ihre VM diese Anforderungen erfüllt:

* VM-Einstellungen:
  * **Hotplug zulassen** muss aktiviert sein
  * **Maschinentyp** muss **9.0** oder höher sein
* VirtIO-Treiber im Gastbetriebssystem installiert

{% hint style="warning" %}
**Änderungen am Maschinentyp**

Bevor Sie den Maschinentyp einer VM ändern, erstellen Sie einen kurzfristigen Snapshot (Ablauf nach 24 Stunden), um bei Bedarf ein Rollback zu ermöglichen.
{% endhint %}

{% hint style="success" %}
**VirtIO-Treiberinstallation**

* Linux-Distributionen enthalten in der Regel VirtIO-Treiber
* Für Windows sind die Treiber in den benutzerdefinierten VergeOS-ISOs verfügbar oder können von hier heruntergeladen werden: [VirtIO-Treiber](https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.iso)
  {% endhint %}

## Schritte zum Erstellen eines USB-Geräts

1. **VM-Einstellungen aufrufen**
   * Navigieren Sie zum VM-Dashboard (Virtual Machines > List > Doppelklicken Sie auf Ihre Ziel-VM)
2. **Neues Laufwerk erstellen**
   * Klicken Sie **Laufwerke** im linken Menü
   * Wählen Sie **Neu** über das linke Menü
3. **USB-Gerät konfigurieren**
   * Setzen Sie **Medium** auf entweder **Festplatte** oder **Festplatte klonen**
   * Setzen Sie **Schnittstelle** zu **USB**
   * Optional: Geben Sie einen benutzerdefinierten Namen ein (das System generiert automatisch einen, wenn das Feld leer ist)
   * Wenn Sie Festplatte klonen verwenden, wählen Sie die entsprechende \*.raw-Datei aus
4. **Gerät aktivieren**
   * Klicken Sie **Absenden** um das Gerät zu erstellen
   * Wählen Sie das neue USB-Gerät aus der Laufwerksliste aus
   * Klicken Sie **Hotplug** im linken Menü

Weitere Optionen zur Laufwerkskonfiguration finden Sie unter: [VM-Laufwerke](/run-the-platform/virtual-machines/vm-drives.md)

## Fehlerbehebung

{% hint style="warning" %}
**Häufige Probleme**

* **Problem**: Gerät bleibt im Status „hot plugging“
  * **Lösung**:
    1. Überprüfen Sie die Protokolle des VM-Dashboards auf Fehler
    2. Stellen Sie sicher, dass alle Voraussetzungen erfüllt sind
    3. Versuchen Sie, die VM neu zu starten, wenn die Einstellungen kürzlich geändert wurden
* **Problem**: Gerät wird als offline angezeigt
  * **Lösung**: Stellen Sie sicher, dass Hotplug aktiviert ist und die VirtIO-Treiber installiert sind
    {% endhint %}

***

{% hint style="info" %}
**Dokumentinformationen**

* Zuletzt aktualisiert: 2024-11-19
* VergeOS-Version: 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/de/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.