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

Questo articolo fornisce istruzioni per eseguire il provisioning e la gestione a livello di codice Windows Server operazioni del ciclo di vita degli aggiornamenti della sicurezza estesa tramite le API ARM ESU 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 target proprietà sul sistema operativo che si sta licenze:

  • Windows Server 2012
  • Windows Server 2012 R2
  • Windows Server 2016

Nota

È necessario creare un'entità servizio per usare l'API di 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  
        }  
    }  
}

A livello di codice, è possibile usare l'interfaccia della riga di comando di Azure per generare nuove licenze, specificando il parametro Volume License Details nei diritti per contratti multilicenza dell'anno 1 immettendo i rispettivi numeri di fattura. È necessario specificare in modo esplicito l'ID fattura (numero) nel provisioning delle licenze per 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]

Transizione da contratti multilicenza

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

Per collegare una licenza, eseguire il comando seguenti:

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

Modificare 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
  • Last updated on