你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

向 SQL IaaS 代理扩展注册 Windows SQL Server VM

项目
07/31/2023

向 SQL IaaS 代理扩展注册 SQL Server VM，以便为 Azure Windows VM 上的 SQL Server 解锁丰富的功能权益。

本文介绍如何向 SQL IaaS 代理扩展注册单个 SQL Server VM。或者，可以在订阅中自动注册所有 SQL Server VM，也可以通过脚本批量注册多个 VM。

注意

在 2022 年 10 月之后通过 Azure 市场部署的 SQL Server VM 默认启用最小特权模型。 SQL IaaS 代理扩展的管理模式已于 2023 年 3 月移除。

概述

通过 Azure 门户部署 SQL Server VM Azure 市场映像会自动将 SQL Server VM 注册到扩展。但是，如果选择在 Azure 虚拟机上自行安装 SQL Server，或通过自定义 VHD 预配 Azure 虚拟机，则必须向 SQL IaaS 代理扩展 SQL Server VM 注册才能解锁完整功能权益和可管理性。默认情况下，安装了 SQL Server 2016 或更高版本的 Azure VM 会在被 CEIP 服务检测到的情况下自动注册到 SQL IaaS 代理扩展。有关详细信息，请参阅 SQL Server 隐私补充条款。有关隐私的信息，请参阅 SQL IaaS 代理扩展隐私声明。

若要利用 SQL IaaS 代理扩展，必须首先向 Microsoft.SqlVirtualMachine 提供程序注册订阅，这使 SQL IaaS 代理扩展能够在该特定订阅中创建资源。然后，就可以向扩展注册 SQL Server VM 了。

先决条件

若要将 SQL Server VM 注册到代理扩展，需要以下内容：

Azure 订阅。
Azure 资源模型支持 Windows Server 虚拟机，其支持的 SQL Server 版本已部署到公共云或 Azure 政府云。
确保 Azure VM 正在运行。
用于注册虚拟机的客户端凭据存在于以下任何 Azure 角色中：“虚拟机参与者”、“参与者”或“所有者”。
最新版本的 Azure CLI 或 Azure PowerShell（最低 5.0）。
至少 .NET Framework 4.5.1 或更高版本。
验证所有限制是否都不适用于你。

将订阅注册到 RP

若要向 SQL Server VM 注册 SQL IaaS 代理扩展，必须首先向订阅注册 Microsoft.SqlVirtualMachine 资源提供程序 (RP)。这使 SQL IaaS 代理扩展能够在订阅中创建资源。可以使用 Azure 门户、Azure CLI 或 Azure PowerShell 执行此操作。

通过使用 Azure 门户，向资源提供程序注册订阅：

打开 Azure 门户，转到“所有服务”。
转到“订阅”，选择感兴趣的订阅。
在“订阅”页上，选择“设置”下的“资源提供程序”。
在筛选器中输入“sql”，以便显示与 SQL 相关的资源提供程序。
根据所需操作为“Microsoft.SqlVirtualMachine”提供程序选择“注册”、“重新注册”或“取消注册”。

通过使用 Azure PowerShell，向资源提供程序注册订阅：

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

通过使用 Azure CLI，向资源提供程序注册订阅：

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

向扩展注册

可以使用 Azure PowerShell 或 Azure CLI 手动将 SQL Server VM 注册到 SQL IaaS 代理扩展。

提供 SQL Server 许可证类型，形式为即用即付（PAYG，用于按使用情况付费）、Azure 混合权益（AHUB，用于使用自己的许可证）或灾难恢复（DR，用于激活免费 DR 副本许可证）。

向 Azure PowerShell 注册 SQL Server VM：

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

New-AzSqlVM -Name $vm.Name -ResourceGroupName $vm.ResourceGroupName -Location $vm.Location `
-LicenseType <license_type>

向 Azure CLI 注册 SQL Server：

# Register Enterprise or Standard self-installed VM
az sql vm create --name <vm_name> --resource-group <resource_group_name> --location <vm_location> --license-type <license_type>

目前无法使用 Azure 门户向 SQL IaaS 代理扩展注册 SQL Server VM。

验证注册状态

可以使用 Azure 门户、Azure CLI 或 Azure PowerShell 验证是否已向 SQL IaaS 代理扩展注册 SQL Server VM。

使用 Azure 门户验证注册状态：

登录到 Azure 门户。
转到 SQL Server VM。
从列表中选择 SQL Server VM。如果 SQL Server VM 未在此处列出，可能是还没有向 SQL IaaS 代理扩展注册。
查看“状态”下的值。如果“状态”为“成功”，则 SQL Server VM 已成功向 SQL IaaS 代理扩展注册。

也可通过在“SQL 虚拟机”资源的“支持 + 故障排除”窗格下选择“修复”来检查状态。 SQL IaaS 代理扩展的预配状态可以是“成功”，也可以是“失败”。

使用 Azure PowerShell 验证当前 SQL Server VM 注册状态。如果注册成功，ProvisioningState 显示为 Succeeded。

使用 Azure PowerShell 验证注册状态：

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

使用 Azure CLI 验证当前 SQL Server VM 注册状态。如果注册成功，ProvisioningState 显示为 Succeeded。

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

错误指明 SQL Server VM 尚未向扩展注册。

从扩展取消注册

若要从 SQL IaaS 代理扩展取消注册 SQL Server VM，请使用 Azure 门户或 Azure CLI 删除 SQL 虚拟机资源。删除 SQL 虚拟机资源不会删除 SQL Server VM。

注意

从扩展中取消注册 SQL Server VM 时，要特别小心。仔细执行以下步骤，因为在尝试删除资源时，可能会意外删除虚拟机。

使用 Azure 门户从扩展取消注册 SQL Server VM：

登录到 Azure 门户。
导航到 SQL VM 资源。
选择“删除” 。
键入 SQL 虚拟机的名称，并清除虚拟机旁的复选框。

警告

如果未能清除虚拟机名称的复选框，会导致彻底删除虚拟机。清除复选框可从扩展取消注册 SQL Server VM，但不会删除实际虚拟机。
选择“删除”以确认 SQL 虚拟机资源的删除，而不是 SQL Server VM。

若要使用 Azure PowerShell 从扩展取消注册 SQL Server VM，请使用 Remove-AzSqlVM 命令。这会删除 SQL Server VM 资源，但不会删除虚拟机。

使用 Azure PowerShell 取消注册 SQL Server VM：

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

若要使用 Azure CLI 从扩展取消注册 SQL Server VM，请使用 az sql vm delete 命令。这会删除 SQL Server VM 资源，但不会删除虚拟机。

使用 Azure CLI 取消注册 SQL Server VM：

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

后续步骤

查看 SQL IaaS 代理扩展提供的优势。
自动注册订阅中的所有 VM。
排查有关扩展的已知问题。
查看 SQL IaaS 代理扩展隐私声明。
查看最佳做法清单，针对性能和安全性进行优化。

若要了解详细信息，请查看以下文章：