> 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/fr/administration-systeme/usb-passthrough.md). # Pass-through USB Les périphériques USB connectés à un hôte peuvent être transmis aux VM (et aux locataires pour qu’ils les transmettent à leurs VM), ce qui permet à un périphérique d’apparaître et de se comporter comme s’il était directement connecté à la VM. Exemples de périphériques USB en passthrough : * des lecteurs contenant des clés de licence logicielle * caméras de sécurité/équipements de surveillance * clavier/souris (prenant en charge une utilisation entre plusieurs VM ; souvent plus pratique que les configurations VM à double/multi-amorçage pour le matériel spécialisé) ## Installation/Configuration de l’hôte Les instructions suivantes configureront le passage de périphériques en créant automatiquement une nouvelle règle pour chaque périphérique sélectionné et en attachant le ou les périphériques au groupe de ressources. Pour plus d’informations sur le fonctionnement des groupes de ressources et des règles de ressources, voir : [**Pass-through de périphérique - Règles de ressource**](/run-the-platform/fr/administration-systeme/device-pass-overview.md#resource-rules). 1. Accédez au **Tableau de bord du gestionnaire de ressources** (*Infrastructure > Ressources*) **-OU-** Accédez à un **nœud spécifique** où les périphériques USB sont branchés. (*Infrastructure > Nœuds* > double-cliquez sur le nœud souhaité dans la liste.) 2. Cliquez sur **Périphériques USB**. La liste des périphériques USB détectés s’affichera. {% hint style="success" %} **Un périphérique USB affichant une valeur dans les *****Groupe de ressources***** et *****Règles de ressources***** colonnes est déjà configuré pour le passthrough.** {% endhint %} 3. **Sélectionnez** le **périphérique(s) USB** dans la liste. {% hint style="info" %} **Tous les périphériques sélectionnés seront ajoutés au même groupe de ressources (pool de ressources), mais une règle de ressource distincte sera créée pour chacun.** {% endhint %} 4. Cliquez sur **Créer une ressource** dans le menu de gauche. 5. **Créer un nouveau groupe de ressources USB** **-OU-** **Sélectionner un groupe de ressources USB** dans la liste. ### Champs du groupe de ressources USB * **Nom**: libellé utilisé pour identifier le groupe de ressources (c.-à-d. le pool de périphériques) ; utilisez un nom descriptif afin que les utilisateurs puissent facilement identifier le type de périphérique(s) dans ce groupe. * **Type**: ***USB***. * **Description**: (facultatif) champ permettant de fournir davantage de texte administratif sur le groupe de ressources. * **Classe**: permet de sélectionner une classification générale du périphérique pour le groupe ; par exemple, périphérique USB générique, périphérique d’entrée humaine, média, etc. Ce champ n’est utilisé que pour appliquer une icône associée et n’affecte pas les fonctionnalités. #### Paramètres USB * **Autoriser la réinitialisation par l’invité**: Lorsque cette option est cochée, l’utilisateur de la VM peut réinitialiser le périphérique USB. * **Autoriser toutes les réinitialisations par l’invité**: Lorsque cette option est cochée, l’utilisateur de la VM peut réinitialiser le concentrateur USB auquel le périphérique est branché. {% hint style="info" %} **L’action de réinitialisation d’un périphérique USB dépend du pilote du périphérique ; certains périphériques prennent en charge la réinitialisation et d’autres non.** {% endhint %} Une fois le groupe de ressources sélectionné ou un nouveau créé, un \**Succès* message devrait apparaître indiquant que des règles de ressources ont été créées pour le ou les périphérique(s). 6. **Un redémarrage du ou des nœud(s) associés peut être nécessaire** ; un message apparaîtra en haut du tableau de bord du gestionnaire de ressources. {% hint style="warning" %} **Suivez les** [**Mode maintenance**](/run-the-platform/fr/operations/maintenance-mode.md) **procédures appropriées lors du redémarrage d’un nœud afin d’éviter les perturbations de charge de travail.** {% endhint %} Le tableau de bord du groupe de ressources contient les règles de ressource qui ont été générées automatiquement pour les périphériques sélectionnés. Vous pouvez cliquer sur une règle individuelle pour afficher les détails de configuration. Une règle créée par le système peut être modifiée selon les besoins ; par exemple, le *Nœud* filtre peut être modifié en *-- Aucun --* pour inclure les périphériques correspondants de tous les nœuds. Des informations concernant les règles de ressource sont disponibles à : [**Présentation du pass-through de périphérique - Règles de ressource**](/run-the-platform/fr/administration-systeme/device-pass-overview.md#resource-rules) ## Configuration de la VM / de l’invité 1. Accédez au **tableau de bord de la VM** (depuis le menu supérieur : Machines virtuelles > Liste > double-cliquez sur la VM souhaitée dans la liste) 2. Cliquez sur **Périphériques** dans le menu de gauche. 3. Cliquez sur **Nouveau** dans le menu de gauche. {% hint style="success" %} **Vous pouvez également associer des périphériques à une VM via le Gestionnaire de ressources : depuis le tableau de bord du groupe de ressources > double-cliquez sur le groupe SR-IOV souhaité > Afficher les périphériques de la machine > Nouveau ; sélectionnez la VM dans la liste déroulante Machine.** {% endhint %} ### Champs du formulaire d'entrée de périphérique * **Nom**: indiquez un nom pour identifier le périphérique, par ex. « clé de licence exapp » ou laissez vide pour permettre au système de générer automatiquement un nom de périphérique. * **Type**: ***USB*** * **Description**(facultatif) : du texte supplémentaire peut être saisi ici à des fins administratives. * **Groupe de ressources**: sélectionnez le groupe de ressources USB approprié dans la liste déroulante * **Paramètres USB**: voir ci-dessus. 4. Cliquez sur **Soumettre** pour terminer l’ajout du nouveau périphérique. 5. Installez les pilotes client requis ; consultez la documentation matérielle du périphérique, si nécessaire. 6. La VM aura besoin d’un **redémarrage** pour attacher le périphérique. Depuis le tableau de bord de la VM, cliquez sur le *Redémarrer* lien dans le message qui apparaît en haut du tableau de bord, ou cliquez sur **Redémarrer** dans le menu de gauche. ## Transmettre un périphérique USB à un locataire Les périphériques USB peuvent être transmis à un locataire pour que celui-ci les transmette à ses propres VM. Lorsque vous transmettez des périphériques USB au locataire, un nouveau groupe de ressources est créé dans le locataire. {% hint style="info" %} **Lorsque des périphériques sont partagés avec un tenant, ils sont provisionnés en dur (c.-à-d. que le tenant en devient propriétaire, ils ne peuvent donc pas être attribués à d’autres VM ou tenants même lorsqu’ils ne sont pas utilisés.)** {% endhint %} 1. Accédez au **tableau de bord du locataire** (depuis le menu supérieur : Tenants > Liste > double-cliquez sur le tenant dans la liste.) 2. Cliquez sur **Nœuds** dans le menu de gauche. 3. **Double-cliquez sur l’un des nœuds du tenant**. 4. Cliquez sur **Périphériques** dans le menu de gauche. 5. Cliquez sur **Nouveau** dans le menu de gauche. 6. Saisissez un **Nom** ou laissez vide pour permettre au système de créer automatiquement un nom ; ce nom sera utilisé pour le groupe de ressources créé dans le tenant. 7. **Type**: ***USB***. 8. **Description**: permet de stocker des informations administratives supplémentaires sur le périphérique/le pool de périphériques. 9. **Paramètres USB**: voir ci-dessus. 10. Une fois les champs renseignés, cliquez sur **Soumettre** pour terminer le transfert vers le tenant. 11. Le ou les périphérique(s) seront désormais disponibles en tant que groupe de ressources à attacher aux VM du tenant. Suivez [**Configuration de la VM / de l’invité**](#vmguest-configuration) les instructions ci-dessus. Afin d’utiliser le périphérique en passthrough, la VM doit s’exécuter sur le nœud du tenant où le périphérique est attaché. --- # 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/fr/administration-systeme/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.