Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 2012Windows 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.
Lier une licence
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"
}
}
}
Dissocier une licence
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