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 las operaciones del ciclo de vida de Extended Security Updates de Windows Server 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. Utilice el selector situado en la parte superior del artículo para elegir la versión del sistema operativo para la que está obteniendo la licencia.

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 para el que está obteniendo la licencia:

  • Windows Server 2012
  • Windows Server 2012 R2

Important

El período Windows Server 2012 y Windows Server 2012 R2 ESU finaliza el 13 de octubre de 2026. A medianoche Hora universal coordinada (UTC) el 14 de octubre de 2026, las licencias de ESU habilitadas por Azure Arc se desactivan y dejan de proporcionar elegibilidad de actualización. Los recursos de licencia desactivados permanecen disponibles para la consulta, pero no pueden proporcionar elegibilidad para las actualizaciones de seguridad publicadas después del 13 de octubre de 2026.

  • Windows Server 2016

Nota

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

Aprovisionamiento de una licencia

Para aprovisionar una licencia, ejecute el siguiente comando:

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

El parámetro --volume-license-details solo se aplica a la transición desde los derechos de Licencias por volumen del Año 1. Este período de transición ha finalizado. La sintaxis del comando conserva el parámetro para la compatibilidad con la automatización existente:

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 desde las licencias por volumen

No se admite cambiar de licencias por volumen en las ESU de Windows Server 2016 habilitadas por Azure Arc.

Para vincular una licencia, ejecute el siguiente comando:

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 el siguiente comando:

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

Modificar una licencia

Para modificar una licencia, ejecute el siguiente comando:

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 el siguiente comando:

DELETE  
https://management.azure.com/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP_NAME/providers/Microsoft.HybridCompute/licenses/LICENSE_NAME?api-version=2023-06-20-preview
  • Se actualizó por última vez el