> 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/es/administracion-del-sistema/usb-passthrough.md). # Passthrough USB Los dispositivos USB conectados a un host pueden transferirse a las VMs (y los inquilinos pueden transferirlos a sus VMs), permitiendo que un dispositivo aparezca y funcione como si estuviera conectado directamente dentro de la VM. Ejemplos de dispositivos USB en paso a través incluyen: * unidades que contienen claves de licencia de software * cámaras de seguridad/equipos de monitorización * teclado/ratón (compatible con el uso entre varias VMs; a menudo más conveniente que las configuraciones de VM de arranque dual/múltiple para hardware especializado) ## Instalación/configuración del host Las siguientes instrucciones configurarán el paso a través de dispositivos creando automáticamente una nueva regla para cada dispositivo seleccionado y adjuntando el/los dispositivo(s) al grupo de recursos. Para obtener más información sobre cómo funcionan los grupos de recursos y las reglas de recursos, consulte: [**Paso directo de dispositivos - Reglas de recursos**](/run-the-platform/es/administracion-del-sistema/device-pass-overview.md#resource-rules). 1. Vaya al **Panel de control del Administrador de recursos** (*Infraestructura > Recursos*) **-O-** Navegue a un **nodo específico** donde están conectados los dispositivos USB. (*Infraestructura > Nodos* > haga doble clic en el nodo deseado de la lista.) 2. Haga clic en **Dispositivos USB**. Se mostrará el listado de dispositivos USB detectados. {% hint style="success" %} **Un dispositivo USB que muestra un valor en la *****Grupo de recursos***** y *****Reglas de recursos***** columnas ya está configurado para paso a través.** {% endhint %} 3. **Seleccione** el **dispositivo(s) USB** de la lista. {% hint style="info" %} **Todos los dispositivos seleccionados se añadirán al mismo grupo de recursos (pool de recursos), pero se creará una regla de recursos independiente para cada uno.** {% endhint %} 4. Haga clic en **Crear recurso** en el menú de la izquierda. 5. **Crear un nuevo grupo de recursos USB** **-O-** **Seleccionar un grupo de recursos USB** de la lista. ### Campos del grupo de recursos USB * **Nombre**: etiqueta utilizada para identificar el grupo de recursos (es decir, el pool de dispositivos); utilice un nombre descriptivo para que los usuarios puedan identificar fácilmente el tipo de dispositivo(s) de este grupo. * **Tipo**: ***USB***. * **Descripción**: (opcional) campo para proporcionar más texto administrativo sobre el grupo de recursos. * **Clase**: permite seleccionar una clasificación general del dispositivo para el grupo; por ejemplo, dispositivo USB genérico, dispositivo de entrada humana, medios, etc. Este campo solo se utiliza para aplicar un icono asociado y no afecta a la funcionalidad. #### Configuración USB * **Permitir restablecimiento por el invitado**: Cuando está marcada, el usuario de la VM puede restablecer el dispositivo USB. * **Permitir todos los restablecimientos por el invitado**: Cuando está marcada, el usuario de la VM puede restablecer el concentrador USB al que está conectado el dispositivo. {% hint style="info" %} **La acción de restablecimiento de un dispositivo USB depende del controlador del dispositivo; algunos dispositivos admiten un restablecimiento y otros no.** {% endhint %} Después de seleccionar el grupo de recursos o crear uno nuevo, un \**Éxito* debería aparecer un mensaje indicando que se crearon reglas de recursos para el/los dispositivo(s). 6. **Puede ser necesario reiniciar el/los nodo(s) asociado(s)**; aparecerá un mensaje en la parte superior del panel del Administrador de recursos. {% hint style="warning" %} **Siga los** [**Modo de mantenimiento**](/run-the-platform/es/operaciones/maintenance-mode.md) **procedimientos adecuados al reiniciar un nodo para evitar interrupciones en las cargas de trabajo.** {% endhint %} El panel del grupo de recursos contiene las reglas de recursos que se generaron automáticamente para los dispositivos seleccionados. Puede hacer clic en una regla individual para ver los detalles de configuración. Una regla creada por el sistema puede modificarse según sea necesario; por ejemplo, el *Nodo* filtro puede cambiarse a *-- Ninguno --* para incluir dispositivos coincidentes de todos los nodos. La información sobre las reglas de recursos está disponible en: [**Resumen del paso directo de dispositivos - Reglas de recursos**](/run-the-platform/es/administracion-del-sistema/device-pass-overview.md#resource-rules) ## Configuración de VM/invitado 1. Vaya al **de la VM** (desde el menú superior: Máquinas virtuales > Lista > haga doble clic en la VM deseada en la lista) 2. Haga clic en **Dispositivos** en el menú de la izquierda. 3. Haga clic en **Nuevo** en el menú de la izquierda. {% hint style="success" %} **También puede adjuntar dispositivos a una VM a través del Administrador de recursos: desde el panel del grupo de recursos > haga doble clic en el grupo SR-IOV deseado > Ver dispositivos de máquina > Nuevo; seleccione la VM en la lista desplegable Máquina.** {% endhint %} ### Campos del formulario de entrada de dispositivos * **Nombre**: proporcione un nombre para identificar el dispositivo, p. ej. "clave de licencia de exapp" o déjelo en blanco para permitir que el sistema genere automáticamente un nombre de dispositivo. * **Tipo**: ***USB*** * **Descripción**(opcional): aquí se puede introducir texto adicional con fines administrativos. * **Grupo de recursos**: seleccione el grupo de recursos USB apropiado de la lista desplegable * **Configuración USB**: vea arriba. 4. Haga clic en **Enviar** para completar la adición del nuevo dispositivo. 5. Instale cualquier controlador cliente requerido; consulte la documentación de hardware del dispositivo, si es necesario. 6. La VM necesitará un **reinicio** para adjuntar el dispositivo. Desde el panel de la VM, haga clic en el *Reiniciar* enlace en el mensaje que aparece en la parte superior del panel, o haga clic en **Reiniciar** en el menú de la izquierda. ## Asignar un dispositivo USB a un inquilino Los dispositivos USB pueden asignarse a un inquilino para que este los asigne a sus propias VMs. Cuando asigne dispositivos USB al inquilino, se creará un nuevo grupo de recursos dentro del inquilino. {% hint style="info" %} **Cuando los dispositivos se comparten con un inquilino, se aprovisionan de forma gruesa (es decir, el inquilino pasa a ser el propietario de los dispositivos, por lo que no pueden asignarse a otras VM o inquilinos incluso cuando no están en uso.)** {% endhint %} 1. Navegue hasta el deseado **panel del inquilino** (desde el menú superior: Inquilinos > Lista > haga doble clic en el inquilino dentro de la lista.) 2. Haga clic en **Nodos** en el menú de la izquierda. 3. **Haga doble clic en uno de los nodos del inquilino**. 4. Haga clic en **Dispositivos** en el menú de la izquierda. 5. Haga clic en **Nuevo** en el menú de la izquierda. 6. Introduzca un **Nombre** o déjelo en blanco para permitir que el sistema cree automáticamente un nombre; este nombre se usará para el grupo de recursos creado en el inquilino. 7. **Tipo**: ***USB***. 8. **Descripción**: proporciona un lugar para almacenar información administrativa adicional sobre el dispositivo/pool de dispositivos. 9. **Configuración USB**: vea arriba. 10. Cuando los campos estén completados, haga clic en **Enviar** para finalizar el paso al inquilino. 11. El/los dispositivo(s) ahora estarán disponibles como un grupo de recursos para adjuntar a las VM del inquilino. Siga [**Configuración de VM/invitado**](#vmguest-configuration) las instrucciones anteriores. Para utilizar el dispositivo de passthrough, la VM debe ejecutarse en el nodo del inquilino donde está conectado el dispositivo. --- # 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/es/administracion-del-sistema/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.