> 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/run-the-platform/de/systemadministration/usb-passthrough.md). # USB-Passthrough An einen Host angeschlossene USB-Geräte können an VMs weitergereicht werden (und von Mandanten an ihre VMs weitergereicht werden), sodass ein Gerät in der VM so erscheint und sich so verhält, als wäre es direkt an die VM angeschlossen. Beispiele für USB-Passthrough-Geräte sind: * Laufwerke mit Software-Lizenzschlüsseln * Überwachungskameras/Überwachungsgeräte * Tastatur/Maus (unterstützt die Nutzung über mehrere VMs hinweg; oft bequemer als Dual-/Multiboot-VM-Konfigurationen für Spezialhardware) ## Host-Installation/Konfiguration Die folgenden Anweisungen konfigurieren das Durchreichen von Geräten, indem für jedes ausgewählte Gerät automatisch eine neue Regel erstellt und das/die Gerät(e) der Ressourcengruppe zugeordnet werden. Weitere Informationen dazu, wie Ressourcengruppen und Ressourcenregeln funktionieren, finden Sie unter: [**Geräte-Passthrough - Ressourceregeln**](/run-the-platform/de/systemadministration/device-pass-overview.md#resource-rules). 1. Navigieren Sie zum **Dashboard des Ressourcenmanagers** (*Infrastruktur > Ressourcen*) **-ODER-** Navigieren Sie zu einem **spezifischer Knoten** an dem die USB-Geräte eingesteckt sind. (*Infrastruktur > Knoten* > Doppelklicken Sie auf den gewünschten Knoten in der Liste.) 2. Klicken Sie **USB-Geräte**. Die Liste der erkannten USB-Geräte wird angezeigt. {% hint style="success" %} **Ein USB-Gerät, das einen Wert in den *****Ressourcengruppe***** und *****Ressourcenregeln***** Spalten anzeigt, ist bereits für Passthrough konfiguriert.** {% endhint %} 3. **Wählen Sie** die entsprechende **USB-Gerät(e)** aus der Liste. {% hint style="info" %} **Alle ausgewählten Geräte werden derselben Ressourcengruppe (Ressourcenpool) hinzugefügt, aber für jedes wird eine separate Ressourcenregel erstellt.** {% endhint %} 4. Klicken Sie **Ressource erstellen** im linken Menü. 5. **Eine neue USB-Ressourcengruppe erstellen** **-ODER-** **Eine USB-Ressourcengruppe auswählen** aus der Liste. ### Felder der USB-Ressourcengruppe * **Namen**: Bezeichnung zur Identifizierung der Ressourcengruppe (d. h. des Gerätepools); verwenden Sie einen aussagekräftigen Namen, damit Benutzer den Gerätetyp bzw. die Gerätetypen in dieser Gruppe leicht erkennen können. * **Typ**: ***USB***. * **Beschreibung**: (optional) Feld für zusätzliche administrative Informationen zur Ressourcengruppe. * **Klasse**: ermöglicht die Auswahl einer allgemeinen Gerätekategorie für die Gruppe; zum Beispiel Generisches USB-Gerät, Eingabegerät, Medien usw. Dieses Feld wird nur verwendet, um ein zugehöriges Symbol anzuwenden, und hat keinen Einfluss auf die Funktionalität. #### USB-Einstellungen * **Gast-Reset erlauben**: Wenn aktiviert, kann der VM-Benutzer das USB-Gerät zurücksetzen. * **Gast-Resets für alle erlauben**: Wenn aktiviert, kann der VM-Benutzer den USB-Hub zurücksetzen, an den das Gerät angeschlossen ist. {% hint style="info" %} **Die Rücksetzfunktion eines USB-Geräts hängt vom Gerätetreiber ab; einige Geräte unterstützen ein Zurücksetzen, andere nicht.** {% endhint %} Nachdem die Ressourcengruppe ausgewählt oder eine neue erstellt wurde, ein \**Erfolgsmeldung* angezeigt werden, die darauf hinweist, dass Ressourceregeln für das/die Gerät(e) erstellt wurden. 6. **Ein Neustart des/der zugehörigen Knoten(s) kann erforderlich sein**; oben im Dashboard des Ressourcenmanagers wird eine Nachricht angezeigt. {% hint style="warning" %} **Befolgen Sie die korrekten** [**Wartungsmodus**](/run-the-platform/de/betrieb/maintenance-mode.md) **Verfahren beim Neustarten eines Knotens, um Unterbrechungen der Workloads zu vermeiden.** {% endhint %} Das Dashboard der Ressourcengruppe enthält die Ressourceregeln, die automatisch für Ihre ausgewählten Geräte generiert wurden. Sie können auf eine einzelne Regel klicken, um die Konfigurationsdetails anzuzeigen. Eine vom System erstellte Regel kann bei Bedarf angepasst werden; zum Beispiel kann der *Knoten* Filter zu *-- Keine --* geändert werden, um übereinstimmende Geräte von allen Knoten einzuschließen. Informationen zu Ressourceregeln finden Sie unter: [**Übersicht über das Geräte-Passthrough - Ressourceregeln**](/run-the-platform/de/systemadministration/device-pass-overview.md#resource-rules) ## VM/Gast-Konfiguration 1. Navigieren Sie zum **VM-Dashboard** (über das obere Menü: Virtuelle Maschinen > Liste > doppelklicken Sie in der Liste auf die gewünschte VM) 2. Klicken Sie **Geräte** im linken Menü. 3. Klicken Sie **Neu** im linken Menü. {% hint style="success" %} **Sie können Geräte einer VM auch über den Ressourcen-Manager zuweisen: vom Dashboard der Ressourcengruppe aus > doppelklicken Sie auf die gewünschte SR-IOV-Gruppe > Geräte der Maschine anzeigen > Neu; wählen Sie die VM aus der Dropdown-Liste Maschine aus.** {% endhint %} ### Felder des Geräte-Eintragsformulars * **Namen**: geben Sie einen Namen zur Identifizierung des Geräts an, z. B. „exapp license key“, oder lassen Sie das Feld leer, damit das System automatisch einen Gerätenamen erzeugt. * **Typ**: ***USB*** * **Beschreibung**(optional): Hier kann zusätzlicher Text für administrative Zwecke eingegeben werden. * **Ressourcengruppe**: wählen Sie die entsprechende USB-Ressourcengruppe aus der Dropdown-Liste * **USB-Einstellungen**: siehe oben. 4. Klicken Sie **Senden** um das Hinzufügen des neuen Geräts abzuschließen. 5. Installieren Sie alle erforderlichen Client-Treiber; konsultieren Sie bei Bedarf die Hardware-Dokumentation des Geräts. 6. Die VM benötigt einen **Neustart** um das Gerät anzuhängen. Klicken Sie im VM-Dashboard auf den *Neustart* Link in der Nachricht, die oben im Dashboard angezeigt wird, oder klicken Sie auf **Neustart** im linken Menü. ## Ein USB-Gerät an einen Mandanten durchreichen USB-Geräte können an einen Mandanten weitergereicht werden, damit der Mandant sie an seine eigenen VMs weiterreichen kann. Wenn Sie USB-Geräte an den Mandanten durchreichen, wird innerhalb des Mandanten eine neue Ressourcengruppe erstellt. {% hint style="info" %} **Wenn Geräte einem Tenant bereitgestellt werden, sind sie dick provisioniert (d. h. der Tenant besitzt die Geräte dann, sodass sie selbst dann keinen anderen VMs oder Tenants zugewiesen werden können, wenn sie nicht verwendet werden.)** {% endhint %} 1. Navigieren Sie zum gewünschten **Mandanten-Dashboard** (über das obere Menü: Tenants > Liste > doppelklicken Sie auf den Tenant in der Liste.) 2. Klicken Sie **Knoten** im linken Menü. 3. **Doppelklicken Sie auf einen der Tenant-Knoten**. 4. Klicken Sie **Geräte** im linken Menü. 5. Klicken Sie **Neu** im linken Menü. 6. Geben Sie einen **Namen** oder lassen Sie das Feld leer, damit das System automatisch einen Namen erstellt; dieser Name wird für die im Tenant erstellte Ressourcengruppe verwendet. 7. **Typ**: ***USB***. 8. **Beschreibung**: bietet einen Platz, um zusätzliche administrative Informationen über das Gerät/den Gerätepool zu speichern. 9. **USB-Einstellungen**: siehe oben. 10. Wenn die Felder ausgefüllt sind, klicken Sie auf **Senden** um das Durchreichen an den Tenant abzuschließen. 11. Das/Die Gerät(e) werden nun als Ressourcengruppe verfügbar sein, die an Tenant-VMs angehängt werden kann. Befolgen Sie die obigen Anweisungen. Um das Passthrough-Gerät zu verwenden, muss die VM auf dem Tenant-Knoten ausgeführt werden, an den das Gerät angeschlossen ist. [**VM/Gast-Konfiguration**](#vmguest-configuration) Anweisungen oben. Damit das Passthrough-Gerät verwendet werden kann, muss die VM auf dem Tenant-Knoten ausgeführt werden, an den das Gerät angeschlossen ist. --- # 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/run-the-platform/de/systemadministration/usb-passthrough.md?ask=&goal= ``` `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.