向 SQL IaaS 代理程式延伸模組註冊 Windows SQL Server VM

適用於：Azure VM 上的 SQL Server

向 SQL IaaS 代理程式延伸模組註冊您的 SQL Server VM，讓 Azure Windows VM 上的 SQL Server 得以發揮豐富的功能優勢。

本文將指導您向 SQL IaaS Agent 延伸模組註冊單一 SQL Server VM。 或者，您可以在訂用帳戶中自動註冊所有 SQL Server VM，或使用指令碼大量註冊多部 VM。

注意

SQL Server 在 2022 年 10 月之後透過 Azure Marketplace 部署的 VM 預設會啟用最低權限模型。 SQL IaaS 代理程式延伸模組的管理模式已在 2023 年 3 月移除。

概觀

向 SQL Server IaaS Agent 延伸模組註冊，以在訂用帳戶內建立 SQL 虛擬機器資源，這是與虛擬機器資源不同的資源。 從 SQL Server VM 刪除延伸項目，這樣會移除 SQL 虛擬機器資源，但不會卸載實際的虛擬機器。

透過 Azure 入口網站部署 SQL Server VM Azure Marketplace 映射會自動向延伸模塊註冊 SQL Server VM，包括 向 Microsoft.SqlVirtualMachine 資源提供者 （RP） 註冊訂用帳戶，如果尚未註冊。 不過，如果選擇在 Azure 虛擬機器上自行安裝 SQL Server，或從自訂 VHD 佈建 Azure 虛擬機器，則您必須向 SQL IaaS 代理程式延伸模組註冊 SQL Server VM，以解鎖完整的功能優點和管理能力。 根據預設，當 CEIP 服務偵測到 Azure VM 已安裝 SQL Server 2016 或更新版本時，便會使用 SQL IaaS 代理程式擴充功能自動註冊。 如需詳細資訊，請參閱 SQL Server 隱私權補充。 如需隱私權的相關資訊，請參閱 SQL IaaS 代理程式延伸模組隱私權聲明。

若要利用 SQL Server IaaS 代理程式延伸模組，您必須先向 Microsoft.SqlVirtualMachine 提供者註冊您的訂閱，讓 SQL IaaS 代理程式延伸模組能在該特定訂用帳戶內建立資源。 然後，您可以向延伸模組註冊 SQL Server VM。

必要條件

若要透過擴充功能註冊您的 SQL Server VM ，將需要下列條件：

• Azure 訂用帳戶。
• Azure 資源模型支援的 Windows Server 虛擬機器，以及已部署至公用或 Azure Government 雲端的受支援SQL Server 版本。
• 確定 Azure VM 正在執行中。
• 用於註冊虛擬機器的用戶端認證存在於下列任何 Azure 角色中：虛擬機器參與者、參與者或擁有者。
• 最新版本的 Azure CLI 或 Azure PowerShell (至少是 5.0 版)。
• 至少是 .NET Framework 4.5.1 或更新版本。
• 若要確認沒有任何適用於您的限制。

註冊 RP 訂用帳戶

若要向 SQL IaaS Agent 延伸模組註冊您的 SQL Server VM，您必須先向 Microsoft.SqlVirtualMachine 資源提供者 (RP) 註冊您的訂用帳戶。 這會讓 SQL IaaS Agent 延伸模組能夠在訂用帳戶內建立資源。 您可以使用 Azure 入口網站、Azure CLI 或 Azure PowerShell 來完成。

Azure 入口網站

使用 Azure 入口網站向資源提供者註冊您的訂用帳戶：

1. 開啟 Azure 入口網站並前往 [所有服務]。

2. 前往 [訂用帳戶] 然後選取感興趣的訂用帳戶。

3. 在 [訂用帳戶] 頁面上，選取 [設定] 底下的 [資源提供者]。

4. 在篩選條件中輸入 sql 以顯示 SQL 相關的資源提供者。

5. 取決於您所需的動作，針對 Microsoft.SqlVirtualMachine 提供者選取 [註冊]、[重新註冊] 或 [取消註冊]。

   

Azure PowerShell

使用 Azure PowerShell 向資源提供者註冊您的訂用帳戶：

PowerShell

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

Azure CLI

使用 Azure CLI 向資源提供者註冊您的訂用帳戶：

Azure CLI

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

與延伸模組註冊

您可以使用 Azure PowerShell 或 Azure CLI，以 SQL IaaS 代理程式延伸模組手動註冊 SQL Server VM。

提供 SQL Server 授權類型做為隨用隨付 (PAYG) 以依據使用量付費，Azure Hybrid Benefit (AHUB) 使用您自己的授權，或使用嚴重損壞修復 (DR) 來啟用 免費 DR 複本授權。

Azure PowerShell

若要使用 Azure PowerShell 註冊 SQL Server VM：

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>

Azure CLI

使用 Azure CLI 註冊 SQL Server：

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>

Azure 入口網站

目前無法使用 Azure 入口網站向 SQL IaaS 代理程式延伸模組註冊您的 SQL Server VM。

驗證註冊狀態

您可以使用 Azure 入口網站、Azure CLI 或 Azure PowerShell，來確認 SQL Server VM 是否已向 SQL IaaS Agent 延伸模組註冊。

Azure 入口網站

使用 Azure 入口網站來確認註冊狀態：

1. 登入 Azure 入口網站。

2. 移至您的 SQL Server VM。

3. 從清單中選取 SQL Server VM。 如果您的 SQL Server VM 未列於其中，代表該 VM 可能尚未向 SQL IaaS 代理程式延伸模組註冊。

4. 查看 [狀態]下的值。 如果 [狀態] 為 [成功]，則 SQL Server VM 已成功向 SQL IaaS Agent 延伸模組註冊。

   

或者，您可以在 [SQL 虛擬機器] 資源的 [支援 + 疑難排解] 窗格下選擇 [修復]，以檢查狀態。 SQL IaaS Agent 延伸模組的佈建狀態可以是 [成功] 或 [失敗]。

Azure PowerShell

請透過使用 Azure PowerShell 來確認目前的 SQL Server VM 註冊狀態。 如果註冊成功，則 ProvisioningState 會顯示 Succeeded。

使用 Azure PowerShell 來確認註冊狀態：

PowerShell

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

Azure CLI

使用 Azure CLI 確認目前 SQL Server VM 的註冊狀態。 如果註冊成功，則 ProvisioningState 會顯示 Succeeded。

Azure CLI

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

若有錯誤，則表示 SQL Server VM 尚未向延伸模組註冊。

刪除延伸模組

如果要向 SQL IaaS Agent 延伸項目取消註冊您的 SQL Server VM，請使用 Azure 入口網站、PowerShell 或 Azure CLI 刪除 SQL 虛擬機器資源。 刪除 SQL 虛擬機器 [資源] 不會刪除 SQL Server VM。

警告

從 SQL Server VM 刪除延伸項目時請特別小心。 請謹慎遵循步驟，因為在嘗試移除資源時，可能會不小心刪除虛擬機器。

Azure 入口網站

若要使用 Azure 入口網站 從 SQL Server VM 中刪除延伸項目，請遵循下列步驟：

1. 登入 Azure 入口網站。

2. 瀏覽至 SQL VM 資源。

   

3. 選取 [刪除]。

   

4. 輸入 SQL 虛擬機器的名稱，然後清除虛擬機器旁的核取方塊。

   

   警告

   如果無法清除虛擬機器名稱旁的核取方塊，將會完全刪除虛擬機器。 清除核取方塊可從 SQL Server VM 刪除延伸項目，但不會刪除實際的虛擬機器。

5. 選取 [刪除]，以確認刪除 SQL 虛擬機器資源，而不是 SQL Server VM。

Azure PowerShell

若要使用 Azure PowerShell 從 SQL Server VM 刪除延伸項目，請使用 Remove-AzSqlVM 命令。 這樣會移除 SQL Server VM [資源]，但不會刪除虛擬機器。

若要使用 Azure PowerShell 從 SQL Server VM 刪除延伸項目，請使用 Remove-AzSqlVM 命令。

PowerShell

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

Azure CLI

若要使用 Azure CLI 從 SQL Server VM 刪除延伸項目，請使用 az sql vm delete 命令。 這樣會移除 SQL Server VM [資源]，但不會刪除虛擬機器。

若要使用 Azure CLI 從 SQL Server VM 刪除延伸項目，請使用 az sql vm delete 樣本命令。

Azure CLI

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

相關內容

• 檢閱 SQL IaaS 代理程式延伸模組所提供的權益。
• 自動註冊訂用帳戶中的所有 VM。
• 針對延伸模組的已知問題進行疑難排解。
• 檢閱 SQL IaaS 代理程式延伸模組隱私權聲明。
• 檢閱最佳做法檢查清單，以針對效能和安全性進行最佳化。

若要深入了解，請檢閱下列文章：

• Windows VM 上的 SQL Server 概觀
• Windows VM 上 SQL Server 常見問題
• Azure VM 上 SQL Server 的定價指導方針
• Azure VM 上的 SQL Server 的新功能