Azure Arc 拡張セキュリティ更新プログラムのライセンスをプログラムによってデプロイおよび管理する

  • [アーティクル]

この記事では、Azure Arc WS2012 ESU ARM API を使用して、Windows Server 2012 および Windows Server 2012 R2 拡張セキュリティ更新プログラムのライフサイクル操作をプログラムによってプロビジョニングおよび管理する手順について説明します。

この記事で説明する各 API コマンドに対して、具体的なシナリオに応じて、場所、状態、エディション、型、プロセッサの正確なパラメーター情報を入力するようにしてください。

Note

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  
        }  
    }  
}

ボリューム ライセンスからの移行

プログラムによって、Azure CLI を使用して新しいライセンスを生成し、それぞれの請求書番号を入力して、Year 1 ボリューム ライセンス エンタイトルメントで Volume License Details パラメーターを指定できます。 Azure Arc のライセンス プロビジョニングで請求書 ID (番号) を明示的に指定する必要があります。

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]

ライセンスをリンクするには、次のコマンドを実行します。

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  
        }  
    }  
}

Note

PUT の場合、すべてのプロパティを指定する必要があります。 PATCH の場合、サブセットを指定できます。

ライセンスを削除する

ライセンスを削除するには、次のコマンドを実行します。

DELETE  
https://management.azure.com/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP_NAME/providers/Microsoft.HybridCompute/licenses/LICENSE_NAME?api-version=2023-06-20-preview