以程式設計方式部署和管理 Azure Arc 擴充安全性更新授權

發行項
09/25/2024

本文提供指示，透過 Azure Arc WS2012 ESU ARM API，以程式設計方式佈建和管理 Windows Server 2012 和 Windows Server 2012 R2 擴充安全性更新生命週期作業。

針對本文所說明的每個 API 命令，請務必根據特定案例輸入位置、狀態、版本、類型和處理器的正確參數資訊。

注意

您必須建立服務主體，才能使用 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 來產生新的授權，藉由輸入個別的發票號碼，在第 1 年大量授權權利中指定 Volume License Details 參數。您必須在 Azure Arc 的授權佈建中明確指定發票識別碼 (號碼)：

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

注意

針對 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

共用方式為