Windows SQL Server-VM registreren met de SQL IaaS Agent-extensie

2025-09-26

Van toepassing op:SQL Server op Azure VM-

Registreer uw SQL Server-VM met de SQL IaaS Agent-extensie om een schat aan functievoordelen te ontgrendelen voor uw SQL Server op Azure Windows-VM.

In dit artikel leert u hoe u één SQL Server-VM registreert met de SQL IaaS Agent-extensie. U kunt ook alle SQL Server-VM's in een abonnement automatisch of meerdere VM's bulksgewijs registreren met behulp van een script.

Opmerking

VOOR SQL Server-VM's die zijn geïmplementeerd via Azure Marketplace na oktober 2022, is standaard het model met minimale bevoegdheden ingeschakeld. Beheermodi voor de SQL IaaS Agent-extensie zijn in maart 2023 verwijderd.

Overzicht

Als u zich registreert bij de SQL Server IaaS Agent-extensie, wordt de SQL-VM-resource binnen uw abonnement gemaakt. Dit is een afzonderlijke resource van de virtuele-machineresource. Als u de extensie verwijdert van uw SQL Server-VM, wordt de RESOURCE van de virtuele SQL-machineverwijderd, maar wordt de werkelijke virtuele machine niet verwijderd.

Als u een Azure Marketplace-afbeelding van een SQL Server-VM implementeert via het Azure Portal, wordt de SQL Server-VM automatisch geregistreerd bij de extensie, inclusief de registratie van het abonnement bij de Microsoft.SqlVirtualMachine resourceprovider (RP), als het nog niet is geregistreerd. Als u er echter voor kiest om SQL Server zelf te installeren op een virtuele Azure-machine of een virtuele Azure-machine in te richten vanaf een aangepaste VHD, moet u uw SQL Server-VM registreren met de SQL IaaS Agent-extensie om volledige functievoordelen en beheerbaarheid te ontgrendelen. Azure-VM's waarop SQL Server 2016 of hoger is geïnstalleerd, worden standaard automatisch geregistreerd bij de SQL IaaS Agent-extensie wanneer deze worden gedetecteerd door de CEIP-service. Zie de aanvulling op de sql Server-privacyverklaring voor meer informatie. Zie de privacyverklaringen van de SQL IaaS Agent-extensie voor meer informatie over privacy.

Als u de SQL IaaS Agent-extensie wilt gebruiken, moet u eerst uw abonnement registreren bij de Microsoft.SqlVirtualMachine-provider, waardoor de SQL IaaS Agent-extensie de mogelijkheid biedt om resources binnen dat specifieke abonnement te maken. Vervolgens kunt u uw SQL Server-VM registreren bij de extensie.

Vereiste voorwaarden

Als u uw SQL Server-VM wilt registreren bij de extensie, hebt u het volgende nodig:

Een Azure-abonnement.
Een Azure-resourcemodel dat virtuele Windows Server-machine ondersteunt met een ondersteunde SQL Server-versie die is geïmplementeerd in de openbare of Azure Government-cloud.
Zorg ervoor dat de Virtuele Azure-machine wordt uitgevoerd.
De clientreferenties die worden gebruikt om de virtuele machine te registreren, bestaan in een van de volgende Azure-rollen: Inzender voor virtuele machines, Inzender of Eigenaar.
De nieuwste versie van Azure CLI of Azure PowerShell (minimaal 5.0).
Minimaal .NET Framework 4.5.1 of hoger.
Om te controleren of geen van de beperkingen van toepassing is op u.

Abonnement registreren bij RP

Als u uw SQL Server-VM wilt registreren met de SQL IaaS Agent-extensie, moet u eerst uw abonnement registreren bij de ResourceProvider Microsoft.SqlVirtualMachine (RP). Dit biedt de SQL IaaS Agent-extensie de mogelijkheid om resources binnen uw abonnement te maken. U kunt dit doen met behulp van Azure Portal, de Azure CLI of Azure PowerShell.

Registreer uw abonnement bij de resourceprovider met behulp van Azure Portal:

Open Azure Portal en ga naar Alle services.
Ga naar Abonnementen en selecteer het interesseabonnement.
Selecteer resourceproviders onder Instellingen op de pagina Abonnementen.
Voer sql in het filter in om de SQL-gerelateerde resourceproviders weer te geven.
Selecteer Registreren, Opnieuw registreren of Registratie opheffen voor de Microsoft.SqlVirtualMachine-provider, afhankelijk van de gewenste actie.

Registreer uw abonnement bij de resourceprovider met behulp van Azure PowerShell:

# Register the SQL IaaS Agent extension to your subscription
Register-AzResourceProvider -ProviderNamespace Microsoft.SqlVirtualMachine

Registreer uw abonnement bij de resourceprovider met behulp van de Azure CLI:

# Register the SQL IaaS Agent extension to your subscription
az provider register --namespace Microsoft.SqlVirtualMachine

Registreren bij extensie

U kunt uw SQL Server-VM handmatig registreren bij de SQL IaaS Agent-extensie met behulp van Azure PowerShell of de Azure CLI.

Geef het licentietype SQL Server op als betalen per gebruik (PAYG) om te betalen per gebruik, Azure Hybrid Benefit (AHUB) om uw eigen licentie te gebruiken of herstel na noodgevallen (DR) om de gratis DR-replicalicentie te activeren.

Registreer een SQL Server-VM met Azure PowerShell:

# Get the existing Compute VM
$vm = Get-AzVM -Name <vm_name> -ResourceGroupName <resource_group_name>

# Register SQL Server VM with the extension
New-AzSqlVM -Name $vm.Name -ResourceGroupName $vm.ResourceGroupName -Location $vm.Location `
-LicenseType <license_type>

Een SQL Server registreren bij de Azure CLI:

# Register SQL Server VM with the extension
az sql vm create --name <vm_name> --resource-group <resource_group_name> --location <vm_location> --license-type <license_type>

Het is momenteel niet mogelijk om uw SQL Server-VM te registreren bij de SQL IaaS Agent-extensie met behulp van Azure Portal.

Registratiestatus verifiëren

U kunt controleren of uw SQL Server-VM al is geregistreerd bij de SQL IaaS Agent-extensie met behulp van Azure Portal, De Azure CLI of Azure PowerShell.

Controleer de registratiestatus met Azure Portal:

Meld u aan bij het Azure-portaal.
Ga naar uw SQL Server VMs.
Selecteer uw SQL Server-VM in de lijst. Als uw SQL Server-VM hier niet wordt vermeld, is deze waarschijnlijk niet geregistreerd bij de SQL IaaS Agent-extensie.
Bekijk de waarde onder Status. Als de StatusGeslaagd is, is de SQL Server-VM correct geregistreerd bij de SQL IaaS Agent-extensie.

U kunt de status ook controleren door Herstellen te kiezen onder het deelvenster Ondersteuning en probleemoplossing in de resource van de virtuele SQL-machine . De inrichtingsstatus voor de SQL IaaS Agent-extensie kan Geslaagd of Mislukt zijn.

Controleer de huidige registratiestatus van de SQL Server-VM met behulp van Azure PowerShell. ProvisioningState Succeeded geeft aan of de registratie is geslaagd.

Controleer de registratiestatus met Azure PowerShell:

Get-AzSqlVM -Name <vm_name> -ResourceGroupName <resource_group>

Controleer de huidige registratiestatus van de SQL Server-VM met behulp van de Azure CLI. ProvisioningState Succeeded geeft aan of de registratie is geslaagd.

az sql vm show -n <vm_name> -g <resource_group>

Een fout geeft aan dat de SQL Server-VM niet is geregistreerd bij de extensie.

De extensie verwijderen

Als u de registratie van uw SQL Server-VM met de SQL IaaS Agent-extensie ongedaan wilt maken, verwijdert u de SQL-VM-resource met behulp van Azure Portal, PowerShell of de Azure CLI. Als u de RESOURCE van de virtuele SQL-machine verwijdert , wordt de SQL Server-VM niet verwijderd.

Waarschuwing

Wees uiterst voorzichtig bij het verwijderen van de extensie van uw SQL Server-VM. Volg de stappen zorgvuldig omdat het mogelijk is om de virtuele machine per ongeluk te verwijderen wanneer u de resource probeert te verwijderen.

Als u de extensie wilt verwijderen uit uw SQL Server-VM met behulp van Azure Portal, voert u de volgende stappen uit:

Meld u aan bij de Azure Portal.
Navigeer naar de SQL VM-resource.
Selecteer Verwijderen.
Typ de naam van de virtuele SQL-machine en schakel het selectievakje naast de virtuele machine uit.

Waarschuwing

Als u het selectievakje naast de naam van de virtuele machine niet uitvinkt, wordt de virtuele machine geheel verwijderd. Schakel het selectievakje uit om de extensie te verwijderen van de SQL Server-VM, maar verwijder de werkelijke virtuele machine niet.
Selecteer Verwijderen om het verwijderen van de virtuele SQL-machine-resource te bevestigen en niet van de SQL Server-VM.

Gebruik de opdracht Remove-AzSqlVM om de extensie te verwijderen uit uw SQL Server-VM met Azure PowerShell. Hiermee verwijdert u de SQL Server VM-resource , maar wordt de virtuele machine niet verwijderd.

Als u de extensie wilt verwijderen uit uw SQL Server-VM met Azure PowerShell, gebruikt u de volgende voorbeeldopdracht:

Remove-AzSqlVM -ResourceGroupName <resource_group_name> -Name <SQL VM resource name>

Als u de extensie wilt verwijderen van uw SQL Server-VM met de Azure CLI, gebruikt u de opdracht az sql vm delete . Hiermee verwijdert u de SQL Server VM-resource , maar wordt de virtuele machine niet verwijderd.

Gebruik de volgende voorbeeldopdracht om de extensie te verwijderen van uw SQL Server-VM met de Azure CLI:

az sql vm delete
  --name <SQL VM resource name> |
  --resource-group <Resource group name> |
  --yes

Feedback

Is deze pagina nuttig?