Extensão dos controladores GPU NVIDIA para Windows

A extensão de driver de GPU NVIDIA para Windows instala drivers de GPU NVIDIA em máquinas virtuais (VMs) da série N do Windows. Dependendo da família VM, a extensão instala drivers CUDA ou GRID. Quando você instala drivers NVIDIA usando esta extensão, você aceita e concorda com os termos do Contrato de Licença de Usuário Final da NVIDIA. Durante o processo de instalação, a VM pode reinicializar para concluir a configuração do driver.

As instruções para a instalação manual dos drivers e a lista de versões suportadas atuais estão disponíveis para revisão. Para obter mais informações, consulte Instalar drivers de GPU NVIDIA em VMs da série N que executam o Windows.

A NVIDIA GPU Driver Extension também pode ser implantada em VMs Linux série N. Para obter mais informações, consulte NVIDIA GPU Driver Extension for Linux.

Note

As extensões de driver da GPU não atualizam automaticamente o driver após a instalação da extensão. Se precisar mudar para uma versão mais recente do driver, deve de manualmente descarregar e instalar o driver ou remover e voltar a adicionar a extensão.

Prerequisites

Confirme se sua máquina virtual satisfaz os pré-requisitos para usar a extensão de driver de GPU NVIDIA.

Suporte de sistema operativo

A extensão de driver de GPU NVIDIA suporta as seguintes versões do 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

Ligação à Internet necessária

A extensão de driver de GPU NVIDIA requer que a VM de destino esteja conectada à Internet e tenha acesso.

Revise o esquema de extensão

O trecho JSON a seguir mostra o esquema para a extensão:

{
  "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

O esquema JSON inclui valores para os seguintes parâmetros.

Name	Value/Example	Data type
`apiVersion`	2015-06-15	date
`publisher`	Microsoft.HpcCompute	cadeia (de caracteres)
`type`	NvidiaGpuDriverWindows	cadeia (de caracteres)
`typeHandlerVersion`	1.10	int

Implantar a extensão

As extensões de VM do Azure podem ser gerenciadas usando a CLI do Azure, o PowerShell, os modelos do Azure Resource Manager (ARM) e o portal do Azure.

Note

Alguns dos exemplos a seguir usam <placeholder> valores de parâmetro nos comandos. Antes de executar cada comando, certifique-se de substituir quaisquer valores de espaço reservado por valores específicos para sua configuração.

portal do Azure

Para instalar a extensão de driver de GPU NVIDIA no portal do Azure, execute estas etapas:

In the Azure portal, go to the virtual machine on which you want to install the extension.
Under Settings, select Extensions + Applications.
Under Extensions, select + Add.
Localize e selecione NVIDIA GPU Driver Extension e, em seguida, selecione Next.
Selecione Rever + criar. Confirm the deployment action, and select Create.

Aguarde alguns minutos até que a extensão seja implantada.
Confirme se a extensão está listada como uma extensão instalada para a máquina virtual.

modelo do ARM

Os modelos ARM são ideais quando você implanta uma ou mais máquinas virtuais que exigem configuração pós-implantação.

A configuração JSON para uma extensão de máquina virtual pode ser aninhada dentro do recurso de máquina virtual ou colocada no nível raiz ou superior de um modelo JSON ARM. O posicionamento da configuração JSON afeta o valor do recurso name e type. Para obter mais informações, consulte Definir nome e tipo para recursos filho.

O exemplo a seguir pressupõe que a extensão esteja aninhada dentro do recurso de máquina virtual. Quando o recurso de extensão é aninhado, o JSON é colocado no objeto "resources": [] da 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 o seguinte comando do PowerShell para implantar a extensão de driver de GPU NVIDIA em uma máquina virtual.

Set-AzVMExtension
    -ResourceGroupName "<myResourceGroup>" `
    -VMName "<myVM>" `
    -Location "<location>" `
    -Publisher "Microsoft.HpcCompute" `
    -ExtensionName "NvidiaGpuDriverWindows" `
    -ExtensionType "NvidiaGpuDriverWindows" `
    -TypeHandlerVersion 1.10 `
    -SettingString '{ `
	}'

Azure CLI

Execute o seguinte comando na CLI do Azure para implantar a extensão de driver de GPU NVIDIA em uma máquina virtual.

az vm extension set \
  --resource-group <myResourceGroup> \
  --vm-name <myVM> \
  --name NvidiaGpuDriverWindows \
  --publisher Microsoft.HpcCompute \
  --version 1.10 \
  --settings '{ \
  }'

Troubleshoot issues

Aqui estão algumas sugestões de como solucionar problemas de implantação.

Verificar o estado da extensão

Verifique o status da sua implantação de extensão no portal do Azure ou usando o PowerShell ou a CLI do Azure.

Para ver o estado de implantação das extensões de uma determinada VM, execute os seguintes comandos:

Get-AzVMExtension -ResourceGroupName <myResourceGroup> -VMName <myVM> -Name <myExtensionName>

az vm extension list --resource-group <myResourceGroup> --vm-name <myVM> -o table

Verificar registos de saída

Veja os logs de saída da implantação da extensão de driver de GPU NVIDIA em C:\WindowsAzure\Logs\Plugins\Microsoft.HpcCompute.NvidiaGpuDriverWindows\.

Responder a códigos de erro

A tabela a seguir lista códigos de erro comuns para implantação e possíveis ações de acompanhamento.

Error	Description	Action
0	Operation successful.	Nenhuma ação necessária.
1	Operation successful.	Reboot.
100	A operação não é suportada ou não pôde ser concluída.	Verifique os arquivos de log para determinar a causa do erro, como: - A versão do PowerShell não é suportada. - O tamanho da VM não é uma VM da série N. - Falha durante o download de dados.
240, 840	Operation timeout.	Retry operation.
-1	Exception occurred.	Verifique os arquivos de log para determinar a causa da exceção.
-5x	Operação interrompida devido à reinicialização pendente.	Reinicie a VM. A instalação continua após a reinicialização. A desinstalação deve ser invocada manualmente.

Known issues

A versão 17.x do driver GRID é incompatível com NVv3 (NVIDIA Tesla M60). Os controladores GRID até à versão 16.5 são suportados. NvidiaGpuDriverWindows instala os drivers mais recentes que são incompatíveis no NVv3 SKU. Em vez disso, use as seguintes configurações de tempo de execução para forçar a extensão a instalar uma versão mais antiga do driver. Para obter mais informações sobre versões de driver, consulte Recursos de GPU NVIDIA.

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"
    }
  }
}

Get support

Aqui estão algumas outras opções para ajudá-lo a resolver problemas de implantação:

Para obter assistência, contacte os especialistas do Azure nos fóruns Q&A e Stack Overflow.
Se você não encontrar uma resposta no site, poderá postar uma pergunta para entrada da Microsoft ou de outros membros da comunidade.
Também pode contactar o Suporte da Microsoft. Para obter informações sobre como usar o suporte do Azure, leia as Perguntas frequentes de suporte do Azure.

Next steps

Para obter mais informações sobre extensões, consulte Extensões e recursos de máquina virtual para Windows.
Para obter mais informações sobre VMs da série N, consulte Tamanhos de máquina virtual otimizados para GPU.

Comentários

Esta página foi útil?

Last updated on 2025-07-23