Azure Arcで有効にするSQL Serverを構成する

適用対象:SQL Server

各Azure Arc対応サーバーには、そのサーバーにインストールされているすべてのSQL Server インスタンスに適用される一連のプロパティが含まれています。 SQL Serverの拡張機能Azureマシンにインストールした後で、これらのプロパティを構成できます。ただし、プロパティは、SQL Serverインスタンスまたはインスタンスがインストールされている場合にのみ有効になります。 Azure ポータルで、Azure Arcによって有効にされたSQL Serverの Overview ペインには、SQL Server構成が特定のインスタンスに与える影響が反映されます。

前提条件

組織が作成した Azure サブスクリプションの少なくとも 1 つにContributor ロールがあります。新しい課金サブスクリプションを作成する方法を参照してください。
SQL Server インスタンスが登録されるリソースグループには、Contributor ロールがあります。詳細については、「リソースグループの管理Azure」を参照してください。
Microsoft.AzureArcData および Microsoft.HybridCompute リソースプロバイダーは、SQL Server の従量課金に使用する各サブスクリプションに登録されています。

リソースプロバイダーを登録する

リソースプロバイダーを登録するには、次のいずれかの方法を使用します。

[サブスクリプション] を選択します。
サブスクリプションを選択します。
[設定] で、[リソースプロバイダー] を選択します。
Microsoft.AzureArcData と Microsoft.HybridCompute を検索し、Register を選択します。

次のコマンドを実行します。

Register-AzResourceProvider -ProviderNamespace Microsoft.AzureArcData

次のコマンドを実行します。

az provider register --namespace 'Microsoft.AzureArcData'

SQL Server構成の変更

Azure ポータル、Azure PowerShell、またはAzure CLIを使用して、特定のAzure Arc対応サーバーの構成設定のすべてまたは一部を目的の状態に変更できます。

1 つのコマンドで大規模なスコープ (リソースグループ、サブスクリプション、複数のサブスクリプションなど) のSQL Server構成を変更するには、modify-license-type.ps1 PowerShell スクリプトを使用します。オープンソースのSQL Serverサンプルとして公開され、詳細な手順が含まれています。

次の理由から、Azure Cloud Shellからスクリプトを実行することをお勧めします。

必要なAzure PowerShell モジュールがプレインストールされています。
自動的に認証されます。

詳細については、「 Cloud Shellを参照してください。

Azure ポータルで SQL Server ホストを構成するには、次の 2 つの方法があります。

Azure Arc対応の SQL Server Overview ペインを開き、SQL Server Configuration を選択します。

Azure portalでAzure Arcが有効になっているSQL Serverの概要ペインのスクリーンショット
Azure Arc対応の SQL Server Overview ペインを開き、Properties を選択します。 SQL Server構成で、変更する必要がある設定を選択します。
- ライセンスのタイプ
- ESU サブスクリプション
- 自動修正
&&&&AzureポータルでのSQL Serverインスタンス構成領域のスクリーンショット

ライセンスのタイプのプロパティを設定する

ライセンスのタイプのいずれかを選びます。説明は、「ライセンスのタイプ」を参照してください。

注

Linux では、パッシブインスタンスの検出や接続されたユーザー検証など、特定の構成機能を使用できません。 Linux で PAYG 課金を構成すると、HA/DR ロールに関係なく、すべてのインスタンスがアクティブとして課金されます。詳細については、「ライセンスと課金の管理」を参照してください。

物理コアライセンスを使用する

仮想マシン (VM) を構成していて、SQL Server ソフトウェアまたは SQL サブスクリプションのライセンスに無制限の仮想化特典を使用している場合は、物理コアライセンスを使用する チェックボックスをオンにします。ホスト構成プロパティの UsePhysicalCoreLicense が True に設定されます。このチェックボックスをオンにすると、物理コア (p コア) ライセンスが優先され、SQL Serverソフトウェアコストが無効になります。

重要

p-core ライセンスが従量課金プランで構成されている場合は、選択された ライセンスタイプ の値は 従量課金制 になるはずです。この選択によりVM レベルで追加料金がトリガーされることはありませんが、p-core ライセンスの解約または削除が発生した場合に、ライセンスの継続と課金が保証されます。

注

Azure VM の SQL Server 2016 では、拡張セキュリティ更新プログラム (ESU) の価格構造が変更されています。詳細については、 ESU の価格に関するブログを参照してください。

個々のホスト向け拡張セキュリティアップデート (ESU) をサブスクライブできます。 ESU サブスクリプションを使用するには、ライセンスタイプ を 従量課金制 または ソフトウェアアシュアランス付きライセンス に設定する必要があります。このオプションを使用すると、ホストが仮想マシンの場合は vCPU (仮想コア) を使用し、ホストが仮想マシンを使用せずに実行されている物理サーバーである場合は物理コアを使用してサブスクライブできます。

「拡張セキュリティ更新プログラムのサブスクライブ」を選択します。ホスト構成プロパティの EnableExtendedSecurityUpdates が True に設定されます。 [保存] を選択すると、サブスクリプションがアクティブになります。

ESU ライセンスオプションの詳細については、「運用環境の拡張セキュリティ更新プログラムにサブスクライブする」を参照してください。

注

p-core ESU ライセンスとは異なり、ホストの ESU をサブスクライブしているときに、各マシンの課金対象コア数を定義する必要はありません。 SQL ServerのAzure拡張機能は、ホストのサイズ、ホストの種類 (仮想または物理)、およびSQL Serverエディションを検出します。拡張機能は、これらのパラメーターに従って課金されます。

ESU が有効になっていると、ESU サブスクリプションがキャンセルされるまで、ホストの ライセンスタイプ の値は ライセンスのみ には変更できません。

物理コア ESU ライセンスを使用する

仮想マシンを構成しており、ESU サブスクリプションを有効にするときに無制限の仮想化特典を使用している場合は、[物理コア ESU ライセンスの使用] チェックボックスをオンにします。 UseEsuPhysicalCoreLicense を true に設定します。

このチェックボックスをオンにすると、p コアライセンスが優先され、VM レベルでの SQL Server ESU 料金は無効になります。

拡張セキュリティ更新の登録を解除する

Azure Arcによって有効になっている拡張セキュリティ更新プログラムはいつでも取り消すことができます。取り消すと、ESU の課金が直ちに停止されます。 [拡張セキュリティ更新プログラムのサブスクライブの解除] を選択します。 [保存] を選択すると、サブスクリプションは終了します。

除外されたインスタンスのリストに追加する

特定のインスタンスは、Azure ポリシーまたは自動オンボードプロセスによって駆動される大規模なオンボード操作から除外できます。これらの操作から特定のインスタンスを除外するには、インスタンス名を [インスタンスのスキップ] リストに追加します。大規模なオンボードオプションの詳細については、「 Azure Arc で有効にするSQL Serverのデプロイオプション」を参照してください。

注

従量課金制を使用するSQL Serverインスタンスや関連付けられているサービスを除外することはできません。

更新した構成を保存します。

ライセンスのタイプ、ESU の設定、除外するインスタンスを確認したら、[保存] を選んで変更を適用します。

次のコマンドでは、ライセンスのタイプを従量課金制 (PAYG) に設定し、これにより ESU サブスクリプションを有効にして、除外リストに 2 つのインスタンスを追加します。

# Updated settings object
$Settings = @{
    SqlManagement = @{ IsEnabled = $true };
    ExcludedSqlInstances = @( "Foo", "Bar");
    LicenseType = "PAYG";
    enableExtendedSecurityUpdates = $True;
    esuLastUpdatedTimestamp = [DateTime]::UtcNow.ToString('yyyy-MM-ddTHH:mm:ss.fffZ')
}

# Command stays the same as before; only Settings is changed
New-AzConnectedMachineExtension -Name "WindowsAgent.SqlServer" -ResourceGroupName { your resource group name } -MachineName { your machine name } -Location { azure region } -Publisher "Microsoft.AzureData" -Settings $Settings -ExtensionType "WindowsAgent.SqlServer"

ESU の対象となる複数のSQL Server インスタンスがある場合は、script を使用してライセンスの種類を変更することで一括キャンセルできます。このスクリプトを使用すると、次のいずれかの選択にあわせて ESU 設定を構成できます。

特定のリソースグループに所属する Azure Arc が有効にされたすべてのマシン
Azure サブスクリプション
Azure アカウントがアクセスできるすべてのAzure サブスクリプション

スクリプトは、既存のすべての設定を保持します。オープンソースのSQL Serverサンプルとして公開され、詳細な手順が含まれています。

次のコマンドを使用して、ライセンスのタイプを従量課金制に設定します:

az connectedmachine extension update --machine-name "simple-vm" -g "<resource-group>" --name "WindowsAgent.SqlServer" --type "WindowsAgent.SqlServer" --publisher "Microsoft.AzureData" --settings '{"LicenseType":"PAYG", "SqlManagement": {"IsEnabled":true}}'

警告

update コマンドを使用すると、すべての設定が上書きされます。たとえば、拡張機能の設定に除外されたSQL Server インスタンスの一覧がある場合は、update コマンドを使用して完全な除外リストを指定する必要があります。

以前のバージョンのAzure拡張機能が既にインストールされている場合は、最初にアップグレードしてから、変更方法を使用して正しいライセンスの種類を設定してください。詳細については、「Azure Arc 対応サーバーの自動拡張機能のアップグレードを参照してください。

重要

SQL ServerソフトウェアまたはSQL Server ESU サブスクリプションの無制限の仮想化特典は、リストに登録されているプロバイダーのインフラストラクチャではサポートされていません。一覧に示されているプロバイダーの VM でSQL Serverを実行していて、このオプションを選択した場合、意図は無視され、VM の v コアに対して課金されます。

対象の Arc 対応 SQL Server インスタンスを拡張セキュリティ更新プログラムにサブスクライブ。

このポリシー定義の割り当てを任意のスコープに作成すると、Azure拡張機能がインストールされているすべてのAzure Arc対応マシンで ESU SQL Server有効になります。これらのマシンのいずれかが修飾されたSQL Server インスタンスを持っている場合、ESU サブスクリプションは直ちにアクティブ化されます。

このポリシーをアクティブにするには、次の手順に従います。

Azure ポータルで、Azure Policy に移動し、Definitions を選択します。
「対象となる Arc 対応SQL Serverインスタンスを拡張セキュリティ更新にサブスクライブする」を検索し、ポリシーを右クリックします。
[ポリシーの割り当て]を選択します。
サブスクリプションと、必要に応じてスコープとしてリソースグループを選択します。
[ポリシーの適用] が [有効] に設定されていることを確認します。
[パラメーター] タブで、[拡張セキュリティ更新を有効にする] の値を True に設定します。
[修復] タブで:
1. このポリシーを既存のリソースに適用するには、[修復タスクの作成]を選択します。このオプションを選択していない場合、ポリシーは新しく作成されたリソースにのみ適用されます。
2. マネージド ID の作成を選択し、System 割り当てマネージド ID (推奨) または User 割り当てマネージド ID を選択します。 Azure SQL Server 配置用拡張機能 および Reader アクセス許可を持つもの。
3. ID の場所を選択します。
[確認および作成]を選択します。
［作成］ を選択します

SQL Server構成のクエリを実行する

Azure Resource Graph を使用して、選択したスコープ内のSQL Server構成設定に対してクエリを実行できます。次の例を参照してください。

ライセンスのタイプ別にカウントを取得する

次の例は、ライセンスのタイプ別のカウントを返します:

resources
| where type == "microsoft.hybridcompute/machines/extensions"
| where properties.type in ("WindowsAgent.SqlServer","LinuxAgent.SqlServer")
| extend licenseType = iff(properties.settings.LicenseType == '', 'Configuration needed', properties.settings.LicenseType)
| summarize count() by tostring(licenseType)

ライセンスのタイプが定義されていないインスタンスを特定する

次のクエリでは、ライセンスのタイプが null のインスタンスのリストを返します:

resources
| where type == "microsoft.hybridcompute/machines/extensions"
| where properties.type in ("WindowsAgent.SqlServer","LinuxAgent.SqlServer")
| where isnull(properties.settings.LicenseType)
| project ['id'], resourceGroup, subscriptionId

各SQL Server インスタンスの構成の詳細を一覧表示する

次のクエリでは、ライセンスのタイプ、ESU 設定や有効な機能など、各インスタンスに関する多くの詳細を特定できます:

resources
| where type == "microsoft.hybridcompute/machines"
| where properties.detectedProperties.mssqldiscovered == "true"
| extend machineIdHasSQLServerDiscovered = id
| project name, machineIdHasSQLServerDiscovered, resourceGroup, subscriptionId
| join kind= leftouter (
    resources
    | where type == "microsoft.hybridcompute/machines/extensions"    | where properties.type in ("WindowsAgent.SqlServer","LinuxAgent.SqlServer")
    | extend machineIdHasSQLServerExtensionInstalled = iff(id contains "/extensions/WindowsAgent.SqlServer" or id contains "/extensions/LinuxAgent.SqlServer", substring(id, 0, indexof(id, "/extensions/")), "")
    | project Extension_State = properties.provisioningState,
    License_Type = properties.settings.LicenseType,
    ESU = iff(notnull(properties.settings.enableExtendedSecurityUpdates), iff(properties.settings.enableExtendedSecurityUpdates == true,"enabled","disabled"), ""),
    Extension_Version = properties.instanceView.typeHandlerVersion,
    Excluded_instances = properties.ExcludedSqlInstances,
    Purview = iff(notnull(properties.settings.ExternalPolicyBasedAuthorization),"enabled",""),
    Entra = iff(notnull(properties.settings.AzureAD),"enabled",""),
    BPA = iff(notnull(properties.settings.AssessmentSettings),"enabled",""),
    machineIdHasSQLServerExtensionInstalled)on $left.machineIdHasSQLServerDiscovered == $right.machineIdHasSQLServerExtensionInstalled
| where isnotempty(machineIdHasSQLServerExtensionInstalled)
| project-away machineIdHasSQLServerDiscovered, machineIdHasSQLServerExtensionInstalled

SQL Serverのインスタンスを含むAzure Arc対応サーバーを一覧表示する

このクエリでは、SQL Server インスタンスが検出されたAzure Arcが有効なサーバーを識別します。

resources
| where type == "microsoft.hybridcompute/machines"
| where properties.detectedProperties.mssqldiscovered == "true"
//| summarize count()

このクエリは、SQL Server インスタンスを持つAzure Arc有効なサーバーを返しますが、Azure Arc SQL Server拡張機能はインストールされていません。このクエリは、Windows サーバーにのみ適用されます。

resources
| where type == "microsoft.hybridcompute/machines"
| where properties.detectedProperties.mssqldiscovered == "true"
| project machineIdHasSQLServerDiscovered = id
| join kind= leftouter (
    resources
    | where type == "microsoft.hybridcompute/machines/extensions"
    | where properties.type == "WindowsAgent.SqlServer"
    | project machineIdHasSQLServerExtensionInstalled = substring(id, 0, indexof(id, "/extensions/WindowsAgent.SqlServer")))
on $left.machineIdHasSQLServerDiscovered == $right.machineIdHasSQLServerExtensionInstalled
| where isempty(machineIdHasSQLServerExtensionInstalled)
| project machineIdHasSQLServerDiscoveredButNotTheExtension = machineIdHasSQLServerDiscovered

Azure Resource Graph クエリのその他の例については、Starter Resource Graph クエリのサンプルを参照してください。

ESU にサブスクライブしている Azure Arc 有効化 SQL Server インスタンスを一覧表示する

次の例は、対象となるすべてのSQL Server 2014 (12.x) インスタンスとその ESU サブスクリプションの状態を表示する方法を示しています。

resources
| where type == 'microsoft.azurearcdata/sqlserverinstances'
| extend Version = properties.version
| extend Edition = properties.edition
| extend containerId = tolower(tostring (properties.containerResourceId))
| where Version in ("SQL Server 2014")
| where Edition in ("Enterprise", "Standard")
| where isnotempty(containerId)
| project containerId, SQL_instance = name, Version, Edition
| join kind=inner (
    resources
    | where type == "microsoft.hybridcompute/machines"
    | extend machineId = tolower(tostring(id))
    | project machineId, Machine_name = name
)
on $left.containerId == $right.machineId
| join kind=inner (
    resources
    | where type == "microsoft.hybridcompute/machines/extensions"
    | where properties.type in ("WindowsAgent.SqlServer","LinuxAgent.SqlServer")
    | extend machineIdHasSQLServerExtensionInstalled = tolower(iff(id contains "/extensions/WindowsAgent.SqlServer" or id contains "/extensions/LinuxAgent.SqlServer", substring(id, 0, indexof(id, "/extensions/")), ""))
    | project machineIdHasSQLServerExtensionInstalled,
     Extension_State = properties.provisioningState,
     License_Type = properties.settings.LicenseType,
     ESU = iff(notnull(properties.settings.enableExtendedSecurityUpdates), iff(properties.settings.enableExtendedSecurityUpdates == 'true',"ENABLED","disabled"), "disabled"),
     Extension_Version = properties.instanceView.typeHandlerVersion
)
on $left.machineId == $right.machineIdHasSQLServerExtensionInstalled
| project-away machineId, containerId, machineIdHasSQLServerExtensionInstalled

課金対象のSQL Server インスタンスをホストするAzure Arc対応サーバーを一覧表示する

このクエリは、SQL Server インスタンスをホストしている接続されたマシン (仮想または物理) であり、SQL Server ソフトウェアに対して課金されるかライセンスが必要なものを識別します。ライセンスの種類、ESU の設定、v コアまたは p コアのサイズ、その他の関連パラメーターなど、SQL Server構成の詳細が提供されます。

resources
| where type =~ 'Microsoft.HybridCompute/machines'
| extend status = tostring(properties.status)
| where status =~ 'Connected'
| extend machineID = tolower(id)
| extend VMbyManufacturer = toboolean(iff(
    properties.detectedProperties.manufacturer contains_cs "VMware" or
    properties.detectedProperties.manufacturer contains_cs "QEMU" or
    properties.detectedProperties.manufacturer contains_cs "Amazon EC2" or
    properties.detectedProperties.manufacturer contains_cs "OpenStack" or
    properties.detectedProperties.manufacturer contains_cs "Hetzner" or
    properties.detectedProperties.manufacturer contains_cs "Mission Critical Cloud" or
    properties.detectedProperties.manufacturer contains_cs "DigitalOcean" or
    properties.detectedProperties.manufacturer contains_cs "UpCloud" or
    properties.detectedProperties.manufacturer contains_cs "oVirt" or
    properties.detectedProperties.manufacturer contains_cs "Alibaba" or
    properties.detectedProperties.manufacturer contains_cs "KubeVirt" or
    properties.detectedProperties.manufacturer contains_cs "Parallels" or
    properties.detectedProperties.manufacturer contains_cs "Bochs" or
    properties.detectedProperties.manufacturer contains_cs "XEN", 1, 0))
| extend VMbyModel = toboolean(iff(
    properties.detectedProperties.model contains_cs "OpenStack" or
    properties.detectedProperties.model contains_cs "Droplet" or
    properties.detectedProperties.model contains_cs "oVirt" or
    properties.detectedProperties.model contains_cs "Hypervisor" or
    properties.detectedProperties.model contains_cs "Virtual" or
    properties.detectedProperties.model contains_cs "BHYVE" or
    properties.detectedProperties.model contains_cs "KVM", 1, 0))
| extend GoogleVM = toboolean(iff(
    properties.detectedProperties.manufacturer contains_cs "Google" and
    properties.detectedProperties.model contains_cs "Google Compute Engine", 1, 0))
| extend NutanixVM = toboolean(iff(
    properties.detectedProperties.manufacturer contains_cs "Nutanix" and
    properties.detectedProperties.model contains_cs "AHV", 1, 0))
| extend MicrosoftVM = toboolean(iff(
    properties.detectedProperties.manufacturer contains_cs "Microsoft Corporation" and
    properties.detectedProperties.model contains_cs "Virtual Machine", 1, 0))
| extend billableCores = iff(
    VMbyManufacturer or VMbyModel or GoogleVM or NutanixVM or MicrosoftVM,
    properties.detectedProperties.logicalCoreCount,
    properties.detectedProperties.coreCount)
| join kind=leftouter (
    resources
    | where type =~ 'Microsoft.HybridCompute/machines/extensions'
    | where name == 'WindowsAgent.SqlServer' or name == 'LinuxAgent.SqlServer'
    | extend extMachineID = substring(id, 0, indexof(id, '/extensions'))
    | extend extensionId = id
) on $left.id == $right.extMachineID
| join kind=inner (
    resources
    | where type =~ 'microsoft.azurearcdata/sqlserverinstances'
    | extend sqlVersion = tostring(properties.version)
    | extend sqlEdition = tostring(properties.edition)
    | extend is_Enterprise = toint(iff(sqlEdition == "Enterprise", 1, 0))
    | extend sqlStatus = tostring(properties.status)
    | extend licenseType = tostring(properties.licenseType)
    | where sqlEdition in ('Enterprise', 'Standard')
    | where licenseType !~ 'HADR'
    | extend ArcServer = tolower(tostring(properties.containerResourceId))
    | order by sqlEdition
) on $left.machineID == $right.ArcServer
| where isnotnull(extensionId)
| summarize Edition = iff(sum(is_Enterprise) > 0, "Enterprise", "Standard") by machineID, name, resourceGroup, subscriptionId, Status = tostring(properties.status), Model = tostring(properties.detectedProperties.model), Manufacturer = tostring(properties.detectedProperties.manufacturer), License_Type = tostring(properties1.settings.LicenseType), ESU = iff(notnull(properties1.settings.enableExtendedSecurityUpdates), iff(properties1.settings.enableExtendedSecurityUpdates == true, "enabled", "not enabled"), "not enabled"), OS = tostring(properties.osName), Uses_UV = tostring(properties1.settings.UsePhysicalCoreLicense.IsApplied), Cores = tostring(billableCores), Version = sqlVersion, HostType = iff(VMbyManufacturer or VMbyModel or GoogleVM or NutanixVM or MicrosoftVM, "VM", "Physical")
| summarize by name, subscriptionId, resourceGroup, Model, Manufacturer, HostType, License_Type, ESU, OS, Cores, Status
| project Name = name, Model, Manufacturer, HostType, OperatingSystem = OS, Status, HostLicenseType = License_Type, ESU, BillableCores = Cores, SubscriptionID = subscriptionId, ResourceGroup = resourceGroup
| order by Name asc

SQL Serverの無制限の仮想化特典を管理する

無制限の仮想化を有効にするには、Azure Arcで有効にするSQL Serverは、特殊なリソースの種類 (SQLServerLicense をサポートします。このリソースを使用して、インストールされている SQL Server インスタンスを使用して多数の仮想マシンにライセンスを付与できます。ライセンスモデルの詳細については、「無制限の仮想化を使用したインスタンスのライセンスSQL Serverを参照してください。

前提条件

ロールベースのアクセス制御 (RBAC) ロールには、次のアクセス許可が含まれています:

Microsoft.AzureArcData/SqlLicenses/read
Microsoft.AzureArcData/SqlLicenses/write
Microsoft.Management/managementGroups/read
Microsoft.Resources/subscriptions/read
Microsoft.Resources/subscriptions/resourceGroups/read
Microsoft.Support/supporttickets/write

SQL Server ライセンスを作成する

SQL Server ライセンスリソースを作成するには、次のいずれかの方法を使用します。

Azure Arc を選択します。
Data Services で、SQL Server ライセンスを選択します。
[+作成] を選択します。
SQL Server物理コアライセンスを選択します。
作成ウィザードを完了します。

次のコマンドを実行します。

$subscriptionId="<sub id>"
$apiVersion="2024-03-01-preview"
$templateFile="sqlserverlicense.json"

$resourceGroupName="<rg-name>"
$uri = "https://management.azure.com/subscriptions/{0}/resourceGroups/{1}/providers/Microsoft.AzureArcData/sqlserverlicenses/{2}?api-version={3}" -f $subscriptionId, $resourceGroupName, $serverName, $apiVersion

az rest --method put --uri "$uri" --body "@$templateFile" --headers "Content-Type=application/json"

非アクティブ化されたライセンスを作成する sqlserverlicense.json の例を次に示します:

"location": "westeurope",
"properties": {
    "billingPlan": "PAYG",
    "physicalCores": 32,
    "activationState": "Deactivated",
    "scopeType": "ResourceGroup",
    "licenseCategory": "Core"
}

SQL Server ライセンスリソースを更新する

SQL Server ライセンスプロパティを変更するには (たとえば、後でライセンス認証を行う)、次のいずれかの方法を使用します。

Azure Arc を選択します。
Data Services で、SQL Server ライセンスを選択します。
ライセンスを選択します。
[管理] で [設定] を選択します。
変更を行ってから、[適用] を選択します。

次のコマンドを実行します。

$subscriptionId="<sub id>"
$apiVersion="2024-03-01-preview"
$templateFile="activate.json"

$resourceGroupName="<rg-name>"
$uri = "https://management.azure.com/subscriptions/{0}/resourceGroups/{1}/providers/Microsoft.AzureArcData/sqlserverlicenses/{2}?api-version={3}" -f $subscriptionId, $resourceGroupName, $serverName, $apiVersion

az rest --method patch --uri "$uri" --body "@$templateFile" --headers "Content-Type=application/json"

ライセンス認証を行う activate.json の内容を次に示します:

{
  "activationState": "Activated"
}

p-core ライセンスのスコープ内のリソースを管理する

次の手順を使用して、特定のSQL Server物理コアライセンスのスコープ内のリソースを管理できます。

Azure Arc を選択します。
Data Services で、SQL Server ライセンスを選択します。
ライセンスを選択します。
[管理] で [スコープ内のリソース] を選択する

特定のリソースがこのライセンスを使用するように構成されていない場合 ([物理コアライセンスの適用] 列に「いいえ」が表示される)、次のように変更できます。

リスト内の特定のリソースを選択する
[ライセンスの適用] を選択します。
免責事項を読み、[確認] を選択する

SQL Server ライセンスのスコープ内のAzure Arc対応サーバーを一覧表示する

このクエリでは、ライセンスのスコープ内のすべてのAzure Arc対応サーバーと、それぞれの関連プロパティが一覧表示されます。

resources
        | where type =~ 'Microsoft.HybridCompute/machines'
        | where ('${scopeType}'!= 'Subscription' or subscriptionId == '${subscription}')
        | where ('${scopeType}' != 'ResourceGroup' or (resourceGroup == '${resourceGroup.toLowerCase()}' and subscriptionId == '${subscription}'))
        | extend status = tostring(properties.status)
        | where status =~ 'Connected'
        | join kind = leftouter
        (
        resources
        | where type =~ 'Microsoft.HybridCompute/machines/extensions'
        | where name == 'WindowsAgent.SqlServer' or name == 'LinuxAgent.SqlServer'
        | extend machineId = substring(id, 0, indexof(id, '/extensions'))
        | extend extensionId = id
        )
        on $left.id == $right.machineId
        | where isnotnull(extensionId)
        | project id, name, properties.status, resourceGroup, subscriptionId, Model = properties.detectedProperties.model, Manufacturer = properties.detectedProperties.manufacturer, kind, OSE = properties.osName, License_applied = properties1.settings.UsePhysicalCoreLicense.IsApplied
        |order by name asc

SQL Server ESU サブスクリプションの無制限の仮想化特典を管理する

ESU サブスクリプションで無制限の仮想化を有効にするには、Azure Arc によって有効化された SQL Server が特殊なリソースタイプ (SqlServerEsuLicenses) をサポートします。このリソースを使用すると、サポート対象外のSQL Server インスタンスを実行する仮想マシンの数に制限なく、一連の物理ホストに対して ESU サブスクリプションを有効にすることができます。ライセンスモデルの詳細については、「無制限の仮想化で物理コアを使用して SQL SERVER ESU にサブスクライブするを参照してください。

前提条件

RBAC ロールには、次のアクセス許可が含まれています。

Microsoft.AzureArcData/SqlLicenses/read
Microsoft.AzureArcData/SqlLicenses/write
Microsoft.Management/managementGroups/read
Microsoft.Resources/subscriptions/read
Microsoft.Resources/subscriptions/resourceGroups/read
Microsoft.Support/supporttickets/write

SQL Server ESU ライセンスリソースを作成する

SQL Server ESU ライセンスリソースを作成するには、次のいずれかの方法を使用します。

Azure Arc を選択します。
[Data Services で、SQL Server ESU ライセンスを選択します。
[+作成] を選択します。
作成ウィザードを完了します。

次のコマンドを実行します。

$subscriptionId="<sub id>"
$apiVersion="2024-03-01-preview"
$templateFile="sqlserverlicense.json"

$resourceGroupName="<rg-name>"
$uri = "https://management.azure.com/subscriptions/{0}/resourceGroups/{1}/providers/Microsoft.AzureArcData/SqlServerEsuLicenses/{2}?api-version={3}" -f $subscriptionId, $resourceGroupName, $serverName, $apiVersion

az rest --method put --uri "$uri" --body "@$templateFile" --headers "Content-Type=application/json"

非アクティブ化されたライセンスを作成する sqlserverlicense.json の例を次に示します:

"location": "westeurope",
"properties": {
    "billingPlan": "PAYG",
    "physicalCores": 32,
    "activationState": "Active",
    "scopeType": "ResourceGroup",
    "version": "2014"
}

SQL Server ESU ライセンスリソースを更新する

SQL Server ESU ライセンスプロパティを変更するには (たとえば、サブスクリプションを終了する)、次のいずれかの方法を使用します。

Azure Arc を選択します。
[Data Services で、SQL Server ESU ライセンスを選択します。
ライセンスを選択します。
[管理] で [設定] を選択します。
変更を行ってから、[適用] を選択します。

次のコマンドを実行します。

$subscriptionId="<sub id>"
$apiVersion="2024-03-01-preview"
$templateFile="terminate.json"

$resourceGroupName="<rg-name>"
$uri = "https://management.azure.com/subscriptions/{0}/resourceGroups/{1}/providers/Microsoft.AzureArcData/SqlServerEsuLicenses/{2}?api-version={3}" -f $subscriptionId, $resourceGroupName, $serverName, $apiVersion

az rest --method patch --uri "$uri" --body "@$templateFile" --headers "Content-Type=application/json"

ライセンス認証を行う terminate.json の内容を次に示します:

{
  "activationState": "Terminated"
}

ESU p-core ライセンスのスコープ内のリソースを管理する

次の手順を使用して、特定のSQL Server ESU ライセンスのスコープ内のリソースを管理できます。

Azure Arc を選択します。
[Data Services で、SQL Server ESU ライセンスを選択します。
ライセンスを選択します。
[管理] で [スコープ内のリソース] を選択する

このビューには、管理している p コア ESU ライセンスのバージョンと一致するバージョンのサービス外SQL Server インスタンスをホストするスコープ内の接続されたマシンのみが表示されます。特定のリソースがこのライセンスを使用するように構成されていない場合 (物理コアライセンス適用 列に「いいえ」と表示される)、次のように変更できます。

リスト内の特定のリソースを選択する
サブスクライブする場合は [ESU へのサブスクリプション ] を選択し、サブスクライブを解除するには [ESU からサブスクリプション解除] を選択します。
免責事項を読み、[確認] を選択する

SQL Server ESU ライセンスのスコープ内のAzure Arc対応サーバーを一覧表示する

このクエリでは、ライセンスのスコープ内のすべてのAzure Arc対応サーバーと、それぞれの関連プロパティが一覧表示されます。

resources
        | where type =~ 'Microsoft.HybridCompute/machines'
        | where ('${scopeType}'!= 'Subscription' or subscriptionId == '${subscription}')
        | where ('${scopeType}' != 'ResourceGroup' or (resourceGroup == '${resourceGroup.toLowerCase()}' and subscriptionId == '${subscription}'))
        | extend status = tostring(properties.status)
        | where status =~ 'Connected'
        | join kind = leftouter
        (
        resources
        | where type =~ 'Microsoft.HybridCompute/machines/extensions'
        | where name == 'WindowsAgent.SqlServer' or name == 'LinuxAgent.SqlServer'
        | extend machineId = substring(id, 0, indexof(id, '/extensions'))
        | extend extensionId = id
        )
        on $left.id == $right.machineId
        | where isnotnull(extensionId)
        | project id, name, properties.status, resourceGroup, subscriptionId, Model = properties.detectedProperties.model, Manufacturer = properties.detectedProperties.manufacturer, kind, OSE = properties.osName, License_applied = properties1.settings.UseEsuPhysicalCoreLicense.IsApplied
        |order by name asc

拡張機能をアップグレードする

現在の拡張機能リリースのバージョンを確認するには、リリースノートを確認します。

拡張機能のバージョンを確認するには、次の PowerShell コマンドを使用します。

azcmagent version

拡張機能のアップグレードを簡略化するには、自動更新を有効にしてください。 Azure ポータル、PowerShell、Azure CLIを使用して拡張機能を手動でアップグレードすることもできます。

Azure ポータルで拡張機能をアップグレードするには、次の手順に従います。

Azure ポータルで、Machines - Azure Arc に移動します。
SQL Serverがインストールされているコンピューターの名前を選択して、サーバーの Overview ペインを開きます。
[ 設定] で、[拡張機能] を選択 します。
WindowsAgent.SqlServer拡張機能のチェックボックスをオンにし、ナビゲーションメニューから [更新] を選択します。

Azure ポータルの [コンピューター - Azure Arc] ウィンドウの [拡張機能] ウィンドウ、更新プログラムが強調表示されたスクリーンショット
[拡張機能の更新の確認] ダイアログボックスで [はい] を選択してアップグレードを完了します。

PowerShell を使用して拡張機能をアップグレードするには、最初に次のコマンドを使用して Az.ConnectedMachine モジュールをインストールします (まだインストールしていない場合)。

Install-Module -Name Az.ConnectedMachine

次に、次のコマンドを使用して拡張機能をアップグレードします。

# Variables 
$Subscription_Id = "<SubscriptionId>" 
$ResourceGroup = "<ResourceGroup>" 
$MachineName = "<MachineName>" 
$ExtensionName = "WindowsAgent.SqlServer" 
$Publisher = "Microsoft.AzureData" 
$TargetVersion = "<LatestVersion>"  # Example: 1.1.3211.337 

# Upgrade the extension 
Set-AzContext -Subscription $SubscriptionId 

$params = @{
  ResourceGroupName = $ResourceGroup
  MachineName = $MachineName
  Name = $ExtensionName
  Publisher = $Publisher
  Type = $ExtensionName
  TypeHandlerVersion = $TargetVersion
}

Update-AzConnectedMachineExtension @params

Azure CLIを使用して拡張機能をアップグレードするには、まず次のコマンドを使用して connectedmachine 拡張機能をインストールします (まだインストールしていない場合)。

az extension add --name connectedmachine

次に、次のコマンドを使用して拡張機能をアップグレードします。

# Variables 
Subscription_Id="<SubscriptionId>" 
Resource_Group="<ResourceGroup>" 
Machine_Name="<ArcEnabledServerName>" 
Extension_Name="WindowsAgent.SqlServer" 
Publisher="Microsoft.AzureData" 
Target_Version="<LatestVersion>"  # Example: 1.1.3211.337 

# Upgrade the extension 

az account set --subscription $Subscription_Id 
az connectedmachine extension update \ 
    --resource-group $Resource_Group \ 
    --machine-name $Machine_Name \ 
    --name $Extension_Name \ 
    --publisher $Publisher \ 
    --type $Extension_Name \ 
    --type-handler-version $Target_Version

SQL ServerのAzure拡張機能のアップグレードの詳細については、「Upgrade 拡張機能を参照してください。

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-04-07

次の方法で共有

Azure Arcで有効にするSQL Serverを構成する

前提条件

リソース プロバイダーを登録する

SQL Server構成の変更

ライセンスのタイプのプロパティを設定する

物理コア ライセンスを使用する

拡張セキュリティ更新プログラムに登録する

物理コア ESU ライセンスを使用する

拡張セキュリティ更新の登録を解除する

除外されたインスタンスのリストに追加する

更新した構成を保存します。

Azure Policyを使用して拡張セキュリティ更新プログラムを大規模にサブスクライブする

SQL Server構成のクエリを実行する

ライセンスのタイプ別にカウントを取得する

ライセンスのタイプが定義されていないインスタンスを特定する

各SQL Server インスタンスの構成の詳細を一覧表示する

SQL Serverのインスタンスを含むAzure Arc対応サーバーを一覧表示する

ESU にサブスクライブしている Azure Arc 有効化 SQL Server インスタンスを一覧表示する

課金対象のSQL Server インスタンスをホストするAzure Arc対応サーバーを一覧表示する

SQL Serverの無制限の仮想化特典を管理する

前提条件

SQL Server ライセンスを作成する

SQL Server ライセンス リソースを更新する

p-core ライセンスのスコープ内のリソースを管理する

SQL Server ライセンスのスコープ内のAzure Arc対応サーバーを一覧表示する

SQL Server ESU サブスクリプションの無制限の仮想化特典を管理する

前提条件

SQL Server ESU ライセンス リソースを作成する

SQL Server ESU ライセンス リソースを更新する

ESU p-core ライセンスのスコープ内のリソースを管理する

SQL Server ESU ライセンスのスコープ内のAzure Arc対応サーバーを一覧表示する

拡張機能をアップグレードする

関連するコンテンツ

フィードバック

その他のリソース

リソースプロバイダーを登録する

物理コアライセンスを使用する

SQL Server ライセンスリソースを更新する

SQL Server ESU ライセンスリソースを作成する

SQL Server ESU ライセンスリソースを更新する