NVIDIA-GPU-Treibererweiterung für WindowsNVIDIA GPU Driver Extension for Windows

ÜbersichtOverview

Diese Erweiterung installiert NVIDIA-GPU-Treiber auf Windows-VMs der N-Serie.This extension installs NVIDIA GPU drivers on Windows N-series VMs. Je nach VM-Familie installiert die Erweiterung CUDA- oder GRID-Treiber.Depending on the VM family, the extension installs CUDA or GRID drivers. Bei der Installation von NVIDIA Treibern mit dieser Erweiterung akzeptieren Sie die Bedingungen des NVIDIA-Endbenutzer-Lizenzvertrags und stimmen diesen zu.When you install NVIDIA drivers using this extension, you are accepting and agreeing to the terms of the NVIDIA End-User License Agreement. Während der Installation wird der virtuelle Computer möglicherweise neu gestartet, um die Treibereinrichtung abzuschließen.During the installation process, the VM may reboot to complete the driver setup.

Anweisungen zur manuellen Installation der Treiber und der aktuellen unterstützten Versionen sind hier verfügbar.Instructions on manual installation of the drivers and the current supported versions are available here. Es ist auch eine Erweiterung zum Installieren von NVIDIA-GPU-Treibern auf Linux-VMs der N-Serie verfügbar.An extension is also available to install NVIDIA GPU drivers on Linux N-series VMs.

VoraussetzungenPrerequisites

BetriebssystemOperating system

Diese Erweiterung unterstützt die folgenden Betriebssysteme:This extension supports the following OSs:

DistributionDistribution VersionVersion
Windows 10Windows 10 CoreCore
Windows Server 2016Windows Server 2016 CoreCore
Windows Server 2012 R2Windows Server 2012 R2 CoreCore

InternetkonnektivitätInternet connectivity

Die Microsoft Azure-Erweiterung für NVIDIA-GPU-Treiber erfordert, dass der virtuelle Zielcomputer mit dem Internet verbunden ist und Zugriff hat.The Microsoft Azure Extension for NVIDIA GPU Drivers requires that the target VM is connected to the internet and have access.

ErweiterungsschemaExtension schema

Der folgende JSON-Code zeigt das Schema für die Erweiterung.The following JSON shows the schema for the extension.

{
  "name": "<myExtensionName>",
  "type": "extensions",
  "apiVersion": "2015-06-15",
  "location": "<location>",
  "dependsOn": [
    "[concat('Microsoft.Compute/virtualMachines/', <myVM>)]"
  ],
  "properties": {
    "publisher": "Microsoft.HpcCompute",
    "type": "NvidiaGpuDriverWindows",
    "typeHandlerVersion": "1.3",
    "autoUpgradeMinorVersion": true,
    "settings": {
    }
  }
}

EigenschaftenProperties

NameName Wert/BeispielValue / Example DatentypData Type
apiVersionapiVersion 2015-06-152015-06-15 datedate
publisherpublisher Microsoft.HpcComputeMicrosoft.HpcCompute Zeichenfolgestring
typetype NvidiaGpuDriverWindowsNvidiaGpuDriverWindows Zeichenfolgestring
typeHandlerVersiontypeHandlerVersion 1.31.3 INTint

BereitstellungDeployment

Azure Resource Manager-VorlageAzure Resource Manager Template

Azure-VM-Erweiterungen können mithilfe von Azure Resource Manager-Vorlagen bereitgestellt werden.Azure VM extensions can be deployed with Azure Resource Manager templates. Vorlagen sind ideal, wenn Sie virtuelle Computer bereitstellen, die nach der Bereitstellung konfiguriert werden müssen.Templates are ideal when deploying one or more virtual machines that require post deployment configuration.

Die JSON-Konfiguration für eine VM-Erweiterung kann innerhalb der VM-Ressource geschachtelt oder im Stamm bzw. auf der obersten Ebene einer Resource Manager-JSON-Vorlage platziert werden.The JSON configuration for a virtual machine extension can be nested inside the virtual machine resource, or placed at the root or top level of a Resource Manager JSON template. Die Platzierung der JSON-Konfiguration wirkt sich auf den Wert von Name und Typ der Ressource aus.The placement of the JSON configuration affects the value of the resource name and type. Weitere Informationen finden Sie unter Set name and type for child resources (Festlegen von Name und Typ für untergeordnete Ressourcen).For more information, see Set name and type for child resources.

Im folgenden Beispiel wird davon ausgegangen, dass die Erweiterung in der VM-Ressource geschachtelt ist.The following example assumes the extension is nested inside the virtual machine resource. Beim Schachteln der Ressource für die Erweiterung wird der JSON-Code im "resources": []-Objekt des virtuellen Computers platziert.When nesting the extension resource, the JSON is placed in the "resources": [] object of the virtual machine.

{
  "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.3",
    "autoUpgradeMinorVersion": true,
    "settings": {
    }
  }
}

PowerShellPowerShell

Set-AzVMExtension
    -ResourceGroupName "myResourceGroup" `
    -VMName "myVM" `
    -Location "southcentralus" `
    -Publisher "Microsoft.HpcCompute" `
    -ExtensionName "NvidiaGpuDriverWindows" `
    -ExtensionType "NvidiaGpuDriverWindows" `
    -TypeHandlerVersion 1.3 `
    -SettingString '{ `
    }'

Azure CLIAzure CLI

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

Problembehandlung und SupportTroubleshoot and support

ProblembehandlungTroubleshoot

Daten zum Status von Erweiterungsbereitstellungen können über das Azure-Portal und mithilfe von Azure PowerShell und der Azure-Befehlszeilenschnittstelle abgerufen werden.Data about the state of extension deployments can be retrieved from the Azure portal, and by using Azure PowerShell and Azure CLI. Führen Sie den folgenden Befehl aus, um den Bereitstellungsstatus von Erweiterungen für einen bestimmten virtuellen Computer anzuzeigen.To see the deployment state of extensions for a given VM, run the following command.

Get-AzVMExtension -ResourceGroupName myResourceGroup -VMName myVM -Name myExtensionName
az vm extension list --resource-group myResourceGroup --vm-name myVM -o table

Die Ausgabe der Erweiterungsausführung wird im folgenden Verzeichnis protokolliert:Extension execution output is logged to the following directory:

C:\WindowsAzure\Logs\Plugins\Microsoft.HpcCompute.NvidiaGpuDriverWindows\

FehlercodesError codes

FehlercodeError Code BedeutungMeaning Mögliche AktionPossible Action
00 Vorgang erfolgreichOperation successful
11 Vorgang erfolgreich.Operation successful. Es ist ein Neustart erforderlich.Reboot required.
100100 Der Vorgang wird nicht unterstützt oder konnte nicht abgeschlossen werden.Operation not supported or could not be completed. Mögliche Ursachen: PowerShell-Version nicht unterstützt, VM-Größe ist keine VM der N-Serie, Fehler beim Herunterladen von Daten.Possible causes: PowerShell version not supported, VM size is not an N-series VM, Failure downloading data. Überprüfen Sie die Protokolldateien, um die Ursache des Fehlers zu ermitteln.Check the log files to determine cause of error.
240, 840240, 840 Timeout bei Vorgang.Operation timeout. Wiederholen Sie den Vorgang.Retry operation.
-1-1 Ausnahme.Exception occurred. Überprüfen Sie die Protokolldateien, um die Ursache der Ausnahme zu ermitteln.Check the log files to determine cause of exception.
-5x-5x Vorgang aufgrund ausstehenden Neustarts unterbrochen.Operation interrupted due to pending reboot. Starten Sie die VM neu.Reboot VM. Die Installation wird nach dem Neustart fortgesetzt.Installation will continue after reboot. Eine Deinstallation sollte manuell aufgerufen werden.Uninstall should be invoked manually.

SupportSupport

Sollten Sie beim Lesen dieses Artikels feststellen, dass Sie weitere Hilfe benötigen, können Sie sich über das MSDN Azure-Forum oder über das Stack Overflow-Forum mit Azure-Experten in Verbindung setzen.If you need more help at any point in this article, you can contact the Azure experts on the MSDN Azure and Stack Overflow forums. Alternativ dazu haben Sie die Möglichkeit, einen Azure-Supportfall zu erstellen.Alternatively, you can file an Azure support incident. Rufen Sie die Azure-Support-Website auf, und wählen Sie „Support erhalten“ aus.Go to the Azure support site and select Get support. Informationen zur Nutzung von Azure-Support finden Sie unter Microsoft Azure-Support-FAQ.For information about using Azure Support, read the Microsoft Azure support FAQ.

Nächste SchritteNext steps

Weitere Informationen zu Erweiterungen finden Sie unter Erweiterungen und Features für virtuelle Computer für Windows.For more information about extensions, see Virtual machine extensions and features for Windows.

Weitere Informationen zu virtuellen Computern der N-Serie finden Sie unter Für GPU optimierte VM-Größen.For more information about N-series VMs, see GPU optimized virtual machine sizes.