Distribuire e gestire a livello di codice le licenze degli Aggiornamenti di sicurezza estesi di Azure Arc

Questo articolo fornisce istruzioni per eseguire il provisioning e la gestione tramite codice delle operazioni del ciclo di vita degli aggiornamenti della sicurezza estesa di Windows Server tramite le API ARM ESU di Azure Arc. Le istruzioni si applicano a Windows Server 2012/2012 R2 e Windows Server 2016. Usare il selettore nella parte superiore dell'articolo per scegliere la versione del sistema operativo di cui si ha la licenza.

Per ognuno dei comandi API illustrati in questo articolo, immettere informazioni accurate sui parametri per posizione, stato, edizione, tipo e processori a seconda dello scenario specifico. Impostare la proprietà target sul sistema operativo per cui si sta acquistando la licenza:

  • Windows Server 2012
  • Windows Server 2012 R2

Important

Il periodo di Windows Server 2012 e Windows Server 2012 R2 ESU termina il 13 ottobre 2026. A mezzanotte utc (Coordinated Universal Time) il 14 ottobre 2026, le licenze ESU abilitate da Azure Arc vengono disattivate e non forniscono l'idoneità per l'aggiornamento. Le risorse di licenza disattivate rimangono disponibili per le query, ma non danno diritto agli aggiornamenti di sicurezza rilasciati dopo il 13 ottobre 2026.

  • Windows Server 2016

Nota

È necessario creare un service principal per usare l'API Azure per gestire le ESU. Per altre informazioni, vedere Connettere macchine ibride ad Azure su larga scala e informazioni di riferimento sull'API REST di Azure.

Effettuare il provisioning di una licenza

Per effettuare il provisioning di una licenza, eseguire il comando seguente:

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

Il parametro --volume-license-details si applica solo alla transizione dai diritti dei contratti multilicenza dell'anno 1. Questo periodo di transizione è terminato. La sintassi del comando mantiene il parametro per la compatibilità con l'automazione esistente:

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]

Transizione dai contratti multilicenza

La transizione dai contratti multilicenza non è supportata per gli ESU Windows Server 2016 abilitati da Azure Arc.

Per collegare una licenza, eseguire il comando seguente:

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

Per scollegare una licenza, eseguire il comando seguente:

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": {
    }
  }
}

Modifica una licenza

Per modificare una licenza, eseguire il comando seguente:

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

Per eliminare una licenza, eseguire il comando seguente:

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