この記事では、Azure Arc ESU ARM API を使用して、Windows Server 拡張セキュリティ更新プログラムのライフサイクル操作をプログラムによってプロビジョニングおよび管理する手順について説明します。 手順は、Windows Server 2012/2012 R2 と Windows Server 2016 に適用されます。 記事の上部にあるセレクターを使用して、ライセンスを取得するオペレーティング システムのバージョンを選択してください。
この記事で説明する各 API コマンドについて、特定のシナリオに応じて、場所、状態、エディション、型、プロセッサの正確なパラメーター情報を入力してください。
target プロパティを、ライセンスを取得するオペレーティング システムに合わせて設定します:
Windows Server 2012Windows Server 2012 R2
Von Bedeutung
Windows Server 2012およびWindows Server 2012 R2 ESU 期間は、2026 年 10 月 13 日に終了します。 2026 年 10 月 14 日の協定世界時 (UTC) の午前 0 時に、Azure Arcによって有効になっている ESU ライセンスは非アクティブ化され、更新プログラムを受け取る資格を失います。 無効化されたライセンス リソースは引き続きクエリの対象となりますが、2026 年 10 月 13 日以降にリリースされるセキュリティ更新プログラムの適用資格は得られません。
Windows Server 2016
注
Azure API を使用して ESU を管理するには、サービス プリンシパルを作成する必要があります。 詳細については、「ハイブリッド マシンを大規模に Azure に接続する」と「Azure REST API リファレンス」を参照してください。
ライセンスを割り当てる
ライセンスをプロビジョニングするには、次のコマンドを実行します。
PUT
https://management.azure.com/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP_NAME/providers/Microsoft.HybridCompute/licenses/LICENSE_NAME?api-version=2023-06-20-preview
{
"location": "ENTER-REGION",
"properties": {
"licenseDetails": {
"state": "Activated",
"target": "Windows Server 2012",
"Edition": "Datacenter",
"Type": "pCore",
"Processors": 12
}
}
}
PUT
https://management.azure.com/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP_NAME/providers/Microsoft.HybridCompute/licenses/LICENSE_NAME?api-version=2023-06-20-preview
{
"location": "ENTER-REGION",
"properties": {
"licenseDetails": {
"state": "Activated",
"target": "Windows Server 2016",
"Edition": "Datacenter",
"Type": "pCore",
"Processors": 12
}
}
}
--volume-license-details パラメーターは、Year 1 Volume Licensing エンタイトルメントからの移行にのみ適用されます。 この移行期間は終了しました。 コマンド構文では、既存の自動化との互換性のためにパラメーターが保持されます。
az connectedmachine license create --license-name
--resource-group
[--edition {Datacenter, Standard}]
[--license-type {ESU}]
[--location]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--processors]
[--state {Activated, Deactivated}]
[--tags]
[--target {Windows Server 2012, Windows Server 2012 R2}]
[--tenant-id]
[--type {pCore, vCore}]
[--volume-license-details]
ボリューム ライセンスからの移行
ボリューム ライセンスからの移行は、Azure Arc で有効になっている Windows Server 2016 ESU ではサポートされていません。
ライセンスを関連付ける
ライセンスをリンクするには、次のコマンドを実行します。
PUT
https://management.azure.com/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP_NAME/providers/Microsoft.HybridCompute/machines/MACHINE_NAME/licenseProfiles/default?api-version=2023-06-20-preview
{
"location": "SAME_REGION_AS_MACHINE",
"properties": {
"esuProfile": {
"assignedLicense": "RESOURCE_ID_OF_LICENSE"
}
}
}
ライセンスのリンクを解除する
ライセンスのリンクを解除するには、次のコマンドを実行します。
PUT
https://management.azure.com/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP_NAME/providers/Microsoft.HybridCompute/machines/MACHINE_NAME/licenseProfiles/default?api-version=2023-06-20-preview
{
"location": "SAME_REGION_AS_MACHINE",
"properties": {
"esuProfile": {
}
}
}
ライセンスを変更する
ライセンスを変更するには、次のコマンドを実行します。
PUT/PATCH
https://management.azure.com/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP_NAME/providers/Microsoft.HybridCompute/licenses/LICENSE_NAME?api-version=2023-06-20-preview
{
"location": "ENTER-REGION",
"properties": {
"licenseDetails": {
"state": "Activated",
"target": "Windows Server 2012",
"Edition": "Datacenter",
"Type": "pCore",
"Processors": 12
}
}
}
PUT/PATCH
https://management.azure.com/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP_NAME/providers/Microsoft.HybridCompute/licenses/LICENSE_NAME?api-version=2023-06-20-preview
{
"location": "ENTER-REGION",
"properties": {
"licenseDetails": {
"state": "Activated",
"target": "Windows Server 2016",
"Edition": "Datacenter",
"Type": "pCore",
"Processors": 12
}
}
}
ライセンスを削除するには、次のコマンドを実行します。
DELETE
https://management.azure.com/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP_NAME/providers/Microsoft.HybridCompute/licenses/LICENSE_NAME?api-version=2023-06-20-preview