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 en haut de l’article pour choisir la version du système d’exploitation que vous autorisez.

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 target propriété sur le système d’exploitation que vous attribuez aux licences :

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

Remarque

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

Attribuer une licence

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

Par programmation, vous pouvez utiliser Azure CLI pour générer de nouvelles licences, en spécifiant le paramètre Volume License Details dans vos droits de licence en volume Année 1 en entrant les numéros de facture respectifs. Vous devez spécifier explicitement la Réf. facture (numéro) dans votre approvisionnement de licences pour 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]

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