Implementación y administración de licencias de actualizaciones de seguridad extendidas de Azure Arc mediante programación

En este artículo se proporcionan instrucciones para aprovisionar y administrar mediante programación Windows Server operaciones de ciclo de vida de actualizaciones de seguridad extendidas a través de las API de ARM de ESU de Azure Arc. Las instrucciones se aplican a Windows Server 2012/2012 R2 y Windows Server 2016. Use el selector de la parte superior del artículo para elegir la versión del sistema operativo que está licenciando.

Para cada uno de los comandos de API que se explican en este artículo, escriba información precisa de parámetros para la ubicación, el estado, la edición, el tipo y los procesadores en función de su escenario concreto. Establezca la target propiedad en el sistema operativo que está licenciando:

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

Nota:

Tendrá que crear una entidad de servicio para usar la API de Azure para administrar las ESU. Para obtener más información, consulte Conexión de máquinas híbridas a Azure a gran escala y la referencia sobre la API REST de Azure.

Aprovisionamiento de una licencia

Para aprovisionar una licencia, ejecute los siguientes comandos:

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

Mediante programación, puede usar la CLI de Azure para generar licencias. Para ello, debe especificar el parámetro Volume License Details en los derechos del programa de licencias por volumen del año 1 escribiendo los números de factura correspondientes. Debe especificar explícitamente el Id. de factura (número) en el aprovisionamiento de licencias para 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]

Transición de licencias por volumen

No se admite la transición desde licencias por volumen para Windows Server 2016 ESU habilitadas por Azure Arc.

Para vincular una licencia, ejecute los siguientes comandos:

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

Para desvincular una licencia, ejecute los siguientes comandos:

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

Modificación de una licencia

Para modificar una licencia, ejecute los siguientes comandos:

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

Para eliminar una licencia, ejecute los siguientes comandos:

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