Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
A Extensão de Drivers GPU NVIDIA para Windows instala os drivers da 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 mais informações, consulte Instale os drivers da GPU NVIDIA em VMs da série N a executar 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
Esta extensão continuará a usar a v18.x até terminarmos a implementação da v20.x no terceiro trimestre do ano de 2026.
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.
Note
Experimenta o VM assist para diagnósticos mais rápidos. Recomendamos que execute VM assist para Windows ou VM assist para Linux. Estas ferramentas de diagnóstico baseadas em scripts ajudam-no a identificar problemas comuns que afetam o Agente de Convidados da VM Azure e a saúde geral da VM.
Se estiver a experienciar problemas de desempenho com máquinas virtuais, antes de contactar o suporte, execute estas ferramentas.
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 do Driver GPU NVIDIA suporta as seguintes versões para 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 | Tipo de dados |
|---|---|---|
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 VM do Azure podem ser geridas utilizando os templates CLI do Azure, PowerShell, Azure Resource Manager (ARM) e o portal 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.
Azure portal
Para instalar a Extensão do Driver GPU NVIDIA no portal Azure, siga estes passos:
No portal Azure, vai à máquina virtual onde queres instalar a extensão.
Em Configurações, selecione Extensões + Aplicativos.
Em Extensões, selecione + Adicionar.
Localize e selecione NVIDIA GPU Driver Extension e, em seguida, selecione Next.
Selecione Rever + 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 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 '{ `
}'
CLI do Azure
Execute o seguinte comando na CLI do Azure para implementar a Extensão do Driver GPU NVIDIA numa máquina virtual.
az vm extension set \
--resource-group <myResourceGroup> \
--vm-name <myVM> \
--name NvidiaGpuDriverWindows \
--publisher Microsoft.HpcCompute \
--version 1.10 \
--settings '{ \
}'
Solucionar problemas
Aqui estão algumas sugestões de como solucionar problemas de implantação.
Verificar o estado da extensão
Verifique o estado da implementação da sua 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 registos de saída da implementação da extensão de driver da 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 | Operação bem-sucedida. | Nenhuma ação necessária. |
| 1 | Operação bem-sucedida. | 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 | Tempo limite de operação. | Tentar novamente a operação. |
| -1 | Ocorreu uma exceção. | 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. |
Problemas conhecidos
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 mais informações sobre versões dos drivers, 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
Aqui estão algumas outras opções para ajudá-lo a resolver problemas de implantação:
Para obter assistência, contacte os especialistas da Azure nos fóruns de Q&A e Stack Overflow.
Se não encontrar uma resposta no site, pode publicar uma pergunta para obter contributos da Microsoft ou de outros membros da comunidade.
Também pode Contactar Suporte da Microsoft. Para informações sobre como utilizar o suporte do Azure, leia as FAQs do suporte do Azure.
Próximos passos
- Para mais informações sobre extensões, consulte Extensões e funcionalidades de máquinas virtuais para Windows.
- Para obter mais informações sobre VMs da série N, consulte Tamanhos de máquina virtual otimizados para GPU.