Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
La extensión de controlador de GPU de NVIDIA para Windows instala controladores de GPU nvidia en máquinas virtuales de la serie N de Windows. En función de la familia de VM, la extensión instala los controladores CUDA o GRID. Al instalar controladores de NVIDIA mediante esta extensión, acepta y está de acuerdo con los términos del Contrato de licencia de usuario final de NVIDIA. Durante el proceso de instalación, es posible que la máquina virtual se reinicie para completar la instalación del controlador.
Las instrucciones para la instalación manual de los controladores y la lista de versiones compatibles actuales están disponibles para su revisión. Para más información, consulte Instalar controladores de GPU de NVIDIA en máquinas virtuales de la serie N que ejecutan Windows.
La extensión de controlador de GPU de NVIDIA también se puede implementar en máquinas virtuales de la serie N de Linux. Para más información, consulte Extensión del controlador de GPU de NVIDIA para Linux.
Note
Esta extensión seguirá usando v18.x hasta que finalice el lanzamiento de v20.x en el tercer trimestre del año calendario 2026.
Note
Las extensiones del controlador de GPU no actualizan automáticamente el controlador después de instalar la extensión. Si necesita migrar a una versión más reciente del controlador, descargue e instale el controlador manualmente o quite la extensión y vuelva a agregarla.
Note
Pruebe la asistencia de máquina virtual para un diagnóstico más rápido. Se recomienda ejecutar VM assist for Windows o VM assist for Linux. Estas herramientas de diagnóstico basadas en scripts le ayudan a identificar problemas comunes que afectan al agente invitado de máquina virtual de Azure y al estado general de la máquina virtual.
Si tiene problemas de rendimiento con máquinas virtuales, antes de ponerse en contacto con el soporte técnico, ejecute estas herramientas.
Prerequisites
Confirme que la máquina virtual cumple los requisitos previos para usar la extensión de controlador de GPU de NVIDIA.
Compatibilidad con sistema operativo
La extensión de controlador de GPU de NVIDIA admite las siguientes versiones de Windows:
| Distribution | Version |
|---|---|
| Windows 11 | Core |
| Windows 10 | Core |
| Windows Server 2022 | Core |
| Windows Server 2019 | Core |
| Windows Server 2016 | Core |
| Windows Server 2012 R2 | Core |
Se requiere conexión a Internet
La extensión de controlador de GPU de NVIDIA requiere que la máquina virtual de destino esté conectada a Internet y tenga acceso.
Revise el esquema de la extensión
En el siguiente fragmento de código JSON se muestra el esquema para la extensión:
{
"name": "<myExtensionName>",
"type": "extensions",
"apiVersion": "2015-06-15",
"location": "<location>",
"dependsOn": [
"[concat('Microsoft.Compute/virtualMachines/', <myVM>)]"
],
"properties": {
"publisher": "Microsoft.HpcCompute",
"type": "NvidiaGpuDriverWindows",
"typeHandlerVersion": "1.10",
"autoUpgradeMinorVersion": true,
"settings": {
}
}
}
Properties
El esquema JSON incluye valores para los parámetros siguientes.
| Name | Value/Example | Tipo de dato |
|---|---|---|
apiVersion |
2015-06-15 | date |
publisher |
Microsoft. HpcCompute | string |
type |
NvidiaGpuDriverWindows | string |
typeHandlerVersion |
1.10 | int |
Implementar la extensión
Azure las extensiones de máquina virtual se pueden administrar mediante las plantillas de CLI de Azure, PowerShell, Azure Resource Manager (ARM) y el portal de Azure.
Note
Algunos de los ejemplos siguientes usan valores de parámetro <placeholder> en los comandos. Antes de ejecutar cada comando, asegúrese de reemplazar los marcadores de posición por valores específicos de la configuración.
portal de Azure
Para instalar la extensión de controlador de GPU de NVIDIA en el portal de Azure, siga estos pasos:
En el portal Azure, vaya a la máquina virtual en la que desea instalar la extensión.
En Configuración, seleccione Extensiones y aplicaciones.
En Extensiones, seleccione + Agregar.
Busque y seleccione Extensión del controlador de GPU de NVIDIA y, a continuación, seleccione Siguiente.
Seleccione Revisar + crear. Confirme la acción de implementación y seleccione Crear.
Espere unos minutos a que la extensión se implemente.
Confirme que la extensión aparece como una extensión instalada para la máquina virtual.
ARM template
Las plantilla de ARM resultan ideales al implementar una o varias máquinas virtuales que requieren configurarse tras la implementación.
La configuración JSON de una extensión de máquina virtual puede estar anidada en el recurso de máquina virtual o colocada en la raíz o nivel superior de una plantilla de ARM JSON. La colocación de la configuración JSON afecta los valores name y type del recurso. Para obtener más información, consulte el artículo sobre cómo establecer el nombre y el tipo de recursos secundarios.
En el siguiente ejemplo se da por supuesto que la extensión está anidada dentro del recurso de máquina virtual. Cuando el recurso de extensión está anidado, el archivo JSON se coloca en el objeto "resources": [] de la máquina virtual.
{
"name": "<myExtensionName>",
"type": "extensions",
"location": "[<resourceGroup().location>]",
"apiVersion": "2015-06-15",
"dependsOn": [
"[concat('Microsoft.Compute/virtualMachines/', <myVM>)]"
],
"properties": {
"publisher": "Microsoft.HpcCompute",
"type": "NvidiaGpuDriverWindows",
"typeHandlerVersion": "1.10",
"autoUpgradeMinorVersion": true,
"settings": {
}
}
}
PowerShell
Use el siguiente comando de PowerShell para implementar la extensión de controlador de GPU de NVIDIA en una máquina virtual.
Set-AzVMExtension
-ResourceGroupName "<myResourceGroup>" `
-VMName "<myVM>" `
-Location "<location>" `
-Publisher "Microsoft.HpcCompute" `
-ExtensionName "NvidiaGpuDriverWindows" `
-ExtensionType "NvidiaGpuDriverWindows" `
-TypeHandlerVersion 1.10 `
-SettingString '{ `
}'
CLI de Azure
Ejecute el siguiente comando en el CLI de Azure para implementar la extensión de controlador de GPU de NVIDIA en una máquina virtual.
az vm extension set \
--resource-group <myResourceGroup> \
--vm-name <myVM> \
--name NvidiaGpuDriverWindows \
--publisher Microsoft.HpcCompute \
--version 1.10 \
--settings '{ \
}'
Solución de problemas
Estas son algunas sugerencias para solucionar problemas de implementación.
Comprobación del estado de extensión
Compruebe el estado de la implementación de la extensión en el portal de Azure o mediante PowerShell o el CLI de Azure.
Para ver el estado de implementación de las extensiones de una máquina virtual determinada, ejecute los comandos siguientes:
Get-AzVMExtension -ResourceGroupName <myResourceGroup> -VMName <myVM> -Name <myExtensionName>
az vm extension list --resource-group <myResourceGroup> --vm-name <myVM> -o table
Revisar los registros de salida
Vea los registros de salida de la implementación de la extensión de controlador de GPU de NVIDIA en C:\WindowsAzure\Logs\Plugins\Microsoft.HpcCompute.NvidiaGpuDriverWindows\.
Responder a códigos de error
En la tabla siguiente se enumeran los códigos de error comunes para la implementación y las posibles acciones de seguimiento.
| Error | Description | Action |
|---|---|---|
| 0 | Operación correcta. | No se requiere ninguna acción. |
| 1 | Operación correcta. | Reboot. |
| 100 | La operación no es compatible o no se pudo completar. | Compruebe los archivos de registro para determinar la causa del error, como: - No se admite la versión de PowerShell. - El tamaño de la máquina virtual no es una máquina virtual de la serie N. - Error durante la descarga de datos. |
| 240, 840 | Tiempo de espera de la operación. | Reintentar operación. |
| -1 | Se produjo una excepción. | Comprobar archivos de registro para determinar la causa de la excepción. |
| -5x | La operación se interrumpió debido a un reinicio pendiente. | Reinicie la máquina virtual. La instalación continúa después del reinicio. La desinstalación se debe invocar manualmente. |
Problemas conocidos
La versión del controlador GRID 17.x no es compatible con NVv3 (NVIDIA Tesla M60). Se admiten controladores GRID hasta la versión 16.5.
NvidiaGpuDriverWindows instala los controladores más recientes que no son compatibles con la SKU de NVv3. En su lugar, use la siguiente configuración en tiempo de ejecución para forzar la extensión a instalar una versión anterior del controlador. Para obtener más información sobre las versiones del controlador, consulte NVIDIA GPU resources.
az vm extension set --resource-group <rg-name> --vm-name <vm-name> --name NvidiaGpuDriverWindows --publisher Microsoft.HpcCompute --settings "{'driverVersion':'538.46'}"
{
"name": "NvidiaGpuDriverWindows",
"type": "extensions",
"apiVersion": "2015-06-15",
"location": "<location>",
"dependsOn": [
"[concat('Microsoft.Compute/virtualMachines/', <myVM>)]"
],
"properties": {
"publisher": "Microsoft.HpcCompute",
"type": "NvidiaGpuDriverWindows",
"typeHandlerVersion": "1.10",
"autoUpgradeMinorVersion": true,
"settings": {
"driverVersion": "538.46"
}
}
}
Obtener soporte técnico
Estas son otras opciones que le ayudarán a resolver los problemas de implementación:
Para obtener ayuda, póngase en contacto con los expertos de Azure en los foros de Q&A y Stack Overflow.
Si no encuentra una respuesta en el sitio, puede publicar una pregunta para la entrada de Microsoft u otros miembros de la comunidad.
También puede contactar con el soporte técnico de Microsoft. Para obtener información sobre el uso de Soporte técnico de Azure, lea las preguntas más frecuentes Soporte técnico de Azure.
Pasos siguientes
- Para obtener más información sobre las extensiones, consulte Extensiones de máquina virtual y características para Windows.
- Para obtener más información acerca de las VM de serie N, consulte el artículo Tamaños de máquinas virtuales optimizadas para GPU.