Déployez et gérez par programmation les licences des mises à jour de sécurité étendues Azure Arc

Cet article fournit des instructions pour approvisionner et gérer par programmation des opérations de cycle de vie des mises à jour de sécurité étendues Windows Server via les API ARM Azure Arc ESU. Les instructions s’appliquent à Windows Server 2012/2012 R2 et Windows Server 2016. Utilisez le sélecteur situé en haut de l’article pour choisir la version du système d’exploitation pour laquelle vous souhaitez attribuer une licence.

Pour chacune des commandes d’API expliquées dans cet article, entrez des informations de paramètre précises pour l’emplacement, l’état, l’édition, le type et les processeurs en fonction de votre scénario particulier. Définissez la propriété target sur le système d’exploitation pour lequel vous attribuez une licence :

  • Windows Server 2012
  • Windows Server 2012 R2

Important

La période Windows Server 2012 et Windows Server 2012 R2 ESU se termine le 13 octobre 2026. À minuit UTC (temps universel coordonné), le 14 octobre 2026, les licences ESU activées via Azure Arc sont désactivées et ne permettent plus de bénéficier des mises à jour. Les ressources de licence désactivées restent disponibles pour les requêtes, mais elles ne permettent plus de bénéficier des mises à jour de sécurité publiées après le 13 octobre 2026.

  • Windows Server 2016

Remarque

Vous devez créer un principal de service pour utiliser l’API Azure pour gérer les ESU. Pour plus d’informations, voir Connecter des machines hybrides à Azure à grande échelle et référence Azure API REST.

Attribuer une licence

Pour attribuer une licence, exécutez la commande suivante :

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

Le paramètre --volume-license-details s’applique uniquement à la transition à partir des droits acquis au titre de la première année des licences en volume. Cette période de transition s’est terminée. La syntaxe de commande conserve le paramètre pour la compatibilité avec l’automatisation existante :

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]

Transition depuis les licences en volume

La transition à partir de la gestion des licences en volume n'est pas prise en charge pour Windows Server 2016 ESU activées par Azure Arc.

Pour lier une licence, exécutez la commande suivante :

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

Pour dissocier une licence, exécutez la commande suivante :

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

Modifier une licence

Pour modifier une licence, exécutez la commande suivante :

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

Pour supprimer une licence, exécutez la commande suivante :

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