Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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 grade. Ao instalar drivers NVIDIA usando essa extensão, você declara aceitar e concordar com os termos do Contrato de Licença de Usuário Final da NVIDIA. Durante o processo de instalação, a VM pode ser reinicializada para concluir a configuração do driver.
As instruções para a instalação manual dos drivers e a lista de versões atuais com suporte estão disponíveis para leitura. Para obter mais informações, consulte Instalar drivers de GPU NVIDIA em VMs da série N executando Windows.
A Extensão de Driver NVIDIA de GPU também pode ser implantada em VMs da série N com Linux. Para obter mais informações, confira Extensão de driver NVIDIA de GPU para Linux.
Note
Essa extensão continuará a usar v18.x até concluirmos a distribuição v20.x no 3º trimestre de 2026.
Note
As extensões de driver de GPU não atualizam automaticamente o driver depois que a extensão é instalada. Se você precisar mover para uma versão mais recente do driver, baixe e instale manualmente o driver ou remova e adicione a extensão novamente.
Note
Experimente a assistência de VM para diagnósticos mais rápidos. Recomendamos que você execute VM assist para Windows ou VM assist para Linux. Essas ferramentas de diagnóstico baseadas em script ajudam você a identificar problemas comuns que afetam o agente convidado da VM Azure e a integridade geral da VM.
Se você estiver enfrentando problemas de desempenho com máquinas virtuais, antes de entrar em contato com o suporte, execute essas ferramentas.
Prerequisites
Confirme se a sua máquina virtual cumpre os pré-requisitos de uso da Extensão de Driver NVIDIA de GPU.
Suporte do sistema operacional
A Extensão de Driver de GPU NVIDIA dá suporte às seguintes versões 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 |
É necessária uma conexão com a internet
A Extensão de Driver NVIDIA de GPU requer que a VM de destino esteja conectada e tenha acesso à internet.
Leia o esquema da extensão
O trecho de código em 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 parâmetros a seguir.
| Name | Value/Example | Tipo de dados |
|---|---|---|
apiVersion |
2015-06-15 | date |
publisher |
Microsoft. HpcCompute | cadeia |
type |
NvidiaGpuDriverWindows | cadeia |
typeHandlerVersion |
1.10 | int |
Implantar a extensão
Azure extensões de VM podem ser gerenciadas usando os modelos CLI do Azure, PowerShell, Azure Resource Manager (ARM) e o portal Azure.
Note
Alguns dos exemplos a seguir usam valores de parâmetro <placeholder> nos comandos. Antes de executar cada comando, certifique-se de substituir todos os valores de espaço reservado por valores específicos para a sua configuração.
Portal do Azure
Para instalar a Extensão de Driver de GPU NVIDIA no portal Azure, siga estas etapas:
No portal Azure, acesse a máquina virtual na qual você deseja instalar a extensão.
Em Configurações, selecione Extensões e Aplicações.
Em Extensões, selecione + Adicionar.
Localize e selecione a Extensão de Driver NVIDIA de GPU e, a seguir, selecione Avançar.
Selecione Examinar + criar. Confirme a ação de implantação e selecione Criar.
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 do ARM são ideais quando você implanta uma ou mais máquinas virtuais que requerem uma configuração pós-implantação.
A configuração do JSON para uma extensão de máquina virtual pode ser aninhada dentro do recurso de máquina virtual ou posicionada na raiz ou no nível superior de um modelo JSON do ARM. O posicionamento da configuração do JSON afeta o valor do name e type do recurso. Para obter mais informações, consulte Definir o nome e o tipo de recursos filho.
O exemplo a seguir pressupõe que a extensão está aninhada dentro do recurso de máquina virtual. Quando o recurso de extensão está 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 comando do PowerShell a seguir para implantar a Extensão de Driver NVIDIA de GPU em uma máquina virtual.
Set-AzVMExtension
-ResourceGroupName "<myResourceGroup>" `
-VMName "<myVM>" `
-Location "<location>" `
-Publisher "Microsoft.HpcCompute" `
-ExtensionName "NvidiaGpuDriverWindows" `
-ExtensionType "NvidiaGpuDriverWindows" `
-TypeHandlerVersion 1.10 `
-SettingString '{ `
}'
CLI do Azure
Execute o comando a seguir no 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 '{ \
}'
Solucionar problemas
Abaixo algumas sugestões de como solucionar problemas de implantação.
Verificar o status da extensão
Verifique o status da implantação da extensão no portal do Azure ou usando o PowerShell ou o CLI do Azure.
Para ver o status de implantação de extensões para uma VM específica, execute os comandos a seguir:
Get-AzVMExtension -ResourceGroupName <myResourceGroup> -VMName <myVM> -Name <myExtensionName>
az vm extension list --resource-group <myResourceGroup> --vm-name <myVM> -o table
Ler os logs de saída
Exibir logs de saída para a implantação da extensão do driver de GPU NVIDIA em C:\WindowsAzure\Logs\Plugins\Microsoft.HpcCompute.NvidiaGpuDriverWindows\.
Responder a códigos de erro
A tabela a seguir lista os códigos de erro mais comuns para a implantação e possíveis ações de acompanhamento.
| Error | Description | Action |
|---|---|---|
| 0 | Operação concluída com êxito. | Nenhuma ação necessária. |
| 1 | Operação concluída com êxito. | Reboot. |
| 100 | Operação sem suporte ou não pôde ser concluída. | Verifique os arquivos de log para determinar a causa do erro, como, por exemplo: — A versão do PowerShell não tem suporte. — O tamanho da VM não é uma VM da série N. — Falha durante o download de dados. |
| 240, 840 | Tempo limite de operação. | Tentar a operação novamente. |
| -1 | Ocorreu uma exceção. | Verifique os arquivos de log para determinar a causa da exceção. |
| -5x | Operação foi interrompida devido a reinicialização pendente. | Reinicialize a VM. A instalação continua após a reinicialização. Desinstalação deve ser invocada manualmente. |
Problemas conhecidos
O 17.x de versão do GRID Driver é incompatível com o NVv3 (NVIDIA Tesla M60). Há suporte para drivers GRID até a versão 16.5.
NvidiaGpuDriverWindows instala os drivers mais recentes incompatíveis com o SKU do NVv3. Em vez disso, use as seguintes configurações de runtime para forçar a extensão a instalar uma versão mais antiga do driver. Para obter mais informações sobre as versões do driver, 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"
}
}
}
Obtenha suporte
Abaixo algumas outras opções para ajudar você a resolver problemas de implantação:
Para obter assistência, entre em contato com 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 obter informações de Microsoft ou de outros membros da comunidade.
Você também pode Contact Suporte da Microsoft. Para obter informações sobre como usar Suporte do Azure, leia as perguntas frequentes Suporte do Azure.
Próximas etapas
- Para obter mais informações sobre extensões, consulte Extensões de máquinavirtual e recursos para Windows.
- Para obter mais informações sobre VMs série N, consulte tamanhos de máquinas virtuais otimizados para GPU.